Accéder au contenu

SDXL ControlNet Union · Inpainting

Intégrer

Identifiant du modèle sdxl-controlnet-union/inpainting
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/sdxl-controlnet-union/inpainting?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Cette requête: ≈0,012 $ 12 crédits API · ≈ 1,29 ₽ L'exécuter sur cette page

Obtenir une clé API
Stability AI Édition d’image #diffusion#controlnet#composition

Inpainting SDXL qui remplit une zone masquée en suivant des guides ControlNet de pose, profondeur, contours ou autres

Stability AI · Image

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•obligatoire

Décrivez l’image que vous souhaitez générer avec autant de détails que possible pour obtenir les meilleurs résultats.

•obligatoire image_url
Déposez un fichier ou

Image de départ pour la génération, fournie par URL.

•obligatoire mask_url
Déposez un fichier ou

URL pointant vers le masque d'inpainting.

image_size

Dimensions de sortie, déterminées automatiquement à partir de l'image de contrôle lorsqu'aucune taille n'est fournie.

num_images par défaut 1

Nombre d'images demandé pour la génération.

Avancé negative_prompt · openpose_image_url · depth_image_url · teed_image_url · canny_image_url · normal_image_url · segmentation_image_url · safety_checker_version · format · request_id · controlnet_conditioning_scale · num_inference_steps · guidance_scale · strength · seed · enable_safety_checker · expand_prompt · openpose_preprocess · depth_preprocess · teed_preprocess · canny_preprocess · normal_preprocess · segmentation_preprocess · loras · embeddings
par défaut

Invite négative indiquant les détails d’image indésirables. Elle peut exclure des couleurs, objets, décors ou caractéristiques et qualités fines, comme une moustache, du flou ou une basse résolution.

Déposez un fichier ou

URL pointant vers l'image de contrôle.

Déposez un fichier ou

URL pointant vers l'image de contrôle.

Déposez un fichier ou

URL pointant vers l'image de contrôle.

Déposez un fichier ou

URL pointant vers l'image de contrôle.

Déposez un fichier ou

URL pointant vers l'image de contrôle.

Déposez un fichier ou

URL pointant vers l'image de contrôle.

safety_checker_version par défaut v1

Choisissez entre un contrôleur de sécurité ViT personnalisé (`v2`) et le contrôleur CompVis (`v1`, par défaut).

format par défaut jpeg

Format de fichier de l'image résultante.

par défaut

Identifiant de requête permettant d'associer une réponse à la requête qui l'a produite.

par défaut 0.5

Intensité du conditionnement appliqué par ControlNet.

par défaut 35

Nombre d’étapes d’inférence à exécuter.

par défaut 7.5

Intensité d’adhésion à l’invite pour la sélection d’image, exprimée en CFG (Classifier Free Guidance).

par défaut 0.95

Degré de ressemblance entre l'image générée et l'image initiale.

Graine pour reproduire des images dans Stable Diffusion. Une image peut être reproduite exactement à chaque exécution si la version du modèle, l’invite et la graine restent inchangées.

par défaut []

Poids LoRA sélectionnés, fournis sous forme de liste.

par défaut []

Embeddings sélectionnés, fournis sous forme de liste.

POST /run/sdxl-controlnet-union/inpainting?wait=20 devis → 0,012 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/sdxl-controlnet-union/inpainting?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de SDXL ControlNet Union · Inpainting

