Saltar al cuntegna

SDXL ControlNet Union

Integrar

ID dal model 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 dumonda: ≈$0,014 14 credits API Lantschar sin questa pagina

Obtegna ina clav API
Stability AI Text a maletg #diffusion#controlnet#composition

SDXL da text a maletg guidà da fin sis maletgs da controlla: openpose, mapa da profunditad, teed, canny, normal, segmentaziun

Stability AI · Maletg

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori

Descriva il maletg che ti vuls generar, cun uschè blers detagls sco pussaivel per ils megliers resultats.

image_size

Dimensiuns da l'output, determinadas automaticamain dal maletg da controlla sch'ina grondezza n'è betg furnida.

num_images standard 1

Dumber da maletgs dumandà per la generaziun.

Avanzà 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
standard

Prompt negativ che specifica detagls dal maletg d'excluder, inclusiv colurs, objects, cuntradas u caracteristicas pli finas. Exempels èn ina mustazza, sfuschadad u ina resoluziun bassa.

Trametta in datoteca u

URL che mussa al maletg da controlla.

Trametta in datoteca u

URL che mussa al maletg da controlla.

Trametta in datoteca u

URL che mussa al maletg da controlla.

Trametta in datoteca u

URL che mussa al maletg da controlla.

Trametta in datoteca u

URL che mussa al maletg da controlla.

Trametta in datoteca u

URL che mussa al maletg da controlla.

safety_checker_version standard v1

Tscherna tranter in controllader da segirezza ViT persunalisà (`v2`) e il controllader CompVis (`v1`, il standard).

format standard jpeg

Format da datoteca dal maletg final.

standard

Identificader da la dumonda per colliar ina resposta cun la dumonda che l'ha producìda.

standard 0.5

Fortezza dal conditioning applitgà da ControlNet.

standard 35

Dumber da pass d'inferenzia da manar a fin.

standard 7.5

Furza d'aderenza al prompt per la selecziun dal maletg, exprimida sco CFG (Classifier Free Guidance).

Seed per reproducir maletgs en Stable Diffusion. In maletg po vegnir reproducì exactamain en mintga execuziun sche la versiun dal model, il prompt ed il seed restan invariads.

standard []

Ponderaziuns LoRA tschernidas per l'utilisaziun, furnidas sco glista.

standard []

Embeddings tschernids per l'utilisaziun, furnids sco glista.

POST /run/sdxl-controlnet-union?wait=20 calculaziun → $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"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart SDXL ControlNet Union

