flux-2 pour les images produits e-commerce : guide pratique de l'API hiapi

En bref

• De quoi s'agit-il : un guide pratique pour générer des images produits e-commerce avec flux-2/text-to-image sur hiapi. Chaque image de cette page est générée à partir du prompt exact imprimé juste au-dessus — aucune démo empruntée — vous pouvez donc toutes les reproduire.
• Pourquoi flux-2 convient aux images produits : il mise sur le respect du prompt et la haute fidélité, exactement ce dont un catalogue a besoin — nombre précis d'articles, couleurs spécifiques, fond propre et sans raccord, étiquettes vierges (sans texte) sont strictement respectés.
• Faits sur le modèle (vérifiés sur l'API) : flux-2 fonctionne sur le point de terminaison de tâches asynchrone (/v1/tasks). input.resolution accepte un format en mégapixels — 0.5 MP, 1 MP, 2 MP ou 4 MP — et non 1K/2K. aspect_ratio est facultatif et accepte 1:1, 3:2, 16:9, etc.
• Tarification (par image) : 0.5 MP à 0,0375 $, 1 MP à 0,05 $, 2 MP à 0,075 $, 4 MP à 0,125 $. Consultez la tarification pour les prix en temps réel.
• Comment l'exécuter : envoyez une requête POST à l'API de tâches, interrogez jusqu'à ce que le statut soit success, puis téléchargez l'image depuis output[0].url (cette URL expire — enregistrez les octets immédiatement). Le script complet à copier-coller se trouve en fin d'article, avec une boucle par lots.

Pourquoi flux-2 convient à la photographie produit

La plupart des modèles texte-image savent dessiner une jolie tasse. Le problème en e-commerce n'est pas la « beauté », mais la précision. Une fiche produit exige la bonne couleur, le bon nombre d'articles, un fond propre avec de l'espace pour ajouter votre texte, et des étiquettes laissées vierges pour y placer votre véritable argumentaire plus tard. Quand le modèle improvise — un flacon en trop, un texte inventé sur l'étiquette, un fond blanc teinté — l'image n'est pas publiable.

flux-2 est étiqueté respect du prompt et haute fidélité, ce qui signifie en pratique qu'il tend à suivre littéralement le prompt. C'est précisément l'essentiel pour les images de catalogue : vous écrivez les contraintes, le modèle les respecte, au lieu de les « interpréter créativement ». Les recettes ci-dessous sont construites autour de cela — chacune repose sur une contrainte spécifique (nombre, couleur, disposition) pour que vous constatiez vous-même le respect.

Comment lire ces recettes

Chaque recette comporte trois parties : une ligne objectif, le prompt exact (à copier tel quel) et l'image qu'il génère. Chaque prompt a été écrit par mes soins et exécuté sur flux-2 via l'API de tâches réelle. Quelques habitudes qui fonctionnent systématiquement avec ce modèle :

• Précisez explicitement le fond. « Fond de studio gris clair sans raccord » vaut mieux que laisser faire le hasard, et rend l'image directement utilisable sur la page produit (PDP).
• Écrivez « sans texte, sans logo » quand vous voulez des étiquettes vierges. flux-2 le respecte, ce qui vous permet d'ajouter la vraie marque en aval.
• Donnez-lui des contraintes comptables et vérifiables. « Exactement trois flacons », « ambre à gauche, transparent au milieu, cyan à droite » — les instructions précises sont là où le respect du prompt fait la différence.
• Prévoyez de l'espace négatif dans le prompt (« beaucoup d'espace vide en haut pour le titre »), surtout si l'image doit être placée sous un texte superposé.

Recette 1 — Fond blanc propre

Objectif : l'image de fiche produit la plus basique — un produit, un fond sans raccord, des marges régulières, prête à être placée sur la page produit.

A single matte-white ceramic coffee mug centered on a seamless light-grey studio background, three-quarter front angle, empty and unbranded. Soft even top-light with one subtle rim highlight down the left edge, a soft grounded contact shadow beneath. Studio e-commerce packshot, perfectly centered, wide even margins on all sides, photoreal, high detail, no text, no logo.

Les marges et le centrage viennent directement du prompt — les demander explicitement rend le recadrage utilisable dans une grille de listing.

Recette 2 — Test de respect du prompt

Objectif : prouver que le modèle suit des instructions précises et comptables — c'est la raison même pour laquelle on choisit flux-2 pour le travail produit.

Product photo of exactly three glass spray bottles standing in a row on a white acrylic surface: the left bottle filled with pale amber liquid, the middle bottle filled with clear liquid, the right bottle filled with soft teal liquid. All three have matte-black fine-mist pump tops and blank labels with no writing. Even frontal studio light, soft reflections on the acrylic, seamless white background. Photoreal commercial product photography, sharp focus, no text anywhere in the image.

Comptez : trois flacons, pas quatre. De gauche à droite, les liquides sont ambre, transparent, cyan — dans le bon ordre. La pompe est noir mat. Les étiquettes sont vierges, on peut donc y ajouter un vrai texte plus tard. C'est la récompense — vous imposez, il respecte, l'image est directement utilisable.

Recette 3 — Image de style de vie / en situation

Objectif : placer le produit dans un contexte sans le noyer — l'image « en usage » qui côtoie le fond blanc sur une fiche produit.

Lifestyle e-commerce shot of a tan leather crossbody bag resting on a pale oak cafe table beside a folded newspaper and a cup of espresso, soft morning window light from the left, warm out-of-focus cafe interior in the background with creamy bokeh. The bag is the clear hero, sharp and well-lit, staged naturally but uncluttered. Photoreal, editorial product-in-use photography, warm neutral palette, shallow depth of field, no visible brand marks or text.

Désigner le héros (« le sac est clairement le héros, net ») et repousser tout le reste dans le flou permet de garder le produit lisible tout en racontant une histoire — l'équilibre même dont une image de style de vie a besoin.

Recette 4 — Ensemble d'angles multiples pour PDP

Objectif : une série d'angles pour la page produit — plusieurs vues cohérentes du même article, avec une lumière et des proportions assorties.

A clean product-detail-page angle set of one pair of low-top canvas sneakers in off-white, shown as three separate views arranged left to right on a seamless light-grey background: a straight side profile, a three-quarter front angle, and a top-down overhead view. Consistent soft studio lighting and identical scale across all three, even spacing, soft contact shadows. Catalog-grade e-commerce photography, photoreal, crisp, unbranded, no text or labels.

Exiger « une lumière cohérente et une échelle identique sur les trois vues » est ce qui fait ressembler l'ensemble au même produit, plutôt qu'à trois rendus disparates. Cela ne remplace pas un véritable studio 360°, mais c'est un moyen rapide de monter une mise en page PDP avant la vraie séance photo.

Exécuter flux-2 sur l'API de tâches

flux-2 utilise le protocole asynchrone de tâches de hiapi — vous créez une tâche, l'interrogez, puis téléchargez le résultat. Le seul point à ne pas rater : resolution est au format mégapixels. Envoyez "1 MP", pas "1K", sinon l'API renvoie 400 avec pour message que la valeur doit être l'une de 0.5 MP / 1 MP / 2 MP / 4 MP.

1. Créer la tâche

curl -s https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2/text-to-image",
    "input": {
      "prompt": "A single matte-white ceramic coffee mug centered on a seamless light-grey studio background, three-quarter front angle, soft even top-light, photoreal e-commerce packshot, no text, no logo",
      "aspect_ratio": "1:1",
      "resolution": "1 MP"
    }
  }'
# -> {"code":200,"data":{"taskId":"tk-hiapi-..."},"message":"success"}

2. Interroger jusqu'à la fin, puis télécharger

import os, time, requests

TOKEN = os.environ["HIAPI_TOKEN"]
BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {TOKEN}"}


def generate(prompt, aspect_ratio="1:1", resolution="1 MP"):
    # create
    r = requests.post(BASE, headers=HEADERS, json={
        "model": "flux-2/text-to-image",
        "input": {"prompt": prompt, "aspect_ratio": aspect_ratio, "resolution": resolution},
    }).json()
    task_id = r["data"]["taskId"]

    # poll (a single image usually lands well under two minutes)
    deadline = time.time() + 600
    while time.time() < deadline:
        task = requests.get(f"{BASE}/{task_id}", headers=HEADERS).json()["data"]
        if task["status"] == "success":
            # output[0].url is a temporary link — download the bytes now
            url = task["output"][0]["url"]
            return requests.get(url, timeout=120).content
        if task["status"] == "fail":
            raise RuntimeError(task.get("error"))
        time.sleep(5)
    raise TimeoutError(task_id)


img = generate("A single matte-white ceramic coffee mug on a seamless light-grey background, photoreal e-commerce packshot, no text")
open("mug.jpg", "wb").write(img)

L'URL dans output[0].url porte un horodatage expireAt — c'est un lien de courte durée. Téléchargez les octets immédiatement et poussez-les vers votre propre stockage ; ne créez pas de lien direct vers une fiche produit en ligne.

Générer tout le catalogue par lots

Pour une vraie boutique, vous ne faites pas une seule image — vous en faites une par SKU. Maintenez une liste de prompts, réutilisez la fonction generate() ci-dessus et enregistrez chaque résultat sous le nom de son SKU :

catalog = {
    "SKU-1001": "A single matte-white ceramic coffee mug on a seamless light-grey studio background, three-quarter angle, soft even top-light, photoreal e-commerce packshot, no text, no logo",
    "SKU-1002": "A tan leather crossbody bag on a seamless light-grey studio background, front-on, soft studio light, grounded contact shadow, photoreal packshot, no visible brand marks",
    "SKU-1003": "A pair of off-white low-top canvas sneakers, side profile, seamless light-grey background, crisp catalog lighting, photoreal, unbranded, no text",
}

for sku, prompt in catalog.items():
    img = generate(prompt, aspect_ratio="1:1", resolution="1 MP")
    open(f"{sku}.jpg", "wb").write(img)
    print(f"{sku} done")

Avant de monter en charge, quelques points utiles à connaître :

• La résolution détermine le coût. À 1 MP, comptez 0,05 $ par image ; ne passez à 2 MP (0,075 $) ou 4 MP (0,125 $) que pour les images phares où le détail supplémentaire le justifie. Un catalogue de 200 SKU coûte environ 10 $ en 1 MP. Consultez la tarification pour les chiffres actuels avant de budgéter.
• Exécutez les tâches en parallèle. Chaque SKU est une tâche indépendante — créez plusieurs tâches, puis interrogez-les en parallèle plutôt qu'une par une ; les gros lots se terminent ainsi en très peu de temps réel.
• Gardez une clause de « style » cohérente. Remarquez la queue partagée par chaque prompt ci-dessus (« fond de studio gris clair sans raccord… packshot photoréaliste, sans texte »). Verrouillez cette formulation pour qu'une série d'images ressemble à un catalogue, et non à un assemblage hétéroclite.

À retenir

• L'avantage de flux-2 sur le travail produit est qu'il exécute littéralement ce que vous demandez — nombre exact, couleur exacte, étiquettes vierges — alors écrivez explicitement les contraintes pour qu'il les respecte.
• Précisez toujours le fond dans le prompt et prévoyez de l'espace négatif ; cela rend les rendus directement utilisables sur une fiche produit.
• Sur l'API de tâches, envoyez resolution en mégapixels (1 MP), interrogez /v1/tasks/{id} jusqu'à success, et téléchargez avant l'expiration de output[0].url.
• Le prix augmente avec la résolution — 1 MP pour les lots de catalogue, 2 MP/4 MP réservés aux images phares.

Prêt à essayer ? Obtenez une clé, pointez model vers flux-2/text-to-image, et consultez les tarifs en temps réel sur la page de tarification avant de générer votre catalogue par lots.