Langkau ke kandungan

Z Image Turbo Controlnet

Integrasikan

ID 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Permintaan ini: ≈$0.013 13 kredit API · ≈ ₽1.39 Jalankan pada halaman ini

Dapatkan kunci API
Alibaba · Imej

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan

Prompt yang memandu penjanaan imej.

•diperlukan image_url
Lepaskan fail, atau

URL imej yang digunakan sebagai input untuk penjanaan ControlNet.

image_size lalai auto

Dimensi imej yang dijana.

num_images lalai 1

Bilangan imej yang diminta untuk penjanaan.

Lanjutan output_format · acceleration · preprocess · num_inference_steps · control_scale · control_start · control_end · seed · enable_safety_checker · enable_prompt_expansion
output_format lalai png

Format fail untuk imej yang terhasil.

acceleration lalai regular

Tahap pecutan yang digunakan pada pemprosesan.

preprocess lalai none

Kaedah prapemprosesan yang digunakan pada imej, atau tiada prapemprosesan.

lalai 8

Bilangan langkah inferens yang perlu dijalankan.

lalai 0.75

Kekuatan pengkondisian yang digunakan oleh ControlNet.

lalai 0

Titik permulaan untuk pengkondisian ControlNet.

lalai 0.8

Titik penamat untuk pengkondisian ControlNet.

Seed untuk imej yang boleh dihasilkan semula: prompt dan seed yang sama menghasilkan imej yang sama apabila versi model tidak berubah.

POST /run/z-image/turbo/controlnet?wait=20 sebut harga → $0.013
# 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/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Z Image Turbo Controlnet

Menjana daripada `prompt` sementara imej kawalan (`image_url`) memandu struktur. `preprocess` boleh mengekstrak tepi canny, peta kedalaman atau pose, atau menggunakan none. `control_scale`, `control_start` dan `control_end` menala kekuatan serta masa pelaziman digunakan. Menyokong sehingga 4 imej, 8 langkah dan `image_size` auto.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
Prompt yang memandu penjanaan imej.
image_sizepilihan
Jenisobject
Lalaiauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Dimensi imej yang dijana.
num_inference_stepspilihan
Jenisinteger
Lalai8
1 – 8
Bilangan langkah inferens yang perlu dijalankan.
seedpilihan
Jenisinteger | null
Seed untuk imej yang boleh dihasilkan semula: prompt dan seed yang sama menghasilkan imej yang sama apabila versi model tidak berubah.
num_imagespilihan num_outputs
Jenisinteger
Lalai1
1 – 4
Bilangan imej yang diminta untuk penjanaan.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan keselamatan, yang mengembalikan imej hitam menggantikan imej yang ditandai tidak selamat. Nilai true mendayakan pemeriksaan; false melumpuhkannya hanya untuk akaun yang dibenarkan, manakala permintaan tanpa kebenaran tetap diperiksa.
output_formatpilihan
Jenisenum
Lalaipng
jpegpngwebp
Format fail untuk imej yang terhasil.
accelerationpilihan
Jenisenum
Lalairegular
noneregularhigh
Tahap pecutan yang digunakan pada pemprosesan.
enable_prompt_expansionpilihan
Jenisboolean
Lalaifalse
Mengawal sama ada pengembangan prompt didayakan.
image_urldiperlukan image
Jenisurl · image
URL imej yang digunakan sebagai input untuk penjanaan ControlNet.
control_scalepilihan
Jenisnumber
Lalai0.75
0 – 1
Kekuatan pengkondisian yang digunakan oleh ControlNet.
control_startpilihan
Jenisnumber
Lalai0
0 – 1
Titik permulaan untuk pengkondisian ControlNet.
control_endpilihan
Jenisnumber
Lalai0.8
0 – 1
Titik penamat untuk pengkondisian ControlNet.
preprocesspilihan
Jenisenum
Lalainone
nonecannydepthpose
Kaedah prapemprosesan yang digunakan pada imej, atau tiada prapemprosesan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
images
array of object {url, content_type, file_name, file_size, width, height}Maklumat fail untuk imej yang dijana.
timings
objectMaklumat masa untuk proses penjanaan.
seed
integerSeed penjanaan imej, termasuk nilai yang dipilih secara rawak jika input tidak membekalkan seed; jika tidak, nilai yang dibekalkan diulang.
has_nsfw_concepts
array of booleanMenunjukkan sama ada konsep NSFW muncul dalam imej yang dijana.
prompt
stringPrompt yang digunakan semasa penjanaan imej.

Lebih banyak model: Penyuntingan Imej

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/z-image/turbo/controlnet.md. Semua model dan panduan: https://doitong.com/developers/llms.txt