Generescha maletgs SDXL a partir d'in `prompt`, guidà da maletgs da controlla sco openpose, mapa da profunditad, teed, canny, normal u segmentaziun, mintgin cun in agen commutatur per la preelavuraziun. `controlnet_conditioning_scale` va da 0 fin 1. La grondezza dal maletg po vegnir deducida dal maletg da controlla. Sustegna LoRAs, embeddings, 1 fin 8 maletgs ed output jpeg u png.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
promptobligatori
Tipstring
Descriva il maletg che ti vuls generar, cun uschè blers detagls sco pussaivel per ils megliers resultats.
controlnet_conditioning_scaleopziunal
Tipnumber
Standard0.5
0 – 1
Fortezza dal conditioning applitgà da ControlNet.
negative_promptopziunal
Tipstring
Standard
Prompt negativ che specifica detagls dal maletg d'excluder, inclusiv colurs, objects, cuntradas u caracteristicas pli finas. Exempels èn ina mustazza, sfuschadad u ina resoluziun bassa.
image_sizeopziunal
Tipobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensiuns da l'output, determinadas automaticamain dal maletg da controlla sch'ina grondezza n'è betg furnida.
num_inference_stepsopziunal
Tipinteger
Standard35
1 – 70
Dumber da pass d'inferenzia da manar a fin.
seedopziunal
Tipinteger | null
Seed per reproducir maletgs en Stable Diffusion. In maletg po vegnir reproducì exactamain en mintga execuziun sche la versiun dal model, il prompt ed il seed restan invariads.
guidance_scaleopziunal
Tipnumber
Standard7.5
0 – 20
Furza d'aderenza al prompt per la selecziun dal maletg, exprimida sco CFG (Classifier Free Guidance).
num_imagesopziunal num_outputs
Tipinteger
Standard1
1 – 8
Dumber da maletgs dumandà per la generaziun.
lorasopziunal
Tipobject[]
Standard[]
Ponderaziuns LoRA tschernidas per l'utilisaziun, furnidas sco glista.
loras[].forceopziunal
Tipboolean
Standardfalse
Indica sche l'utilisaziun da l'embedding è obligatorica: true la renda obligatorica.
loras[].pathobligatori
Tipstring
Funtauna da la ponderaziun LoRA, furnida sco identificader d'in model HF che resolvescha a ponderaziuns safetensors u sco ina datoteca safetensors accessibla tras URL u via tschep.
loras[].scaleopziunal
Tipnumber
Standard1
0 – 1
Multiplicatur applitgà al pais da LoRA avant che quel vegn fusiunà en il model da basa.
embeddingsopziunal
Tipobject[]
Standard[]
Embeddings tschernids per l'utilisaziun, furnids sco glista.
embeddings[].pathobligatori
Tipstring
Ponderaziuns da l'embedding specifitgadas tras URL u tschep da datoteca.
embeddings[].tokensopziunal
Tipstring[]
Glista da tokens da l'embedding; sch'omess, vegn attribuì automaticamain in token da la sequenza <s0>, <s1>, ... a mintga vector en la datoteca d'embedding.
enable_safety_checkeropziunal
Tipboolean
Standardtrue
Activaziun da la controlla da segirezza; true activa la controlla.
safety_checker_versionopziunal
Tipenum
Standardv1
v1v2
Tscherna tranter in controllader da segirezza ViT persunalisà (`v2`) e il controllader CompVis (`v1`, il standard).
expand_promptopziunal
Tipboolean
Standardfalse
Expansiun dal prompt cun prompts supplementars, activada sche true.
formatopziunal
Tipenum
Standardjpeg
jpegpng
Format da datoteca dal maletg final.
request_idopziunal
Tipstring
Standard
Identificader da la dumonda per colliar ina resposta cun la dumonda che l'ha producìda.
openpose_image_urlopziunal
Tipurl · image
URL che mussa al maletg da controlla.
openpose_preprocessopziunal
Tipboolean
Standardtrue
Controllescha il preelavurament da la maletg openpose.
depth_image_urlopziunal
Tipurl · image
URL che mussa al maletg da controlla.
depth_preprocessopziunal
Tipboolean
Standardtrue
Controllescha il preelavurament da la maletg da profunditad.
teed_image_urlopziunal
Tipurl · image
URL che mussa al maletg da controlla.
teed_preprocessopziunal
Tipboolean
Standardtrue
Controllescha il preelavurament da la maletg teed.
canny_image_urlopziunal
Tipurl · image
URL che mussa al maletg da controlla.
canny_preprocessopziunal
Tipboolean
Standardtrue
Controllescha il preelavurament da la maletg canny.
normal_image_urlopziunal
Tipurl · image
URL che mussa al maletg da controlla.
normal_preprocessopziunal
Tipboolean
Standardtrue
Controllescha il preelavurament da la maletg normal.
segmentation_image_urlopziunal
Tipurl · image
URL che mussa al maletg da controlla.
segmentation_preprocessopziunal
Tipboolean
Standardtrue
Controllescha il preelavurament da la maletg da segmentaziun.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
images
array of object {url, width, height, content_type}Infurmaziuns da la datoteca per ils maletgs generads.
timings
object
seed
integerSeed da la generaziun dal maletg, inclusa la valur tschernida casualmain sche l'input n'ha betg furnì in seed; autramain repeta la valur furnida.
has_nsfw_concepts
array of booleanInditgescha sche concepts NSFW cumparan en ils maletgs generads.
prompt
stringPrompt utilisà durant la generaziun dal maletg.

Dapli models: Text a maletg

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/sdxl-controlnet-union.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt