Referansv1.0.0 Kararlı

Z Image Turbo API

Yüksek performanslı yapay zeka görsel üretim yeteneklerini entegre edin. Bu dokümantasyon, geliştiricilerin hızlı bir şekilde yapay zeka görsel uygulamaları oluşturmasına yardımcı olmak için eksiksiz API referansı, entegrasyon rehberleri ve kod örnekleri sunar.

https://zimageturbo.ai

Hızlı başlangıç

İlk API çağrınızı yalnızca iki adımda tamamlayın: bir üretim görevi gönderin ve ardından durumu sorgulayın.

Görev gönder

Bir görev kimliği (Task ID) almak için generate uç noktasına POST isteği gönderin.

Durumu sorgula

Görsel URL’sini alana kadar ilerlemeyi kontrol etmek için görev kimliğini kullanın.

Kimlik doğrulama

Not: Lütfen API anahtarınızı güvenli tutun ve istemci tarafı kodda ortaya çıkarmayın.

HTTP başlığı

Authorization: Bearer {YOUR_API_KEY}

POST

https://zimageturbo.ai/api/generate

Create a new image generation task. This endpoint is asynchronous and returns a task_id plus initial status; call /api/status to retrieve the final images.

This endpoint responds immediately with task_id. Poll /api/status until the status becomes SUCCESS to obtain image URLs.

Gövde parametreleri

Parametre adı	Tür	Zorunlu	Açıklama
`prompt`	string	Evet	Text prompt for generation (max 1000 characters).
`aspect_ratio`	string	Evet	Aspect ratio for the generated image. Allowed values: 1:1, 4:3, 3:4, 16:9, 9:16.

Yanıt (JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://zimageturbo.ai/api/status

Bir görevin yürütme durumunu ve sonuçlarını sorgular.

Sorgu parametreleri

Parametre adı	Zorunlu	Açıklama
`task_id`	Evet	Görev gönderilirken döndürülen kimlik.

Yanıt örneği

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

Faturalandırma

Üretim başına maliyet

$0.02 / istek

Başarısız görevler için ücret alınmaz.

Hata yönetimi

401 UnauthorizedGeçersiz API anahtarı
402 Payment RequiredYetersiz bakiye
429 Too Many RequestsÇok fazla istek

Z Image Turbo hakkında

Z Image Turbo, en yeni difüzyon modelleri temel alınarak optimize edilmiş bir üretim motorudur. Çıkarım hızını geleneksel modellere kıyasla %300’e kadar artırmaya odaklanırken son derece yüksek sadakati korur. Gerçek zamanlı etkileşim, oyun varlığı üretimi ve e-ticaret tasarım senaryoları için uygundur.

Z-Image-Turbo — 6B parametreli, ultra hızlı metinden görsele model

Z-Image-Turbo, gecikme ve throughput’un kritik olduğu üretim iş yükleri için tasarlanmış, Tongyi-MAI tarafından geliştirilen 6 milyar parametreli bir metinden görsele modeldir. Tam bir görseli oluşturmak için yalnızca 8 örnekleme adımı kullanır; veri merkezi GPU’larında saniyenin altında gecikmeye ulaşır ve 16 GB VRAM’e sahip birçok tüketici kartında rahatça çalışır.

Üretime hazır kaliteyle ultra hızlı üretim

Pek çok difüzyon modeli düzinelerce adıma ihtiyaç duyarken, Z-Image-Turbo 8 adımlı bir örnekleyici etrafında agresif biçimde optimize edilmiştir. Bu, çıkarımı son derece hızlı tutarken fotorrealistik görseller ve güvenilir görsel üzeri metin sunar; böylece yalnızca offline toplu işler için değil, etkileşimli ürünler, panolar ve büyük ölçekli backend’ler için de güçlü bir seçenek haline gelir.

Neden bu kadar iyi görünüyor?

Yüksek hızda fotorrealistik çıktı — Ürün fotoğrafları, kahraman görselleri ve arayüz görselleri için, çok saniyelik beklemeler olmadan yüksek sadakatli, gerçekçi görseller üretir.
İki dilli prompt ve metin — İngilizce ve Çince prompt’ları anlar ve görselin içine doğrudan çok dilli metin yerleştirebilir; bu da çok pazarlı kampanyalar, posterler ve ekran görüntüleri için kullanışlıdır.
Düşük adım sayısıyla düşük gecikme — Görsel başına yalnızca 8 fonksiyon değerlendirmesi, sohbet botları, yapılandırma araçları, tasarım asistanları ve herhangi bir “tıkla → görsel” deneyimi için ideal, son derece düşük gecikme sunar.
VRAM dostu ayak izi — 16 GB VRAM’li ortamlarda iyi çalışır, donanım maliyetlerini düşürür ve yerel ya da edge dağıtımlarını daha gerçekçi kılar.
Toplu üretim için ölçeklenebilir — Verimliliği; kataloglar, sürekli görsel akışları veya otomatik oluşturulan küçük resimler gibi büyük işleri, hesaplama bütçesini aşmadan pratik hale getirir.
Yeniden üretilebilir çıktılar — Kontrol edilebilir tohum parametresi, önceki bir görseli yeniden üretmenize veya marka güvenliği ve denemeler için küçük, kontrollü varyasyonlar oluşturmanıza imkân tanır.

Nasıl kullanılır

promptprompt – sahneyi, stili ve görsel üzerindeki metni (İngilizce veya Çince) anlatan doğal dilde açıklama.
sizesize (genişlik / yükseklik) – çıktı çözünürlüğünü seçin; kare ve dikdörtgen görselleri, yüksek çözünürlüklere kadar (örneğin 1536 × 1536) destekler.
seedseed – rastgele sonuçlar için -1 olarak ayarlayın veya çıktıları yeniden üretilebilir kılmak için sabit bir tam sayı kullanın.

Z-Image-Edit Prompts