Saltar al cuntegna

Z Image Turbo Controlnet

Integrar

ID dal model z-image/turbo/controlnet
# 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/z-image/turbo/controlnet?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"
  }'

# 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,013 13 credits API Lantschar sin questa pagina

Obtegna ina clav API
Alibaba · 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

Prompt che gida la generaziun dal maletg.

•obligatori image_url
Trametta in datoteca u

URL dal maletg utilisà sco input per la generaziun ControlNet.

image_size standard auto

Dimensiuns dal maletg generà.

num_images standard 1

Dumber da maletgs dumandà per la generaziun.

Avanzà output_format · acceleration · preprocess · num_inference_steps · control_scale · control_start · control_end · seed · enable_safety_checker · enable_prompt_expansion
output_format standard png

Format da datoteca dal maletg final.

acceleration standard regular

Nivel d'acceleraziun applitgà a l'elavuraziun.

preprocess standard none

Metoda da pre-elavuraziun applitgada al maletg, u nagina pre-elavuraziun.

standard 8

Dumber da pass d'inferenzia da manar a fin.

standard 0.75

Fortezza dal conditioning applitgà da ControlNet.

standard 0

Punct da partenza per il conditioning ControlNet.

standard 0.8

Punct final per il conditioning ControlNet.

Semenza per maletgs reproducibels: in prompt ed ina semenza identics produceschan il medem maletg sch'è la versiun dal model invariada.

POST /run/z-image/turbo/controlnet?wait=20 calculaziun → $0,013
# 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/z-image/turbo/controlnet?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"
  }'

# 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 Z Image Turbo Controlnet

Generescha dad in `prompt` mentant ch'in maletg da controlla (`image_url`) dirigia la structura. `preprocess` po extrair urs canny, profunditad u posa, u duvrar none. `control_scale`, `control_start` e `control_end` reglan l'intensitad e il temp d'applicaziun da la condicionaziun. Sustegna fin a 4 maletgs, 8 pass e `image_size` automatic.

Parameters

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

NumTip StandardPermess Descripziun
promptobligatori
Tipstring
Prompt che gida la generaziun dal maletg.
image_sizeopziunal
Tipobject
Standardauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Dimensiuns dal maletg generà.
num_inference_stepsopziunal
Tipinteger
Standard8
1 – 8
Dumber da pass d'inferenzia da manar a fin.
seedopziunal
Tipinteger | null
Semenza per maletgs reproducibels: in prompt ed ina semenza identics produceschan il medem maletg sch'è la versiun dal model invariada.
num_imagesopziunal num_outputs
Tipinteger
Standard1
1 – 4
Dumber da maletgs dumandà per la generaziun.
enable_safety_checkeropziunal
Tipboolean
Standardtrue
Controlla da segirezza che restituescha maletgs nairs enstagl da maletgs marcads sco privlus. La valur true activa la controlla; false la deactivescha mo per contos autorisads, entant che dumondas senza autorisaziun vegnan controlladas tuttina.
output_formatopziunal
Tipenum
Standardpng
jpegpngwebp
Format da datoteca dal maletg final.
accelerationopziunal
Tipenum
Standardregular
noneregularhigh
Nivel d'acceleraziun applitgà a l'elavuraziun.
enable_prompt_expansionopziunal
Tipboolean
Standardfalse
Controlla sche l'expansiun dal prompt è activada.
image_urlobligatori image
Tipurl · image
URL dal maletg utilisà sco input per la generaziun ControlNet.
control_scaleopziunal
Tipnumber
Standard0.75
0 – 1
Fortezza dal conditioning applitgà da ControlNet.
control_startopziunal
Tipnumber
Standard0
0 – 1
Punct da partenza per il conditioning ControlNet.
control_endopziunal
Tipnumber
Standard0.8
0 – 1
Punct final per il conditioning ControlNet.
preprocessopziunal
Tipenum
Standardnone
nonecannydepthpose
Metoda da pre-elavuraziun applitgada al maletg, u nagina pre-elavuraziun.
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": "z-image/turbo/controlnet",
  "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": 13,
    "usd": "0.013",
    "charged": 13,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "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, content_type, file_name, file_size, width, height}Infurmaziuns da la datoteca per ils maletgs generads.
timings
objectInfurmaziuns davart il temp dal process da generaziun.
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: Modificaziun da maletgs

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