Référencev1.0.0 Stable

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.

https://zimageturbo.ai

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

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

En-tête HTTP

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.

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.

Réponse (JSON)

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

Exemple de réponse

{
  "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 paramètres, génération texte-vers-image ultra rapide

Z-Image-Turbo est un modèle texte-à-image de 6B paramètres développé par Tongyi-MAI pour les environnements de production...

Génération ultra rapide avec qualité prête pour la production

Là où de nombreux modèles nécessitent des dizaines d'étapes...

Pourquoi une si bonne qualité ?

Sortie photoréaliste — Images haute fidélité sans attente prolongée.
Prompts bilingues — Comprend l’anglais et le chinois...
Faible latence — Seulement 8 étapes.
Faible utilisation VRAM — Fonctionne avec 16 Go de VRAM.
Échelle industrielle — Supporte des volumes importants.
Génération reproductible — Contrôlable avec la graine.

Comment l’utiliser

promptprompt – description en langage naturel.
sizesize – résolution de sortie.
seedseed – -1 pour aléatoire ou fixe pour reproduire.

Z-Image-Edit Prompts