İçeriğe geç

Z Image Turbo Controlnet

Entegre et

Model kimliği 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"

Bu istek: ≈$0,013 13 API kredisi Bu sayfada çalıştır

API anahtarı al
Alibaba · Görsel

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

•gerekli

Görsel üretimine yön veren istem.

•gerekli image_url
Dosyayı bırakın veya

ControlNet üretimi için girdi olarak kullanılan görsel URL'si.

image_size varsayılan auto

Üretilen görselin boyutları.

num_images varsayılan 1

Üretim için istenen görsel sayısı.

Gelişmiş output_format · acceleration · preprocess · num_inference_steps · control_scale · control_start · control_end · seed · enable_safety_checker · enable_prompt_expansion
output_format varsayılan png

Ortaya çıkan görselin dosya biçimi.

acceleration varsayılan regular

İşlemeye uygulanan hızlandırma düzeyi.

preprocess varsayılan none

Görsele uygulanan ön işleme yöntemi veya ön işleme uygulanmaması.

varsayılan 8

Çalıştırılacak çıkarım adımlarının sayısı.

varsayılan 0.75

ControlNet tarafından uygulanan koşullandırmanın gücü.

varsayılan 0

ControlNet koşullandırmasının başlangıç noktası.

varsayılan 0.8

ControlNet koşullandırmasının bitiş noktası.

Tekrarlanabilir görseller için seed: model sürümü değişmediğinde aynı istem ve seed, aynı görseli üretir.

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

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Z Image Turbo Controlnet hakkında

Yapıyı bir kontrol görseli (`image_url`) yönlendirirken bir `prompt` üzerinden çıktı üretir. `preprocess`, canny kenarlarını, derinliği veya pozu çıkarabilir ya da none kullanılabilir. `control_scale`, `control_start` ve `control_end`, koşullandırmanın ne kadar güçlü uygulanacağını ve ne zaman başlayıp biteceğini ayarlar. En fazla 4 görseli ve 8 adımı destekler; `image_size` değeri auto olabilir.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
promptgerekli
Türstring
Görsel üretimine yön veren istem.
image_sizeisteğe bağlı
Türobject
Varsayılanauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Üretilen görselin boyutları.
num_inference_stepsisteğe bağlı
Türinteger
Varsayılan8
1 – 8
Çalıştırılacak çıkarım adımlarının sayısı.
seedisteğe bağlı
Türinteger | null
Tekrarlanabilir görseller için seed: model sürümü değişmediğinde aynı istem ve seed, aynı görseli üretir.
num_imagesisteğe bağlı num_outputs
Türinteger
Varsayılan1
1 – 4
Üretim için istenen görsel sayısı.
enable_safety_checkeristeğe bağlı
Türboolean
Varsayılantrue
Güvenlik denetimi; güvenli olmadığı işaretlenen görsellerin yerine siyah görseller döndürür. true denetimi etkinleştirir; false yalnızca yetkili hesaplarda denetimi devre dışı bırakır, yetkisiz istekler her durumda denetlenir.
output_formatisteğe bağlı
Türenum
Varsayılanpng
jpegpngwebp
Ortaya çıkan görselin dosya biçimi.
accelerationisteğe bağlı
Türenum
Varsayılanregular
noneregularhigh
İşlemeye uygulanan hızlandırma düzeyi.
enable_prompt_expansionisteğe bağlı
Türboolean
Varsayılanfalse
İstem genişletmenin etkin olup olmadığını denetler.
image_urlgerekli image
Türurl · image
ControlNet üretimi için girdi olarak kullanılan görsel URL'si.
control_scaleisteğe bağlı
Türnumber
Varsayılan0.75
0 – 1
ControlNet tarafından uygulanan koşullandırmanın gücü.
control_startisteğe bağlı
Türnumber
Varsayılan0
0 – 1
ControlNet koşullandırmasının başlangıç noktası.
control_endisteğe bağlı
Türnumber
Varsayılan0.8
0 – 1
ControlNet koşullandırmasının bitiş noktası.
preprocessisteğe bağlı
Türenum
Varsayılannone
nonecannydepthpose
Görsele uygulanan ön işleme yöntemi veya ön işleme uygulanmaması.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

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"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
images
array of object {url, content_type, file_name, file_size, width, height}Üretilen görsellerin dosya bilgileri.
timings
objectÜretim sürecinin zamanlama bilgileri.
seed
integerGörsel üretimi seed'i; girdi seed sağlamadıysa rastgele seçilen değeri içerir, aksi durumda sağlanan değeri tekrarlar.
has_nsfw_concepts
array of booleanÜretilen görsellerde NSFW kavramlarının bulunup bulunmadığını belirtir.
prompt
stringGörsel üretimi sırasında kullanılan istem.

Daha fazla model: Görsel Düzenleme

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/z-image/turbo/controlnet.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt