Lumaktaw sa nilalaman

Z Image Turbo Controlnet

I-integrate

ID ng modelo 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"

Kahilingang ito: ≈$0.013 13 kredito ng API Patakbuhin ito sa page na ito

Kumuha ng API key
Alibaba · Larawan

Dito mapupunta ang iyong unang resulta

Bumuo ng kahilingan sa ibaba at patakbuhin ito gamit ang iyong API key. Kinokopya ang mga output sa aming storage, na pinananatili nang walang hanggan o 7 araw nang libre.

Bumuo ng kahilingan

Ang mga control ay binubuo mula sa schema ng modelo. Nagbabago ang code at presyo habang ina-adjust mo ang mga ito.

•kinakailangan

Prompt na gumagabay sa pagbuo ng larawan.

•kinakailangan image_url
Mag-drop ng file, o

URL ng larawan na ginagamit bilang input para sa pagbuo gamit ang ControlNet.

image_size default na auto

Mga dimension ng nabuong larawan.

num_images default na 1

Bilang ng larawang hinihingi para sa pagbuo.

advanced output_format · acceleration · preprocess · num_inference_steps · control_scale · control_start · control_end · seed · enable_safety_checker · enable_prompt_expansion
output_format default na png

File format ng resultang larawan.

acceleration default na regular

Antas ng acceleration na inilapat sa pagproseso.

preprocess default na none

Paraan ng preprocessing na inilalapat sa larawan, o walang preprocessing.

default na 8

Bilang ng inference step na isasagawa.

default na 0.75

Lakas ng conditioning na inilalapat ng ControlNet.

default na 0

Panimulang punto para sa conditioning ng ControlNet.

default na 0.8

Pangwakas na punto para sa conditioning ng ControlNet.

Seed para sa nauulit na mga larawan: ang magkaparehong prompt at seed ay gumagawa ng magkaparehong larawan kapag hindi nagbago ang bersyon ng modelo.

POST /run/z-image/turbo/controlnet?wait=20 presyo → $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"

Patakbuhin ang kahilingang ito

Nananatili ang iyong key sa browser na ito: ipinapadala lamang ito sa Doitong API at sine-save (localStorage) lamang kung pipiliin mo ang Tandaan. Kumuha ng API key

Tungkol sa Z Image Turbo Controlnet

Bumubuo mula sa `prompt` habang ginagabayan ng control larawan (`image_url`) ang istruktura. Maaaring mag-extract ang `preprocess` ng canny edges, depth o pose, o gumamit ng none. Tinutune ng `control_scale`, `control_start` at `control_end` kung gaano kalakas at kailan ilalapat ang conditioning. Sinusuportahan ang hanggang 4 na larawan, 8 hakbang at awtomatikong `image_size`.

Mga parameter

Ipadala ang canonical na pangalan o ang native na pangalan, hindi pareho. Mga canonical na pangalan

PangalanUri defaultPinapayagan Paglalarawan
promptkinakailangan
Uristring
Prompt na gumagabay sa pagbuo ng larawan.
image_sizeopsyonal
Uriobject
defaultauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Mga dimension ng nabuong larawan.
num_inference_stepsopsyonal
Uriinteger
default8
1 – 8
Bilang ng inference step na isasagawa.
seedopsyonal
Uriinteger | null
Seed para sa nauulit na mga larawan: ang magkaparehong prompt at seed ay gumagawa ng magkaparehong larawan kapag hindi nagbago ang bersyon ng modelo.
num_imagesopsyonal num_outputs
Uriinteger
default1
1 – 4
Bilang ng larawang hinihingi para sa pagbuo.
enable_safety_checkeropsyonal
Uriboolean
defaulttrue
Safety checking na nagbabalik ng mga itim na larawan kapalit ng mga larawang na-flag na unsafe. Pinapagana ng true ang checking; dini-disable ito ng false para lamang sa mga awtorisadong account, habang sinusuri pa rin ang mga kahilingang walang authorization.
output_formatopsyonal
Urienum
defaultpng
jpegpngwebp
File format ng resultang larawan.
accelerationopsyonal
Urienum
defaultregular
noneregularhigh
Antas ng acceleration na inilapat sa pagproseso.
enable_prompt_expansionopsyonal
Uriboolean
defaultfalse
Kinokontrol kung naka-enable ang prompt expansion.
image_urlkinakailangan image
Uriurl · image
URL ng larawan na ginagamit bilang input para sa pagbuo gamit ang ControlNet.
control_scaleopsyonal
Urinumber
default0.75
0 – 1
Lakas ng conditioning na inilalapat ng ControlNet.
control_startopsyonal
Urinumber
default0
0 – 1
Panimulang punto para sa conditioning ng ControlNet.
control_endopsyonal
Urinumber
default0.8
0 – 1
Pangwakas na punto para sa conditioning ng ControlNet.
preprocessopsyonal
Urienum
defaultnone
nonecannydepthpose
Paraan ng preprocessing na inilalapat sa larawan, o walang preprocessing.
kinakailangan Canonical na pangalan, tinatanggap din

Tumatanggap ang mga parameter ng file ng pampublikong https:// URL, data: URI na hanggang 10 MB, o file_url ng isang upload. Mga file

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"
  }
}
Ikaw ang pumipili para sa iyong mga fileAng bawat outputs[].url ay kopya sa aming storage: pinananatili nang walang hanggan (sinisingil bawat GB-month) o 7 araw nang libre, ayon sa setting ng iyong account o ?storage=.
Parehong shape sa bawat modelotype, url, content_type, width, height at duration, para sa mga larawan, video at audio. Ang output ay sariling result object ng modelo.
Mga field ng output
images
array of object {url, content_type, file_name, file_size, width, height}Impormasyon ng file para sa mga nabuong larawan.
timings
objectImpormasyon sa oras para sa proseso ng pagbuo.
seed
integerSeed para sa pagbuo ng larawan, kasama ang random na napiling value kung walang seed sa input; kung hindi, inuulit nito ang ibinigay na value.
has_nsfw_concepts
array of booleanNagsasaad kung may mga konseptong NSFW sa nabuong mga larawan.
prompt
stringPrompt na ginagamit sa pagbuo ng larawan.

Higit pang modelo: Pag-edit ng Larawan

Para sa mga AI agent: nasa Markdown ang pahinang ito sa https://doitong.com/fil/developers/models/z-image/turbo/controlnet.md. Lahat ng modelo at gabay: https://doitong.com/developers/llms.txt