Repeint uniquement la zone indiquée par `mask_url` sur l’image source `image_url`, selon une invite. Des images de contrôle facultatives (openpose, carte de profondeur, teed, canny, normal, segmentation) orientent le résultat, chacune disposant d’un interrupteur de prétraitement. `strength` accepte des valeurs de 0.01 à 1, le nombre d’étapes peut atteindre 70, avec jusqu’à 8 images par requête. Les LoRA, les embeddings et les sorties au format jpeg ou png sont pris en charge.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
promptobligatoire
Typestring
Décrivez l’image que vous souhaitez générer avec autant de détails que possible pour obtenir les meilleurs résultats.
controlnet_conditioning_scalefacultatif
Typenumber
Par défaut0.5
0 – 1
Intensité du conditionnement appliqué par ControlNet.
image_urlobligatoire image
Typeurl · image
Image de départ pour la génération, fournie par URL.
mask_urlobligatoire mask
Typeurl · image
URL pointant vers le masque d'inpainting.
negative_promptfacultatif
Typestring
Par défaut
Invite négative indiquant les détails d’image indésirables. Elle peut exclure des couleurs, objets, décors ou caractéristiques et qualités fines, comme une moustache, du flou ou une basse résolution.
image_sizefacultatif
Typeobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensions de sortie, déterminées automatiquement à partir de l'image de contrôle lorsqu'aucune taille n'est fournie.
num_inference_stepsfacultatif
Typeinteger
Par défaut35
1 – 70
Nombre d’étapes d’inférence à exécuter.
guidance_scalefacultatif
Typenumber
Par défaut7.5
0 – 20
Intensité d’adhésion à l’invite pour la sélection d’image, exprimée en CFG (Classifier Free Guidance).
strengthfacultatif
Typenumber
Par défaut0.95
0,01 – 1
Degré de ressemblance entre l'image générée et l'image initiale.
seedfacultatif
Typeinteger | null
Graine pour reproduire des images dans Stable Diffusion. Une image peut être reproduite exactement à chaque exécution si la version du modèle, l’invite et la graine restent inchangées.
num_imagesfacultatif num_outputs
Typeinteger
Par défaut1
1 – 8
Nombre d'images demandé pour la génération.
lorasfacultatif
Typeobject[]
Par défaut[]
Poids LoRA sélectionnés, fournis sous forme de liste.
loras[].forcefacultatif
Typeboolean
Par défautfalse
Indique si l'utilisation des embeddings est obligatoire : true la rend obligatoire.
loras[].pathobligatoire
Typestring
Source des poids LoRA, fournie sous la forme d'un identifiant de modèle HF correspondant à des poids safetensors, ou d'un fichier safetensors accessible par URL ou chemin.
loras[].scalefacultatif
Typenumber
Par défaut1
0 – 1
Multiplicateur appliqué au poids LoRA avant sa fusion avec le modèle de base.
embeddingsfacultatif
Typeobject[]
Par défaut[]
Embeddings sélectionnés, fournis sous forme de liste.
embeddings[].pathobligatoire
Typestring
Poids des embeddings spécifiés par URL ou chemin de fichier.
embeddings[].tokensfacultatif
Typestring[]
Liste de jetons d'embedding, avec attribution automatique de noms si elle est omise : chaque vecteur du fichier d'embedding reçoit un jeton de la séquence <s0>, <s1>, ... .
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Activation du contrôle de sécurité ; true active la vérification.
safety_checker_versionfacultatif
Typeenum
Par défautv1
v1v2
Choisissez entre un contrôleur de sécurité ViT personnalisé (`v2`) et le contrôleur CompVis (`v1`, par défaut).
expand_promptfacultatif
Typeboolean
Par défautfalse
Extension de l'invite avec des invites supplémentaires, activée lorsque true.
formatfacultatif
Typeenum
Par défautjpeg
jpegpng
Format de fichier de l'image résultante.
request_idfacultatif
Typestring
Par défaut
Identifiant de requête permettant d'associer une réponse à la requête qui l'a produite.
openpose_image_urlfacultatif
Typeurl · image
URL pointant vers l'image de contrôle.
openpose_preprocessfacultatif
Typeboolean
Par défauttrue
Contrôle le prétraitement de l’image openpose.
depth_image_urlfacultatif
Typeurl · image
URL pointant vers l'image de contrôle.
depth_preprocessfacultatif
Typeboolean
Par défauttrue
Contrôle le prétraitement de l’image de profondeur.
teed_image_urlfacultatif
Typeurl · image
URL pointant vers l'image de contrôle.
teed_preprocessfacultatif
Typeboolean
Par défauttrue
Contrôle le prétraitement de l’image teed.
canny_image_urlfacultatif
Typeurl · image
URL pointant vers l'image de contrôle.
canny_preprocessfacultatif
Typeboolean
Par défauttrue
Contrôle le prétraitement de l’image canny.
normal_image_urlfacultatif
Typeurl · image
URL pointant vers l'image de contrôle.
normal_preprocessfacultatif
Typeboolean
Par défauttrue
Contrôle le prétraitement de l’image normale.
segmentation_image_urlfacultatif
Typeurl · image
URL pointant vers l'image de contrôle.
segmentation_preprocessfacultatif
Typeboolean
Par défauttrue
Contrôle le prétraitement de l’image de segmentation.
obligatoire Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu'à 10 MB ou le file_url d'un téléversement. Fichiers

Sortie

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sdxl-controlnet-union/inpainting",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 12,
    "usd": "0.012",
    "charged": 12,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie sur notre stockage : conservée indéfiniment (facturation par Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Une structure identique pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et l'audio. output est l'objet de résultat propre au modèle.
Champs de sortie
images
array of object {url, width, height, content_type}Informations sur les fichiers des images générées.
timings
object
seed
integerGraine de génération d'image, incluant la valeur choisie aléatoirement si l'entrée ne fournissait pas de graine ; sinon, elle répète la valeur fournie.
has_nsfw_concepts
array of booleanIndique si des concepts NSFW apparaissent dans les images générées.
prompt
stringInvite utilisée pendant la génération d'image.

Plus de modèles : Édition d’image

Pour les agents IA : cette page au format Markdown est disponible à l'adresse https://doitong.com/fr-FR/developers/models/sdxl-controlnet-union/inpainting.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt