Qwen Image 2.0 Pro 摄影 produit e-commerce : workflow API hiapi

TL;DR

• De quoi s'agit-il : un véritable workflow de production e-commerce utilisant qwen-image-2.0-pro sur l'API hiapi — une visuel principal de produit, une bannière promotionnelle avec texte promotionnel rendu, et une grille de variantes, tous générés à partir des prompts et requêtes exacts présentés sur cette page.
• Pourquoi choisir le palier Pro pour le travail sur produit : des détails photoréalistes plus fins, un rendu de texte dans l'image plus fiable (du vrai texte promotionnel, pas des caractères illisibles) et une meilleure compréhension sémantique des prompts détaillés — au prix de 0,107 $/image, jusqu'à 2048×2048, contre 0,025 $/image pour le palier de base qwen-image-2.0 (tarifs).
• Faits API vérifiés : le schéma d'entrée accepte prompt et une chaîne size ("2048*2048", "2688*1536", "2368*1728", "1728*2368" ou "1536*2688") — pas de champ aspect_ratio, et uniquement de la génération texte-vers-image (pas de image_input / i2i).
• Workflow : soumettre une tâche par asset en parallèle via /v1/tasks, interroger chacune jusqu'à complétion, télécharger immédiatement output[0].url (elle expire), puis relire le texte rendu avant toute livraison de contenu.

Pourquoi choisir qwen-image-2.0-pro pour la photographie produit

Une fiche produit a généralement besoin de trois assets distincts, et ils doivent sembler issus de la même séance photo : un visuel principal propre pour la page de listing, une bannière promotionnelle avec du vrai texte promotionnel pour les campagnes marketing, et une grille de variantes pour les pages catalogue multi-SKU. C'est un périmètre plus large que le simple visuel principal, et c'est précisément là que le palier Pro justifie son surcoût par rapport à la version de base qwen-image-2.0 :

• Détails photoréalistes plus fins. Verre, métal brossé, pierre — ce type de détails en reflets spéculaires se lit comme une « vraie photo » plutôt qu'un « rendu » à la taille d'une vignette de catalogue.
• Rendu de texte plus fiable. Les bannières promotionnelles et les packagings nécessitent un texte précis intégré à l'image, correctement orthographié et avec un crénage propre. Le palier Pro est optimisé pour cela ; la bannière plus bas sur cette page en est un exemple non retouché.
• Meilleure compréhension sémantique. Les trois prompts de cette page sont longs et spécifiques en termes de surfaces, d'éclairage et de mise en page — le palier Pro a respecté toutes ces exigences, y compris les consignes « aucun texte » sur deux des trois images.

Le coût, c'est le prix : 0,107 $/image contre 0,025 $ pour le palier de base (tarifs vérifiés en direct, 2026-08). Pour un visuel principal unique, c'est une erreur d'arrondi. Pour un catalogue de plusieurs centaines de SKU, cela représente de l'argent réel — voir la comparaison Pro vs palier de base plus bas pour savoir comment répartir le travail entre les deux.

Configuration

Vous avez seulement besoin d'une clé API hiapi, rien d'autre — aucun SDK nécessaire :

export HIAPI_API_KEY="sk-..."

qwen-image-2.0-pro fonctionne via le point de terminaison de tâche asynchrone unifié : POST https://api.hiapi.ai/v1/tasks renvoie immédiatement un taskId, puis vous interrogez GET /v1/tasks/{taskId} jusqu'à ce qu'elle soit terminée.

Les trois assets nécessaires à chaque fiche produit

1. Visuel principal de produit

Image pour la page de listing : un seul produit, centré, sur fond propre, sans rien qui dispute l'attention. Prompt complet, exactement tel que soumis :

Studio product photograph of a single amber glass skincare dropper bottle with a blank matte white label, standing centered on a round travertine stone pedestal, seamless warm off-white studio background, soft diffused key light from the upper left, a subtle soft shadow falling to the right, hyper-detailed macro texture on the glass and brushed-metal dropper cap, photorealistic, catalog-ready e-commerce hero shot, no text, no logos, no props

2. Bannière promotionnelle avec texte rendu

C'est ici que le rendu de texte du palier Pro fait ses preuves. Le prompt demande deux lignes de texte promotionnel précis placées dans un coin spécifique — pas de texte de substitution, pas de « insérez votre texte ici » :

Flat-lay e-commerce promo banner photograph: three amber glass skincare dropper bottles arranged diagonally on a warm terracotta backdrop with dried eucalyptus sprigs, soft overhead studio lighting with gentle shadows, in the upper right corner bold clean white sans-serif text reading SUMMER GLOW SALE, directly beneath it smaller white text reading SAVE 20% TODAY, no other text anywhere, photorealistic commercial photography, sharp focus

Selon le manuel opérationnel de contenu hiapi, le texte rendu ne doit jamais être livré sans une relecture humaine — le rendu de texte par IA est fiable mais pas infaillible, et des caractères manquants ou des erreurs de crénage occasionnelles ne se révèlent qu'à la vérification. Cette bannière a été vérifiée caractère par caractère par rapport au prompt avant sa publication sur cette page.

3. Grille de variantes

Pour les pages catalogue listant chaque format ou chaque fragrance, une grille en flat-lay maintient chaque variante visuellement cohérente :

Overhead flat-lay product grid photograph of six amber glass skincare dropper bottles with blank matte white labels, arranged in two neat rows of three on a light grey seamless studio background, even soft diffused lighting with minimal shadows, consistent spacing between bottles, photorealistic catalog variant-grid layout, no text, no logos

Remarquez les étiquettes vierges sur ces trois images — les étiquettes spécifiques au SKU (nom de marque, fragrance, format) sont de petits textes sur de petites surfaces, une cible de rendu plus difficile qu'un titre de bannière. Le schéma pratique : générer les flacons avec des étiquettes vierges, puis composer le texte de l'étiquette en post-production. C'est aussi plus rapide à mettre à jour quand les prix promotionnels changent.

Le schéma d'entrée, vérifié contre l'API en direct

Le schéma /v1/tasks de qwen-image-2.0-pro est plus strict qu'il n'y paraît — pas de aspect_ratio, pas de n, et aucun champ d'entrée image du tout :

Champ	Type	Obligatoire	Valeurs
prompt	string	✅	Votre description de plan
size	string	✅	2048*2048, 2688*1536, 2368*1728, 1728*2368, 1536*2688
negative_prompt	string	optionnel	Ce qu'il faut exclure
seed	integer	optionnel	Pour la reproductibilité
watermark	boolean	optionnel
prompt_extend	boolean	optionnel	Laisse le modèle étendre les prompts courts

Deux points à noter pour quiconque porte une requête depuis un autre modèle d'image hiapi : il n'y a pas de paramètre aspect_ratio ici (utilisez directement size), et ce modèle est uniquement texte-vers-image — pas de champ d'image de référence, donc vous ne pouvez pas lui fournir une photo de votre produit réel et demander une variante. Le contrôle par le prompt est le seul levier. Voir le tutoriel API pour la structure complète requête/réponse et des exemples d'erreurs ; cette page se concentre sur les cas d'usage e-commerce.

Script de lot : trois assets, une boucle de soumission

Comme /v1/tasks est asynchrone, générer le visuel principal, la bannière et la grille revient à trois soumissions et trois interrogations — sans attente séquentielle :

import time
import requests

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

def submit(prompt: str, size: str) -> str:
    r = requests.post(API, headers=HEADERS, json={
        "model": "qwen-image-2.0-pro",
        "input": {"prompt": prompt, "size": size},
    }, timeout=60)
    task_id = (r.json().get("data") or {}).get("taskId")
    if not task_id:
        raise RuntimeError(f"submit failed: {r.text}")
    return task_id

def wait(task_id: str, timeout_s: int = 600) -> dict:
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        task = requests.get(f"{API}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
        if task["status"] == "success":
            return task
        if task["status"] == "fail":
            raise RuntimeError(f"task failed: {task.get('error')}")
        time.sleep(5)
    raise TimeoutError(task_id)

jobs = [
    ("hero-packshot", "Studio product photograph of ...", "2048*2048"),
    ("promo-banner",  "Flat-lay e-commerce promo banner ...", "2688*1536"),
    ("variant-grid",  "Overhead flat-lay product grid ...", "2368*1728"),
]

task_ids = {name: submit(prompt, size) for name, prompt, size in jobs}   # fan out
for name, task_id in task_ids.items():                                    # collect
    result = wait(task_id)
    url = result["output"][0]["url"]           # expires — download immediately
    open(f"{name}.png", "wb").write(requests.get(url, timeout=120).content)

Lors des tests, chaque rendu d'environ 2000px a pris environ une minute ; sous forte charge, prévoyez plusieurs minutes par image avant de considérer qu'il y a timeout.

Pro vs palier de base : lequel choisir

Les deux paliers partagent le même schéma prompt + size, donc passer de l'un à l'autre ne demande que de changer une ligne, le champ model :

	qwen-image-2.0 (base)	qwen-image-2.0-pro
Prix	0,025 $/image	0,107 $/image
Taille maximale	2048×2048	2048×2048
Rendu de texte	Bon	Plus fort — le choix par défaut pour le texte promotionnel
Détails photoréalistes	Bon	Plus fins — le choix par défaut pour les visuels principaux
Idéal pour	Exploration de prompts, brouillons en gros volume, rendus internes	Assets finaux visuel principal/bannière, tout contenu avec du texte rendu

Répartition pratique pour un vrai catalogue : esquisser les compositions sur le palier de base, où une itération coûte peu, puis re-rendre les gagnants sélectionnés sur le palier Pro pour les assets réellement livrés. Le workflow du palier de base — même API de tâche, même style de prompt — est décrit dans Générer des images produit e-commerce avec qwen-image-2.0.

Astuces de prompt pour photos produit

Ce qui a toujours fonctionné au fil de ces trois rendus :

• Précisez la surface et l'éclairage, pas seulement le sujet. « socle en travertin », « lumière principale diffuse douce venant du haut à gauche » contribuent davantage au photoréalisme que des adjectifs comme « professionnel » ou « haute qualité ».
• Déclarez « aucun texte, aucun logo » sur les images qui ne doivent pas en contenir. Sans cette précision, les prompts de photo produit laissent parfois des traces d'étiquette parasites ; une contrainte négative explicite garde l'image produit propre.
• Écrivez le texte exact de la bannière entre guillemets. « texte blanc sans-serif gras et propre lisant SUMMER GLOW SALE » se rend correctement ; un « du texte promotionnel » plus vague laisse la formulation au hasard.
• Demandez des étiquettes vierges sur le packaging, pas du texte de marque minuscule. Le texte sur petite surface est la cible de rendu la plus difficile pour tout modèle d'image — composez-le plutôt en post-production.

FAQ

Puis-je fournir une photo de mon produit réel à qwen-image-2.0-pro pour générer des variantes ? Non — ce modèle est uniquement texte-vers-image, et son schéma ne comporte aucun champ d'entrée image. Pour les workflows image-vers-image, il vous faut un autre modèle sur hiapi qui supporte explicitement l'i2i.

Le texte rendu est-il assez fiable pour être livré sans vérification ? Non — il est fiable, mais pas parfait. Relisez caractère par caractère par rapport au prompt avant publication, et régénérez en cas de rare erreur. Voir la note sous la bannière promotionnelle ci-dessus.

Quelles dimensions utiliser pour le visuel principal et la bannière d'une fiche ? Le carré 2048*2048 couvre les exigences de listing de la plupart des marketplaces. Pour les bannières promotionnelles larges ou les carrousels de visuels principaux, 2688*1536 ou 2368*1728 (paysage/portrait) se rapprochent davantage des ratios de bannière web courants, sans recadrage post-production.

Le palier Pro propose-t-il des remises sur volume ? Non — le prix est fixe à 0,107 $ par image, indépendamment du volume ; le levier de coût réside dans le nombre d'images que vous générez, pas dans un tarif dégressif.

Résumé

Pour les catalogues e-commerce, l'avantage de qwen-image-2.0-pro sur le palier de base tombe exactement là où la photographie produit en a besoin : des détails photoréalistes plus propres sur les visuels principaux, un rendu de texte fiable sur les bannières promotionnelles, le tout à un prix encore raisonnable de 0,107 $/image. Soumettez les requêtes visuel principal, bannière et grille de variantes en parallèle via /v1/tasks, relisez tout contenu avec du texte rendu avant livraison, et passez au palier de base lorsque vous itérez sur des compositions plutôt que de livrer des assets finaux. La page modèle qwen-image-2.0-pro propose les tarifs en direct et la référence des paramètres pour continuer à partir d'ici.