Générer des images produits e-commerce avec seedream-5.0-lite/image-to-image via hiapi

La photographie produit pour une boutique en ligne consiste rarement à générer une simple jolie image. Il faut générer encore et encore le même produit : visuel catalogue sur fond blanc, scène lifestyle, correction de quincaillerie ou d'étiquette après un changement de fournisseur, et la série de cinq coloris pour la page produit. Les modèles texte-vers-image échouent ici, car chaque nouveau prompt invente un produit légèrement différent.

C'est là que seedream-5.0-lite/image-to-image entre en jeu. C'est l'éditeur d'images guidé par instructions de ByteDance : vous fournissez une vraie photo de produit (ou jusqu'à 14 images de référence), vous décrivez la modification en langage naturel, et il suit l'instruction tout en préservant la cohérence des zones non modifiées. Sur hiapi, la résolution 2K coûte seulement 0,035 $ par image — une série complète de six visuels catalogue revient à environ 0,21 $.

Tout ce qui suit a été généré par de véritables appels API sur hiapi. Chaque section montre la sortie réelle et le prompt exact.

Le workflow : un ancrage, plusieurs éditions

Le schéma qui rend les images produits IA exploitables en production est ancrer puis éditer :

1. Ancrer — obtenir une image produit propre et standard. Photographiez le vrai produit, ou générez une fois un visuel conceptuel avec seedream-5.0-lite/text-to-image (également 0,035 $).
2. Éditer — alimentez image-to-image avec cette image d'ancrage pour produire chaque déclinaison : remplacement du fond, corrections de détails, coloris. L'identité du produit vient des pixels de référence, pas du prompt, donc c'est le même sac sur chaque image.

Voici notre image d'ancrage — un sac week-end en toile, généré une seule fois avec le modèle frère t2i, et utilisé comme référence pour toutes les éditions suivantes :

Structure de la requête

seedream-5.0-lite/image-to-image s'exécute sur le point de terminaison de tâches asynchrones de hiapi : soumettez à POST /v1/tasks, interrogez l'ID de tâche jusqu'à l'achèvement, puis téléchargez l'URL de sortie. Quatre champs d'entrée, tous obligatoires :

Champ	Type	Description
prompt	string	Instruction d'édition
image_urls	array	1 à 14 URL d'images de référence accessibles publiquement
aspect_ratio	enum	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
resolution	enum	Uniquement 2K ou 4K — ce modèle n'a pas de palier 1K

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/image-to-image",
    "input": {
      "prompt": "Replace the white studio background: place the bag on a weathered wooden bench in a sunlit modern loft. Keep the bag itself completely unchanged.",
      "image_urls": ["https://your-cdn.com/products/weekender-anchor.jpg"],
      "aspect_ratio": "3:2",
      "resolution": "2K"
    }
  }'

La réponse contient data.taskId. Interrogez GET /v1/tasks/{taskId} jusqu'à ce que status passe à success, puis téléchargez immédiatement output[0].url — les liens de sortie expirent, donc copiez le fichier dans votre propre stockage. Lors de nos tests, chaque édition s'est terminée en environ 60 à 120 secondes.

Mode d'édition 1 : recomposer l'arrière-plan (visuel catalogue → lifestyle)

L'édition la plus fréquente en e-commerce : même produit, nouveau décor. L'astuce de prompt clé consiste à consacrer l'essentiel du texte à ce qui ne doit pas changer, puis à décrire le nouvel environnement :

Gardez ce sac week-end en toile orange brûlé absolument inchangé — même forme, même couleur, mêmes poignées, mêmes coutures, avec bordures en cuir marron foncé et fermetures éclair en laiton. Remplacez le fond de studio blanc : placez le sac sur un banc en bois patiné dans un loft moderne baigné de soleil, une douce lumière matinale entrant par de grandes fenêtres, des plantes vertes floues en arrière-plan, une ombre de contact naturelle sur le banc, style photographie lifestyle chaleureuse de magazine.

Comparez avec l'image d'ancrage : les bordures, le patch en cuir aux coutures croisées, les tirettes de fermeture et les proportions sont conservés. L'ombre de contact tombe sur les lattes de bois — ce détail d'ancrage au sol est précisément ce qui fait paraître une recomposition comme une vraie prise de vue plutôt qu'un montage.

Mode d'édition 2 : correction précise de détails (changement de quincaillerie)

L'étiquette « édition précise » de Seedream Lite signifie des modifications chirurgicales. Imaginons que le fournisseur passe de la quincaillerie en laiton à une quincaillerie noir mat, et que vous ne vouliez pas reshooter. Demandez un seul changement et gelez tout le reste :

Gardez ce sac week-end en toile orange brûlé exactement tel quel — même fond blanc, même composition, même éclairage, même grain de toile et mêmes bordures en cuir marron. Changez uniquement la quincaillerie métallique : remplacez toutes les fermetures éclair, boucles et attaches en laiton par une quincaillerie métallique noir mat. Ne touchez à rien d'autre.

Les fermetures éclair, les anneaux en D et les boucles de sangle deviennent tous noirs ; le grain de la toile et la composition restent intacts. Ce type d'édition, régénéré via texte-vers-image, redessinerait insidieusement tout le sac.

Mode d'édition 3 : la série de coloris

Une page produit exige que chaque variante de couleur soit photographiée de la même façon. Recolorisez l'image d'ancrage tout en figeant le design, les bordures et la composition :

Gardez le design de ce sac week-end absolument inchangé — même forme, mêmes bordures et poignées en cuir marron, même quincaillerie en laiton, même fond de studio blanc, même éclairage et même composition. Changez uniquement la couleur du corps en toile, de l'orange brûlé vers un vert forêt profond, en préservant le grain du tissu et les coutures.

Répétez avec « bleu marine », « gris anthracite », « beige sable », et vous obtenez en une seule séance photo la série de cinq SKU pour 0,175 $ — la composition est identique pour chaque variante, ce qui donne ce rendu harmonieux au sélecteur de couleurs de la page produit.

Générer toute la série de visuels catalogue par lots en Python

En production, vous ne soumettez pas une seule édition à la fois. L'API de tâches se parallélise proprement — soumettez toutes les éditions d'un coup, puis interrogez. Voici le schéma que nous avons utilisé (trois éditions terminées en parallèle en moins de trois minutes) :

import json, time, requests, concurrent.futures

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_HIAPI_KEY", "Content-Type": "application/json"}
ANCHOR = "https://your-cdn.com/products/weekender-anchor.jpg"

EDITS = [
    ("lifestyle", "3:2", "Keep this exact bag unchanged... place it on a weathered wooden bench in a sunlit loft..."),
    ("hardware-black", "1:1", "Change only the metal hardware to matte black. Do not alter anything else."),
    ("colorway-green", "1:1", "Change only the canvas body color to deep forest green, preserving texture and trim."),
]

def run_edit(name, aspect_ratio, prompt):
    task = requests.post(API, headers=HEADERS, json={
        "model": "seedream-5.0-lite/image-to-image",
        "input": {"prompt": prompt, "image_urls": [ANCHOR],
                  "aspect_ratio": aspect_ratio, "resolution": "2K"},
    }).json()
    task_id = task["data"]["taskId"]
    while True:
        d = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
        if d["status"] == "success":
            img = requests.get(d["output"][0]["url"]).content   # expires — save it now
            open(f"{name}.jpg", "wb").write(img)
            return name, len(img)
        if d["status"] == "fail":
            raise RuntimeError(f"{name}: {d.get('error')}")
        time.sleep(5)

with concurrent.futures.ThreadPoolExecutor(max_workers=3) as ex:
    for name, size in ex.map(lambda e: run_edit(*e), EDITS):
        print(f"{name}: {size} bytes")

Trois conseils pratiques après avoir exécuté ce code :

• image_urls doit être accessible publiquement. Téléchargez d'abord l'image d'ancrage sur votre CDN ou votre stockage objet ; l'API valide jusqu'à 14 URL par requête.
• Enregistrez la sortie immédiatement. output[0].url est un lien à durée limitée. Copiez les octets dans votre propre bucket avant toute autre chose.
• Utilisez plusieurs images de référence si nécessaire. Fournir plusieurs références (vues avant/arrière/détail du même produit, ou produit plus référence de style) donne davantage de signaux d'identité pour les objets délicats comme les tissus à motifs.

Coût et quand choisir ce modèle

À 0,035 $ par image 2K, un ensemble réaliste par SKU — une image d'ancrage, une recomposition lifestyle, une correction de détail, trois coloris — soit six images, revient à 0,21 $. Consultez la page tarifaire hiapi pour les tarifs les plus récents de chaque palier.

Si vous hésitez entre éditeurs : notre comparatif image-to-image de trois modèles exécute les mêmes éditions sur les principaux concurrents, et le guide e-commerce Nano-Banana présente une autre stack d'ancrage et de recomposition. L'avantage de Seedream 5.0 Lite dans ce workflow réside dans la précision du suivi d'instructions, l'entrée multi-références à 14 emplacements, et un tarif bas et uniforme qui rend le traitement par lots de chaque SKU négligeable en coût.

Pour commencer

Obtenez une clé API, téléchargez une image produit propre, puis exécutez le prompt de recomposition lifestyle ci-dessus sur seedream-5.0-lite/image-to-image — vous obtenez votre première série de visuels dérivés en quelques minutes. La référence complète du point de terminaison de tâches se trouve dans la documentation hiapi.