Saltar al cuntegna

ControlNet SDXL

Integrar

ID dal model fast-sdxl-controlnet-canny
# 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/fast-sdxl-controlnet-canny?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",
    "control_image_url": "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"

Questa dumonda: ≈$0,015 15 credits API · ≈ ₽1,60 Lantschar sin questa pagina

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

SDXL text-a-maletg guidà d'in maletg da controlla per generaziun cun cumposiziun fixa

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.

•obligatori
Trametta in datoteca u

URL che mussa al maletg da controlla.

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 · safety_checker_version · format · request_id · controlnet_conditioning_scale · num_inference_steps · guidance_scale · seed · enable_safety_checker · expand_prompt · 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.

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/fast-sdxl-controlnet-canny?wait=20 calculaziun → $0,015
# 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/fast-sdxl-controlnet-canny?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",
    "control_image_url": "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"

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 ControlNet SDXL

Generescha maletgs d'in `prompt` plus in `control_image_url` necessari che diriga la disposiziun. `controlnet_conditioning_scale` va da 0 fin 1 (standard 0.5). La grondezza da l'output vegn deducida dal maletg da controlla, sche betg vegn fixada `image_size`. Sustegna fin a 8 maletgs per clamada, fin a 70 pass, LoRAs ed embeddings.

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.
control_image_urlobligatori
Tipurl · image
URL che mussa al maletg da controlla.
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.
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": "fast-sdxl-controlnet-canny",
  "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": 15,
    "usd": "0.015",
    "charged": 15,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "control_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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"
  }
}
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/fast-sdxl-controlnet-canny.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt