Referenzv1.0.0 Stabil

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.

https://zimageturbo.ai

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

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

HTTP Header

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.

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.

Antwort (JSON)

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

Antwortbeispiel

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

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, ultraschnelle Text-zu-Bild-Generierung

Z-Image-Turbo ist ein 6B-Parameter Text-zu-Bild-Modell von Tongyi-MAI, das für Produktionsumgebungen entwickelt wurde...

Ultraschnelle Generierung mit produktionsreifer Qualität

Während viele Diffusionsmodelle dutzende Schritte benötigen...

Warum sieht es so gut aus?

Fotorealistische Ausgabe — Hochwertige Bilder ohne lange Wartezeiten.
Zweisprachige Prompts — Versteht Englisch und Chinesisch...
Niedrige Latenz — Nur 8 Schritte pro Bild.
Geringer VRAM-Verbrauch — Funktioniert mit 16 GB VRAM.
Skaliert für Massenproduktion — Geeignet für große Bildmengen.
Reproduzierbare Ergebnisse — Mit Seed kontrollierbar.

So verwenden Sie es

promptprompt – natürliche Sprachbeschreibung...
sizesize – wählen Sie die Ausgabeauflösung.
seedseed – -1 für zufällig, oder fix für reproduzierbare Ergebnisse.

Z-Image-Edit Prompts