Vai al contenuto

SDXL ControlNet Union

Integra

ID del modello sdxl-controlnet-union
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/sdxl-controlnet-union?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"
  }'

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

Questa richiesta: ≈0,014 $ 14 crediti API Esegui in questa pagina

Ottieni la chiave API
Stability AI Da testo a immagine #diffusion#controlnet#composition

Text-to-image SDXL guidato da fino a sei immagini di controllo: openpose, mappa di profondità, teed, canny, normal, segmentazione

Stability AI · Immagine

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio

Descrivi l'immagine che vuoi generare, usando più dettagli possibile per ottenere i risultati migliori.

image_size

Dimensioni dell'output, determinate automaticamente dall'immagine di controllo quando non viene fornita una dimensione.

num_images predefinito 1

Numero di immagini richiesto per la generazione.

Avanzate 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 · seed · enable_safety_checker · expand_prompt · openpose_preprocess · depth_preprocess · teed_preprocess · canny_preprocess · normal_preprocess · segmentation_preprocess · loras · embeddings
predefinito

Prompt negativo che specifica i dettagli dell'immagine da escludere, inclusi colori, oggetti, scenari o caratteristiche più fini. Esempi: baffi, sfocatura o bassa risoluzione.

Trascina un file oppure

URL dell'immagine di controllo.

Trascina un file oppure

URL dell'immagine di controllo.

Trascina un file oppure

URL dell'immagine di controllo.

Trascina un file oppure

URL dell'immagine di controllo.

Trascina un file oppure

URL dell'immagine di controllo.

Trascina un file oppure

URL dell'immagine di controllo.

safety_checker_version predefinito v1

Scegliere tra un verificatore di sicurezza ViT personalizzato (`v2`) e il verificatore CompVis (`v1`, il predefinito).

format predefinito jpeg

Formato del file dell'immagine risultante.

predefinito

Identificatore della richiesta per associare una risposta alla richiesta che l'ha prodotta.

predefinito 0.5

Intensità del condizionamento applicato da ControlNet.

predefinito 35

Numero di passaggi di inferenza da eseguire.

predefinito 7.5

Intensità di aderenza al prompt per la selezione dell'immagine, espressa come CFG (Classifier Free Guidance).

Seed per riprodurre immagini in Stable Diffusion. Un'immagine può essere riprodotta esattamente a ogni esecuzione mantenendo invariati la versione del modello, il prompt e il seed.

predefinito []

Pesi LoRA selezionati per l'uso, forniti come elenco.

predefinito []

Embedding selezionati per l'uso, forniti come elenco.

POST /run/sdxl-controlnet-union?wait=20 preventivo → 0,014 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/sdxl-controlnet-union?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"
  }'

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

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su SDXL ControlNet Union

Genera immagini SDXL da un `prompt` guidato da immagini di controllo come openpose, mappa di profondità, teed, canny, normal o segmentazione, ciascuna con il proprio interruttore di preprocessing. `controlnet_conditioning_scale` varia da 0 a 1. La dimensione dell'immagine può essere dedotta dall'immagine di controllo. Supporta LoRA, embedding, da 1 a 8 immagini e output jpeg o png.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
promptobbligatorio
Tipostring
Descrivi l'immagine che vuoi generare, usando più dettagli possibile per ottenere i risultati migliori.
controlnet_conditioning_scalefacoltativo
Tiponumber
Predefinito0.5
0 – 1
Intensità del condizionamento applicato da ControlNet.
negative_promptfacoltativo
Tipostring
Predefinito
Prompt negativo che specifica i dettagli dell'immagine da escludere, inclusi colori, oggetti, scenari o caratteristiche più fini. Esempi: baffi, sfocatura o bassa risoluzione.
image_sizefacoltativo
Tipoobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensioni dell'output, determinate automaticamente dall'immagine di controllo quando non viene fornita una dimensione.
num_inference_stepsfacoltativo
Tipointeger
Predefinito35
1 – 70
Numero di passaggi di inferenza da eseguire.
seedfacoltativo
Tipointeger | null
Seed per riprodurre immagini in Stable Diffusion. Un'immagine può essere riprodotta esattamente a ogni esecuzione mantenendo invariati la versione del modello, il prompt e il seed.
guidance_scalefacoltativo
Tiponumber
Predefinito7.5
0 – 20
Intensità di aderenza al prompt per la selezione dell'immagine, espressa come CFG (Classifier Free Guidance).
num_imagesfacoltativo num_outputs
Tipointeger
Predefinito1
1 – 8
Numero di immagini richiesto per la generazione.
lorasfacoltativo
Tipoobject[]
Predefinito[]
Pesi LoRA selezionati per l'uso, forniti come elenco.
loras[].forcefacoltativo
Tipoboolean
Predefinitofalse
Indica se l'uso dell'embedding è obbligatorio: true lo rende obbligatorio.
loras[].pathobbligatorio
Tipostring
Origine dei pesi LoRA, fornita come identificatore di modello HF che risolve in pesi safetensors oppure come file safetensors individuato tramite URL o percorso.
loras[].scalefacoltativo
Tiponumber
Predefinito1
0 – 1
Moltiplicatore applicato al peso LoRA prima di unirlo al modello di base.
embeddingsfacoltativo
Tipoobject[]
Predefinito[]
Embedding selezionati per l'uso, forniti come elenco.
embeddings[].pathobbligatorio
Tipostring
Pesi dell'embedding specificati tramite URL o percorso del file.
embeddings[].tokensfacoltativo
Tipostring[]
Elenco dei token dell'embedding, con denominazione automatica se omesso: ogni vettore nel file dell'embedding riceve un token della sequenza <s0>, <s1>, ... .
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Attivazione del controllo di sicurezza; true abilita il controllo.
safety_checker_versionfacoltativo
Tipoenum
Predefinitov1
v1v2
Scegliere tra un verificatore di sicurezza ViT personalizzato (`v2`) e il verificatore CompVis (`v1`, il predefinito).
expand_promptfacoltativo
Tipoboolean
Predefinitofalse
Espansione del prompt con prompt aggiuntivi, abilitata quando true.
formatfacoltativo
Tipoenum
Predefinitojpeg
jpegpng
Formato del file dell'immagine risultante.
request_idfacoltativo
Tipostring
Predefinito
Identificatore della richiesta per associare una risposta alla richiesta che l'ha prodotta.
openpose_image_urlfacoltativo
Tipourl · image
URL dell'immagine di controllo.
openpose_preprocessfacoltativo
Tipoboolean
Predefinitotrue
Controlla la preelaborazione dell'immagine openpose.
depth_image_urlfacoltativo
Tipourl · image
URL dell'immagine di controllo.
depth_preprocessfacoltativo
Tipoboolean
Predefinitotrue
Controlla la preelaborazione dell'immagine di profondità.
teed_image_urlfacoltativo
Tipourl · image
URL dell'immagine di controllo.
teed_preprocessfacoltativo
Tipoboolean
Predefinitotrue
Controlla la preelaborazione dell'immagine teed.
canny_image_urlfacoltativo
Tipourl · image
URL dell'immagine di controllo.
canny_preprocessfacoltativo
Tipoboolean
Predefinitotrue
Controlla la preelaborazione dell'immagine canny.
normal_image_urlfacoltativo
Tipourl · image
URL dell'immagine di controllo.
normal_preprocessfacoltativo
Tipoboolean
Predefinitotrue
Controlla la preelaborazione dell'immagine normal.
segmentation_image_urlfacoltativo
Tipourl · image
URL dell'immagine di controllo.
segmentation_preprocessfacoltativo
Tipoboolean
Predefinitotrue
Controlla la preelaborazione dell'immagine di segmentazione.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sdxl-controlnet-union",
  "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": 14,
    "usd": "0.014",
    "charged": 14,
    "refunded": 0
  },
  "input": {
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
images
array of object {url, width, height, content_type}Informazioni sui file delle immagini generate.
timings
object
seed
integerSeed della generazione di immagini, incluso il valore scelto casualmente se l'input non forniva un seed; altrimenti ripete il valore fornito.
has_nsfw_concepts
array of booleanIndica se nelle immagini generate compaiono concetti NSFW.
prompt
stringPrompt usato durante la generazione di immagini.

Altri modelli: Da testo a immagine

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/sdxl-controlnet-union.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt