Générer des visuels produits e-commerce avec flux-2-klein-9b/text-to-image via l'API hiapi

La plupart des modèles texte-vers-image rapides et bon marché vous forcent à choisir : soit le texte de l'image est lisible, soit le prix est bas. flux-2-klein-9b/text-to-image fait partie des rares modèles de la catégorie « rapide et bon marché » qui ne vous oblige pas à trancher. hiapi lui attribue les étiquettes Text Rendering, High Fidelity (rendu de texte, haute fidélité) — et en pratique, cela signifie qu'il peut, dans une même génération, produire un logo de marque, une ligne de petites mentions et un gros titre promotionnel bien visible, sans avoir à relancer une seconde passe pour corriger des lettres illisibles.

C'est particulièrement important pour les visuels produits e-commerce : les images qui ont réellement besoin de texte — les visuels principaux avec étiquettes visibles, les bannières de promotion à durée limitée avec prix — sont justement celles que les modèles « rapides » bon marché ratent le plus souvent.

Dans cet article, les trois images ont toutes été générées avec flux-2-klein-9b/text-to-image, sans aucune nouvelle tentative : le texte des étiquettes, le gros titre promotionnel et la ligne d'information sur la remise étaient tous propres et corrects dès la première génération. Cela ne veut pas dire que chaque prompt offrira cette garantie (voir les conseils de relecture ci-dessous), mais pour un modèle de ce prix, c'est bon signe.

Tarifs : comparaison entre flux-2-klein-9b et flux-2-klein-4b (texte-vers-image)

Les deux modèles appartiennent à la famille « Klein » et misent tous deux sur la rapidité et le faible coût. La différence réside dans ce que vous payez :

Modèle	Prix par image	Étiquettes
flux-2-klein-9b/text-to-image	Forfait unique $0.00858	Text-to-Image, Text Rendering, High Fidelity
flux-2-klein-4b/text-to-image	Forfait unique $0.00143	Text-to-Image, Fast, Cost Efficient

(Prix constatés en 2026-08, vérifiés via /api/pricing.)

flux-2-klein-4b/text-to-image est environ 6 fois moins cher — un bon choix par défaut pour des arrière-plans, des scènes de vie, ou toute image où le texte ne participe pas à la composition. Mais il ne dispose pas de l'étiquette de rendu de texte ; donc si le texte sur une carte, une étiquette ou une bannière doit être réellement lisible, klein-9b reste le choix le plus sûr, même à un prix plus élevé. Et à moins d'un centime par image, ce « plus sûr » reste moins cher qu'un seul appel d'API à la plupart des LLM.

Une requête réelle

Voici une requête fonctionnelle adressée au point de terminaison /v1/tasks pour générer une carte promotionnelle avec texte rendu :

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "Bannière de promotion à durée limitée pour les réseaux sociaux e-commerce : un flacon compte-gouttes en verre dépoli, l'étiquette indique 'VELURA HYDRA SERUM', centré sur un fond dégradé doux allant du rose blush au crème, en haut un grand titre sans empattement, gras et soigné, indiquant 'FLASH SALE', lettres gris anthracite foncé, en dessous une ligne de texte plus petite indiquant '30% OFF', dans la même police, en bas à droite un badge en forme de rectangle arrondi à trait fin contenant le texte 'VELURA', typographie claire et lisible, espacement équilibré, design marketing moderne et minimaliste, aucun autre texte, aucun filigrane",
      "aspect_ratio": "1:1"
    }
  }'

Cette requête renvoie un taskId. Interrogez GET /v1/tasks/{taskId} jusqu'à ce que status passe à success, puis téléchargez output[0].url — le lien signé expire, il faut donc récupérer les octets immédiatement et les stocker vous-même.

Remarques sur le schéma : ce qui fonctionne réellement

Avant de développer sur ce modèle, quelques points méritent d'être connus, fondés sur ce que l'API accepte réellement (et pas seulement sur la documentation) :

• resolution est rejeté. Contrairement à certains autres modèles d'image hiapi, envoyer le champ resolution renvoie une 400 (additional properties not allowed). N'envoyez que aspect_ratio.
• aspect_ratio est une liste courte et fixe : 1:1, 4:3, 3:4, 16:9, 9:16. Pas de 4:5 ni de 21:9 — si votre mise en page veut un recadrage vertical plus haut, 3:4 est le ratio pris en charge le plus proche (c'est celui utilisé pour la scène de vie ci-dessous).
• aspect_ratio est lui-même facultatif. L'omettre complètement produit quand même une image valide, avec la valeur par défaut du serveur — mais en e-commerce vous voudrez presque toujours un format déterminé (carré pour un post de fil, 16:9 pour une bannière principale), il vaut donc mieux le définir explicitement plutôt que de dépendre du défaut.
• Tarification unique par image, sans paliers de résolution. Contrairement à flux-2-klein-4b/image-to-image (cinq paliers tarifaires selon les mégapixels), klein-9b/text-to-image applique un tarif unique quel que soit le ratio d'image.

Prompt + résultat : visuel principal

Prompt (16:9, utilisé tel quel, sans modification après génération) :

Visuel principal de produit e-commerce : un flacon compte-gouttes en verre dépoli rempli d'un sérum de soin haut de gamme posé sur une plaque de marbre gris humide, une douce lumière du jour venant de la gauche projette un reflet léger, fond beige minimaliste, fines gouttelettes d'eau sur le marbre, l'étiquette sur le flacon indique clairement 'VELURA', dans une police serif moderne et propre, en dessous un texte plus petit 'HYDRA SERUM', photographie produit professionnelle en studio, mise au point nette, léger rétroéclairage de contour, aucun autre texte, aucune main, aucun filigrane de logo

(L'image figure en haut de cet article.) Le nom de marque et la ligne de produit sont rendus proprement à une distance de lecture normale — pas de lettres doublées, pas de serif fondu, ces modes de défaillance courants des modèles texte-vers-image bon marché de cette gamme de prix.

Prompt + résultat : scène de vie

Prompt (3:4) :

Photo e-commerce de type scène de vie : un flacon compte-gouttes en verre dépoli dont l'étiquette indique 'VELURA HYDRA SERUM', posé sur un comptoir de salle de bain lumineux, à côté d'une serviette blanche pliée et d'un petit brin d'eucalyptus en pot, une chaude lumière matinale entre par la fenêtre, ombres douces, faible profondeur de champ, mise en scène naturelle et spontanée, le texte de l'étiquette 'VELURA' et 'HYDRA SERUM' reste net et lisible, aucune personne, aucune main, aucune superposition de texte supplémentaire

Une scène de vie comme celle-ci n'a généralement pas besoin de texte dans l'image — mais l'étiquette doit tout de même tenir le coup sous une lumière plus douce et plus diffuse que pour le visuel principal en studio, ce qui constitue un test plus difficile pour la fidélité du texte du modèle.

Prompt + résultat : carte de promotion à durée limitée

Prompt (1:1) :

Bannière de promotion à durée limitée pour les réseaux sociaux e-commerce : un flacon compte-gouttes en verre dépoli dont l'étiquette indique 'VELURA HYDRA SERUM', centré sur un fond dégradé doux allant du rose blush au crème, en haut un grand titre sans empattement, gras et soigné, indiquant 'FLASH SALE', lettres gris anthracite foncé, en dessous une ligne de texte plus petite indiquant '30% OFF', dans la même police, en bas à droite un badge en forme de rectangle arrondi à trait fin contenant le texte 'VELURA', typographie claire et lisible, espacement équilibré, design marketing moderne et minimaliste, aucun autre texte, aucun filigrane

C'est l'image qui met réellement à l'épreuve l'étiquette « Text Rendering, High Fidelity » du modèle : deux lignes de grand titre plus le texte d'un petit badge, tout en une seule génération. Chaque mot est correctement orthographié et l'interlettrage reste correct — mais c'est justement pour cela que vous devez quand même vérifier de vos yeux avant publication (voir ci-dessous).

Ne sautez pas la relecture

Le guide de contenu de hiapi le dit sans détour : le rendu de texte par IA, c'est « 99 %, pas 100 % ». Même un modèle étiqueté haute fidélité de texte se trompe parfois sur un mot, omet une lettre ou colle deux mots — c'est particulièrement vrai pour les petites mentions d'étiquette (le petit texte est plus difficile). Avant de publier une carte promotionnelle ou une étiquette produit générée :

1. Zoomez à 100 % et examinez chaque ligne de texte rendu.
2. Vérifiez l'orthographe et l'espacement, pas seulement que « ça ressemble à du texte ».
3. Si quelque chose ne va pas, régénérez — ne retouchez pas les pixels à la main, car une nouvelle passe ne coûte qu'une fraction de centime.
4. Pour les textes qui changent souvent (prix, dates de promotion), envisagez de les superposer à votre étape de gabarit plutôt que de les intégrer à chaque génération — la mise à jour coûte moins cher et élimine totalement le risque de régénération.

Génération par lots en Python

Pour un catalogue produit complet, enveloppez le même modèle de requête dans une boucle :

import requests
import time

API_KEY = "your-api-key"
BASE = "https://api.hiapi.ai/v1/tasks"

def generate(prompt, aspect_ratio="1:1"):
    resp = requests.post(
        BASE,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "flux-2-klein-9b/text-to-image",
            "input": {"prompt": prompt, "aspect_ratio": aspect_ratio},
        },
    )
    task_id = resp.json()["data"]["taskId"]

    while True:
        task = requests.get(
            f"{BASE}/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        ).json()["data"]
        if task["status"] == "success":
            return task["output"][0]["url"]
        if task["status"] == "fail":
            raise RuntimeError(task["error"])
        time.sleep(5)

prompts = [
    ("Hero shot for product SKU-001, studio lighting, label reads 'BRAND NAME'", "16:9"),
    ("Lifestyle shot for product SKU-001 on a wooden shelf", "3:4"),
    ("Flash sale card for product SKU-001, headline 'LIMITED TIME'", "1:1"),
]

for prompt, ratio in prompts:
    url = generate(prompt, ratio)
    print(url)  # download immediately — the URL expires

À $0.00858 par image, un catalogue de 50 SKU avec 3 images par SKU (visuel principal, scène de vie, visuel promotionnel) revient à environ $1.29 au total — une somme dérisoire comparée à une séance photo produit en freelance.

Comparaison de flux-2-klein-9b/text-to-image avec les workflows associés

Si vous construisez un pipeline complet de visuels produits sur hiapi, voici plusieurs sections connexes qui méritent une lecture :

• Si vous devez retoucher ou changer de style des photos produit existantes plutôt que générer à partir de zéro, consultez flux-2-klein-4b pour la retouche e-commerce image-vers-image — c'est une tâche différente (i2i, et non t2i), conçue pour retravailler de vraies photos plutôt que générer de nouvelles scènes.
• Pour les schémas de prompt propres au mode image-vers-image de la gamme 9b (même intensité de rendu de texte, appliquée à l'édition), consultez les prompts image-vers-image de flux-2-klein-9b.
• Paramètres complets, tarifs en temps réel et console pour tester vos prompts avant un lancement par lots : page du modèle flux-2-klein-9b/text-to-image.

FAQ

flux-2-klein-9b/text-to-image prend-il en charge l'image-vers-image ? Non — ce point de terminaison précis ne prend en charge que le texte-vers-image. hiapi liste séparément un modèle flux-2-klein-9b/image-to-image (tarif $0.03143/image) pour éditer des photos existantes.

Quels ratios d'image sont pris en charge ? Cinq : 1:1, 4:3, 3:4, 16:9, 9:16. Pas de 4:5 natif — utilisez 3:4 pour obtenir un recadrage vertical similaire.

Puis-je définir la résolution de sortie ? Non. Envoyer le champ resolution renvoie une 400. La tarification et les dimensions de sortie sont fixées selon le ratio d'image.

Passer à flux-2-klein-4b serait-il moins cher ? Oui, environ 6 fois moins cher par image ($0.00143 contre $0.00858) — mais klein-4b n'a pas d'étiquette de rendu de texte. Utilisez-le pour les images sans texte (scènes de vie pures ou arrière-plans), et réservez klein-9b à toute image comportant une étiquette, un titre ou une mention de prix.

Combien de temps prend une génération ? Les trois images de cet article, via le flux d'interrogation de /v1/tasks, ont chacune été terminées en moins de deux minutes.

Essayez

Vous pouvez tester flux-2-klein-9b/text-to-image directement sur la page du modèle avec vos propres prompts, puis passer aux tâches par lots ; et consulter les tarifs actuels à tout moment sur la page de tarification. Le schéma complet de requête/réponse et la configuration d'authentification figurent dans la documentation de l'API.