Introduction
Qwen Image 2 Texte vers image transforme un brief écrit en une seule image. Les prompts sont lus nativement en chinois et en anglais : pas de paramètre de langue, pas d’étape de traduction. Changer de langue de travail en cours de projet ne change donc rien à la requête.
Qwen Image 2 est le modèle d’image généraliste d’Alibaba : des prompts de 800 caractères lus nativement en chinois ou en anglais, cinq formats en texte vers image et un point de terminaison de retouche qui retravaille une référence au format que vous choisissez. Une image par requête, avec un seed facultatif pour figer un tirage pendant que vous comparez.
Choisir un mode Qwen Image 2 selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| Une direction artistique ou un brief de design écrit | Qwen Image 2 Texte vers image |
| Une image source validée à retravailler | Qwen Image 2 Retouche d’image |
Fonctionnalités et points forts
Des prompts en deux langues
Qwen Image 2 lit directement les prompts en chinois et en anglais. Une équipe peut donc garder la langue dans laquelle le brief est le plus clair, sans le réécrire au moment de le transmettre.
Une modification écrite sur une image fournie
Le mode retouche part d’une image fournie et d’une consigne écrite. Choisissez ce point de départ quand l’identité ou la composition existent déjà et que la validation porte sur un changement voulu, pas sur un nouveau concept.
Deux points de départ bien distincts
Le texte vers image sert à poser une nouvelle scène à partir d’une direction artistique ; la retouche sert à retravailler un visuel existant. Choisir d’abord le matériau de départ évite de juger un brief de retouche comme une génération originale.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 800 caractères, en chinois ou en anglais, lus nativement sans indicateur de langue. 1 caractères minimum · 800 caractères maximum |
aspect_ratio | Non | Fixe les dimensions de sortie avant que la génération démarre : choisissez-le avant d’écrire le prompt — l’image est composée pour cette forme, pas recadrée dedans. |
seed | Non | Omettez-la pour un tirage neuf à chaque appel ; fixez-la pour garder le même tirage et ne changer qu’une chose à la fois. |
Tarification
$0.035 / image
Cas d’utilisation
Partir d’un brief écrit
Utilisez ce mode pour une scène, une illustration ou un concept produit qui n’a encore aucune image source. Choisissez d’abord le cadre — 1:1, 4:3, 3:4, 16:9 ou 9:16 —, décrivez ensuite le sujet, la composition et la lumière, puis comparez quelques tirages avant d’arrêter une direction.
Production de campagne bilingue
L’équipe créative rédige le brief en chinois, un partenaire à l’étranger itère en anglais, et personne ne réécrit le prompt. Le cadrage est fixé dès le départ avec aspect_ratio, si bien que chaque emplacement est généré à sa forme au lieu d’être découpé dans un carré.
Personnages et costumes
Accessoires de costume, accessoires de scène et décors de bar néon : des briefs où costume, accessoire et décor doivent arriver en un seul passage. Figez une graine dès qu'un personnage fonctionne, puis faites varier le décor et la tenue autour d'un visage stable.
Un produit mis en scène ailleurs
Tant qu’il n’existe aucune photo du produit, décrivez l’objet, sa matière et le décor où il se trouve, et traitez le résultat comme une image de concept, pas comme un relevé du produit réel. Dès qu’une photo produit est validée, envoyez-la au point de terminaison de retouche et remettez plutôt cette photo en scène.
Guide de prompt et conseils pratiques
Choisir le cadre avant d’écrire
aspect_ratio compose l’image au lieu de la recadrer ; la description doit donc coller au format choisi : un brief en 9:16 empile le sujet à la verticale, un brief en 16:9 peut étaler le décor en largeur.
Consacrer les 800 caractères à une scène complète
Sujet, tenue, décor, lumière, objectif : tout en un passage, dans l’une ou l’autre langue. La limite s’applique avant l’envoi de la requête, alors supprimez les adjectifs avant de rogner sur le décor. Laissez seed de côté tant que vous cherchez une direction ; quand une image vaut d’être gardée, fixez son seed et ne changez qu’un élément à la fois.
Adapter l’exemple fourni
Partez de l’exemple publié avec aspect_ratio : 1:1. Remplacez le sujet et la direction créative en conservant le contrat d’entrée de ce mode.
Photorealistic cinematic still of a real adult woman in a dim neon cocktail bar at night, wearing a loose chocolate satin robe slipping off one shoulder, and a large fluffy orange-and-white faux fox tail accessory clipped at the small of her back, curving up behind her hip. She leans on the bar and glances back over her shoulder at the camera with a teasing half-smile. Red paper lanterns overhead, a neon sign on the back wall reading 'MIDNIGHT FOX', bottles bokeh, 35mm film grain, warm amber and crimson light.
C’est la requête exacte derrière l’image publiée : un brief carré qui couvre la tenue, un accessoire queue, le décor du bar et la lumière des lanternes.
Vérifier le résultat avant d’itérer
800 caractères, c’est un plafond strict : un prompt plus long est refusé avant l’envoi. Mettez donc le budget dans le sujet, la tenue, la lumière et l’objectif plutôt que dans les adjectifs. Chaque requête renvoie une image ; il n’y a pas de champ de lot, explorer veut dire relancer l’appel. Le texte dans l’image n’est pas le point fort de ce modèle : pour les enseignes et les titres, passez à la gamme Qwen Image 3.0.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-2/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
