v1.0.0Stable

Z Image Turbo API

Intégrez des capacités performantes de génération d’images par IA. Cette documentation fournit une référence API complète, des guides d'intégration et des exemples de code pour aider les développeurs à créer rapidement des applications d’images IA.

Démarrage rapide

Réalisez votre premier appel API en deux étapes : soumettre une tâche, puis interroger son statut.

Soumettre une tâche

Envoyez une requête POST au point de génération pour obtenir un ID de tâche.

Interroger le statut

Utilisez l’ID de tâche pour vérifier la progression jusqu'à obtenir l’URL de l’image.

Authentification

En-tête HTTP

Authorization: Bearer {YOUR_API_KEY}

Remarque : Gardez votre clé API sécurisée et ne l'exposez pas dans du code côté client.

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.

Paramètres du corps

Nom du paramètre	Type	Requis	Description
prompt	string	Oui	Text prompt for generation (max 1000 characters).
aspect_ratio	string	Oui	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

Interroger l'état et le résultat d’une tâche.

Paramètres de requête

Nom du paramètre	Requis	Description
task_id	Oui	L’ID renvoyé lors de la soumission.

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

Facturation

Coût par génération

$0.02 / requête

Les tâches échouées ne sont pas facturées.

Gestion des erreurs

401 Non autoriséClé API invalide
402 Paiement requisSolde insuffisant
429 Trop de requêtesLimite de requêtes atteinte

À propos de Z Image Turbo

Z Image Turbo est un moteur de génération optimisé sur les derniers modèles de diffusion, augmentant la vitesse d’inférence à 300% des modèles traditionnels tout en maintenant une qualité élevée.

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.