API Z-Image : 0,008 $ par image, résultats réels et code

Résumé en une phrase

• Z-Image est un modèle rapide de génération d'images à partir de texte lancé par Alibaba Tongyi. Sur HiAPI, l'id du modèle est z-image et le coût est de 0,008 $ par image : 8 $ pour 1 000 images.
• La requête ne contient que deux champs : prompt (1 000 caractères maximum) et aspect_ratio (1:1, 4:3, 3:4, 16:9, 9:16). Pas de taille, de résolution, de seed ni d'image en entrée.
• Il excelle dans la génération de visuels produits photoréalistes accompagnés de courts textes en anglais. Dans les quatre tests ci-dessous, chaque texte a été rendu correctement. Ouvrez la page du modèle Z-Image pour l'essayer ; les nouveaux comptes reçoivent 200 crédits gratuits.

Tarification

Nombre d'images	Coût avec z-image
1	0,008 $
100	0,80 $
600 (200 produits × 3 images)	4,80 $
1 000	8,00 $

Tarif HiAPI en temps réel, relevé le 20 octobre 2026. Prix unique pour tous les ratios d'aspect. Les tâches échouées ne sont pas facturées.

Comparaison avec les autres modèles à faible coût sur HiAPI :

Modèle	Par image	Texte sur l'image
flux-schnell/text-to-image	0,005 $	Pas son point fort
z-image	0,008 $	Courts textes en anglais, fiables dans nos tests
qwen-image-2.1-turbo	0,02 $	Prend en charge le chinois et l'anglais ; accepte aussi des images de référence
gpt-image-2/text-to-image	0,03 $ en résolution 1K	Très performant ; permet aussi d'éditer des images

Pour plus d'options (vidéo incluse), voir les API d'image et de vidéo les moins chères sur HiAPI.

Résultats réels : visuels produits avec du texte

Étiquette de prix (1:1)

Photo produit e-commerce en studio : une bouteille d'eau isotherme en acier inoxydable noir mat centrée sur un fond gris clair sans raccord, avec une ombre douce. Une carte en papier corail rectangulaire est appuyée contre la bouteille. La carte contient UNIQUEMENT ces deux lignes de texte sans-serif gras et net, aucun autre mot : "SUMMER SALE" sur la première ligne, "$19.99" sur la deuxième. Texte bien à plat face à l'objectif, en grand, parfaitement lisible. Photoréaliste.

Générer avec ce prompt →

z-image, 1:1, 1536×1536, 0,008 $.

Les deux lignes de texte sont correctes. La carte finit suspendue à la poignée de la bouteille au lieu d'être appuyée contre elle. La première version de ce prompt disait "reads exactly: SUMMER SALE on the first line and $19.99 on the second line", et le modèle a imprimé un mot supplémentaire "ON" entre les deux lignes. Placez le texte exact entre guillemets et les instructions en dehors des guillemets.

Bannière large (16:9)

Bannière promotionnelle e-commerce au format large, prise de vue à plat photoréaliste : des baskets blanches et un carton d'expédition en kraft sur un fond bleu pastel. Sur la droite, un texte sans-serif bleu marine gras avec exactement ces quatre mots et le montant, rien d'autre : "FREE SHIPPING OVER $50". Ces quatre mots doivent tous apparaître. Texte en grand, bien droit, parfaitement lisible. Éclairage de studio commercial propre.

Générer avec ce prompt →

z-image, 16:9, 1344×768, 0,008 $.

Carte pour réseaux sociaux (3:4)

Carte produit verticale pour réseaux sociaux : un petit flacon compte-gouttes en verre brun pour cosmétique posé sur un podium beige chaleureux, lumière du jour douce. Au-dessus du flacon, un titre en sans-serif moderne noir gras indique exactement : 30% OFF TODAY ONLY. Texte bien à plat face à l'objectif, en grand et parfaitement lisible. Style e-commerce premium minimaliste, photoréaliste.

Générer avec ce prompt →

z-image, 3:4, 928×1232, 0,008 $.

Le texte est correct, mais la pipette chevauche le mot "ONLY". Si le titre doit rester parfaitement lisible, précisez la position du produit ("in the lower half, below the text", c'est-à-dire dans la moitié inférieure, sous le texte).

Petit texte sur étiquette (3:4)

Photo produit e-commerce en macro : un flacon de soin en verre dépoli avec une étiquette blanche nette. Le texte de l'étiquette, imprimé dans une élégante police sans-serif sombre, indique exactement : GLOW SERUM sur la première ligne et VITAMIN C 10% sur la deuxième. Angle frontal, étiquette entièrement visible et nette, éclairage de studio doux, photoréaliste, fond blanc.

Générer avec ce prompt →

z-image, 3:4, 928×1232, 0,008 $.

Le petit texte sur une surface courbe est le plus difficile des quatre, mais le résultat est propre. Le modèle a réparti "VITAMIN C 10%" sur deux lignes.

Les règles pour obtenir un texte correct

1. Placez le texte exact entre guillemets.
2. Ajoutez "and no other words" (aucun autre mot), pour que le modèle n'invente pas de texte de badge supplémentaire.
3. Faites en sorte que le texte soit bien à plat face à l'objectif. Les textes inclinés ou courbés sont les premiers à devenir incorrects.
4. Ne placez qu'un ou deux blocs de texte par image. Les textes plus longs se composeront ensuite dans un outil de design.
5. Vérifiez chaque image avant publication. À 0,008 $, le coût d'une nouvelle génération est négligeable.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image",
    "input": {
      "prompt": "A cozy coffee shop at golden hour, a wooden A-frame sign on the sidewalk reading \"FRESH COFFEE\", warm window light, photorealistic",
      "aspect_ratio": "16:9"
    }
  }'

Vous recevez un taskId. Interrogez GET https://api.hiapi.ai/v1/tasks/{taskId} jusqu'à ce que data.status soit success, puis téléchargez data.output[0].url. Le statut passe successivement par queued, handling et archiving, puis devient success ou fail. Le lien expire environ 7 jours après la fin de la tâche.

Python : traitement par petits lots

# pip install requests；exécutez d'abord export HIAPI_KEY=your-key
import os, time, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def submit(prompt, ratio="1:1"):
    r = requests.post(API, json={"model": "z-image", "input": {"prompt": prompt, "aspect_ratio": ratio}},
                      headers=H, timeout=30).json()
    if r.get("code") != 200:
        raise RuntimeError(r)
    return r["data"]["taskId"]

def wait(task_id, timeout_s=300):
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] in ("success", "fail"):
            return d
        time.sleep(3)
    raise TimeoutError(task_id)

products = {"mug-sage": "sage green", "mug-navy": "navy blue", "mug-terracotta": "terracotta"}
tasks = {sku: submit(f'Studio photo of a {color} ceramic coffee mug on white, a small card reads "NEW"')
         for sku, color in products.items()}   # soumettre tout d'abord, puis collecter ensemble

for sku, task_id in tasks.items():
    d = wait(task_id)
    if d["status"] == "success":
        with open(f"{sku}.png", "wb") as f:
            f.write(requests.get(d["output"][0]["url"], timeout=120).content)
    else:
        print(sku, "failed:", d.get("error"))

Paramètres et erreurs

Champ	Obligatoire	Valeurs
prompt	Oui	1 000 caractères maximum
aspect_ratio	Non	1:1, 4:3, 3:4, 16:9, 9:16

Les cas suivants renvoient un HTTP 400 à la soumission, sans créer de tâche ni facturer :

• additional properties 'size' not allowed (ou resolution, width) : utilisez plutôt aspect_ratio.
• aspect_ratio: value must be one of ... : 21:9 et 4:5 ne sont pas pris en charge. Générez d'abord en 16:9 ou 3:4, puis recadrez.
• Utilisation d'un id de modèle comme z-image-turbo : le seul id disponible sur HiAPI est z-image.

Quand utiliser un autre modèle

• Besoin de modifier une image existante : Z-Image ne génère qu'à partir de texte. Utilisez un modèle image-vers-image, comme qwen-image-2.1-turbo (0,02 $) ou gpt-image-2/image-to-image.
• Texte long ou dense, ou beaucoup de chinois : essayez Qwen Image, conçu pour la composition bilingue.
• Prix le plus bas sans besoin de texte : flux-schnell/text-to-image à 0,005 $.

Questions fréquentes

Quel est l'id du modèle ?

z-image. Il n'existe pas d'id z-image-turbo séparé sur HiAPI ; Turbo est le nom de cette variante rapide en amont.

Comment obtenir une clé API ?

Inscrivez-vous sur hiapi.ai, créez une clé dans la console, puis envoyez-la avec Authorization: Bearer <key>. La même clé fonctionne pour tous les modèles.

Peut-il rendre du texte en chinois ?

Alibaba présente le texte bilingue comme un point fort. Les quatre tests ci-dessus sont tous en anglais ; avant de compter dessus, vérifiez donc le rendu en chinois avec vos propres prompts.

Y a-t-il un réglage de résolution ?

Non. La taille de sortie dépend du ratio d'aspect : dans les tests ci-dessus, 1:1 renvoie 1536×1536, 16:9 renvoie 1344×768 et 3:4 renvoie 928×1232.

Envie d'essayer un prompt sans écrire de code ? Ouvrez la page du modèle Z-Image.