v1.0.0Stabil

Z Image Turbo API

Integrieren Sie leistungsstarke KI-Bildgenerierungsfunktionen. Diese Dokumentation bietet vollständige API-Referenzen, Integrationsanleitungen und Codebeispiele, um Entwicklern die schnelle Erstellung von KI-Bildanwendungen zu ermöglichen.

Schnellstart

Führen Sie Ihren ersten API-Aufruf in zwei Schritten aus: Aufgabe einreichen und Status abfragen.

Aufgabe einreichen

Senden Sie eine POST-Anfrage an den Generate-Endpunkt, um eine Task ID zu erhalten.

Status abfragen

Verwenden Sie die Task ID, um den Fortschritt zu überprüfen, bis die Bild-URL verfügbar ist.

Authentifizierung

HTTP Header

Authorization: Bearer {YOUR_API_KEY}

Hinweis: Bitte halten Sie Ihren API-Schlüssel sicher und veröffentlichen Sie ihn nicht im Client-Code.

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.

Body-Parameter

Parametername	Typ	Erforderlich	Beschreibung
prompt	string	Ja	Text prompt for generation (max 1000 characters).
aspect_ratio	string	Ja	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

Abfrage des Ausführungsstatus und Ergebnisses einer Aufgabe.

Query-Parameter

Parametername	Erforderlich	Beschreibung
task_id	Ja	Die beim Einreichen der Aufgabe zurückgegebene ID.

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

Abrechnung

Kosten pro Generierung

$0.02 / Anfrage

Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehlerbehandlung

401 UnbefugtUngültiger API-Schlüssel
402 Zahlung erforderlichUnzureichendes Guthaben
429 Zu viele AnfragenAnfragelimit erreicht

Über Z Image Turbo

Z Image Turbo ist eine auf den neuesten Diffusionsmodellen optimierte Generation Engine. Es erhöht die Inferenzgeschwindigkeit auf 300 % herkömmlicher Modelle bei gleichzeitig hoher Bildtreue.

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.