Comment intégrer l'API Z Image Turbo : un guide de production pour la génération d'images à bas prix (0,0036 $/image)

Ce guide se veut objectif et axé sur l'implémentation. Vous apprendrez :

• Ce qu'est ZImage Turbo et ses principales capacités
• Comment fonctionne le point de terminaison ZImage d'EvoLink (tâches asynchrones + règles de webhook)
• Comment intégrer ZImage Turbo avec un contrôle des coûts et des garde-fous opérationnels
• Quand ZImage est le bon choix par défaut—et quand il ne l'est pas

1. Qu'est-ce que ZImage Turbo

• La génération d'images photoréalistes avec une haute fidélité visuelle
• Le rendu de texte bilingue (anglais et chinois) directement dans les images générées
• La vitesse d'inférence rapide adaptée à une production à haut volume
• Le respect des instructions pour des résultats cohérents et prévisibles

Exemple A de qualité visuelle ZImage Turbo	Exemple B de qualité visuelle ZImage Turbo

2. Contexte tarifaire de ZImage : comparaison avec les tableaux publiés

• Le catalogue de modèles d'EvoLink affiche ZImage Turbo « à partir de » 0,0036 $ par image et montre une référence de « marché » de 0,0050 $.
• EvoLink mentionne également un prix de ~0,0036 $/image dans son journal des modifications pour ZImage Turbo.
• La page de tarification de fal.ai présente plusieurs modèles d'image hébergés largement utilisés pour environ 0,03 $–0,04 $ par image (selon le modèle).
• fal.ai indique également le prix de Z-Image Turbo à 0,005 $/mégapixel (utile comme référence de marché pour ZImage lui-même).

Tableau de comparaison des coûts (hypothèses transparentes)

Hypothèse : « 10 000 images » signifie 10 000 résultats générés à environ 1 MP chacun (par exemple, 1024×1024 ≈ 1 MP). Confirmez toujours les règles de facturation pour votre forfait exact et vos tailles de sortie.

3. Fonctionnement de l'API ZImage Turbo d'EvoLink (asynchrone par conception)

1. Vous soumettez une requête de génération ZImage à POST /v1/images/generations
2. Vous recevez immédiatement un ID de tâche
3. Vous interrogez l'état de la tâche via GET /v1/tasks/{task_id} (ou utilisez un rappel webhook)

4. Démarrage rapide de ZImage Turbo (Copier/Coller)

4.1 Créer une tâche de génération ZImage

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <VOTRE_JETON>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "z-image-turbo",
  "prompt": "A clean product hero shot, studio lighting, soft shadow, minimal background, no watermark",
  "size": "1:1"
}
'

{
  "id": "task_abc123",
  "status": "pending",
  "model": "z-image-turbo",
  "progress": 0,
  "created": 1735100000,
  "task_info": {
    "can_cancel": true,
    "estimated_time": 10
  },
  "usage": {
    "credits_reserved": 1
  }
}

4.2 Interroger l'état de votre tâche ZImage

curl --request GET \
  --url https://api.evolink.ai/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <VOTRE_JETON>'

5. Paramètres de ZImage Turbo

• prompt : Requis, maximum 2000 caractères.
• size : Prend en charge les ratios (1:1, 16:9, etc.) ou les dimensions personnalisées (376x376 à 1536x1536).
• seed : Entier (1 - 2147483647) pour la reproductibilité.
• callback_url : URL HTTPS pour la notification asynchrone.

6. Webhooks ZImage : règles de rappel

• HTTPS uniquement : Aucune IP interne autorisée.
• Tentatives : Maximum 3 tentatives (1s, 2s, 4s).
• Format : Le corps du rappel correspond à la réponse de l'API d'interrogation de tâche.

7. Modèles de production pour ZImage

• Modèle A : Sélection de variantes : Générez 4 à 8 candidats à bas prix et choisissez le gagnant.
• Modèle B : Persistance précoce : Stockez immédiatement les sorties dans votre propre S3/OSS (les URL expirent après 24h).
• Modèle C : File d'attente de travail : Utilisez un agent (worker) découplé pour gérer l'interrogation d'état ou les webhooks.

8. Modèles de prompts ZImage

Modèle : Projet d'affiche bilingue

Prompt : Une mise en page d'affiche de vente élégante avec une typographie bilingue claire. Grand titre : « Winter Sale » et « 冬季大促 ». Sous-titre : « Up to 50% off » et « 最高立减50% ». Mise en page sur grille moderne, contraste élevé, sans-serif.

9. Matrice de décision

10. FAQ

• Architecture : Modèle 6B, architecture S3-DiT, 8 NFE pour Turbo.
• Rétention : Liens valides pendant 24 heures.
• Prix : À partir de 0,0036 $ sur EvoLink.ai.

Conclusion