v1.0.0Kararlı

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.

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

HTTP başlığı

Authorization: Bearer {YOUR_API_KEY}

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

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.

{
  "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.

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "xxx",
      "size": "1024*1024",
      "seed": "-1"
    },
    "response": [
      "https://xxx.com/sample.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-parameter, ultra-fast text-to-image

Z-Image-Turbo is a 6B-parameter text-to-image model from Tongyi-MAI, engineered for production workloads where latency and throughput really matter. It uses only 8 sampling steps to render a full image, achieving sub-second latency on data-center GPUs and running comfortably on many 16 GB VRAM consumer cards.

Ultra-fast generation with production-ready quality

Where many diffusion models need dozens of steps, Z-Image-Turbo is aggressively optimised around an 8-step sampler. That keeps inference extremely fast while still delivering photorealistic images and reliable on-image text, making it a strong fit for interactive products, dashboards, and large-scale backends—not just offline batch jobs.

Why it looks so good?

• Photorealistic output at speed — Generates high-fidelity, realistic images that work for product photos, hero banners, and UI visuals without multi-second waits.
• Bilingual prompts and text — Understands prompts in English and Chinese, and can render multilingual text directly in the image—helpful for cross-market campaigns, posters, and screenshots.
• Low-latency, low-step design — Only 8 function evaluations per image deliver extremely low latency, ideal for chatbots, configuration tools, design assistants, and any “click → image” experience.
• Friendly VRAM footprint — Runs well in 16 GB VRAM environments, reducing hardware costs and making local or edge deployments more realistic.
• Scales for bulk generation — Its efficiency makes large jobs—catalogues, continuous feed images, or auto-generated thumbnails—practical without blowing up compute budgets.
• Reproducible generations — A controllable seed parameter lets you recreate a previous image or generate small, controlled variations for brand safety and experimentation.

How to use

prompt – natural-language description of the scene, style, and any on-image text (English or Chinese).
size (width / height) – choose the output resolution; supports square and rectangular images up to high resolutions (for example, 1536 × 1536).
seed – set to -1 for random results, or use a fixed integer to make outputs reproducible.