Introduction
Qwen Image 2 Retouche d’image prend exactement une image de référence et une consigne, et renvoie un seul résultat retouché : rééclairé, restylé, rhabillé ou complété d’un lettrage, selon ce que décrit le prompt.
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 qui décrivent le résultat, pas la source. Dites ce qui doit rester identique et ce qui change ; tout ce qui n’est pas dit peut dériver. 1 caractères minimum · 800 caractères maximum |
image_urls | Oui | Exactement une URL jpeg, png ou webp accessible publiquement, pour une image dont vous détenez les droits. 1 éléments minimum · 1 éléments maximum |
aspect_ratio | Non | 1:1 par défaut, ou 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 et 21:9. La sortie ne suit pas la forme de la source : réglez le format de votre photo dès que ses proportions comptent. |
seed | Non | Omettez-la pour un tirage neuf à chaque appel ; fixez-la pour comparer deux formulations d’une même retouche sur un tirage identique. |
Tarification
$0.035 / image
Cas d’utilisation
Affiner un visuel fourni
Utilisez ce mode quand une photo existante doit fixer le sujet, la composition ou le style. Envoyez-la comme unique entrée de image_urls, dites ce qui change et ce qui doit rester identique, puis comparez le résultat à la source à sa taille d’utilisation.
Un produit mis en scène ailleurs
Envoyez la photo du produit et décrivez le décor où il doit se trouver, y compris la lumière qu’il doit recevoir. Un appel, une image. Si l’environnement doit venir d’une deuxième photo, utilisez un modèle de retouche qui accepte plusieurs références.
Production de campagne bilingue
Adaptez un visuel clé validé à un autre marché en demandant un lettrage sur une surface libre, écrit dans le prompt exactement comme il doit apparaître, en chinois ou en anglais. Restez sur une chaîne courte : les enseignes et les textes longs relèvent de la gamme Qwen Image 3.0.
Personnages et costumes
Gardez la personne d’une photo et décrivez le nouveau vêtement avec des mots, matière et brillance comprises. Réglez aspect_ratio sur la forme de la photo — la valeur par défaut est 1:1 — pour que le résultat ne devienne pas un carré que vous n’avez pas demandé.
Guide de prompt et conseils pratiques
Choisir le cadre avant d’écrire
La forme de sortie vient de aspect_ratio, pas de la source. La valeur par défaut est 1:1 et huit formats sont proposés, dont 3:2, 2:3 et 21:9 ; réglez celui qui correspond à votre photo avant d’écrire la consigne.
Consacrer les 800 caractères à une scène complète
Décrivez le résultat, pas la source. Dites d’abord ce qui doit rester identique, puis ce qui change, et consacrez le reste au nouveau décor et à la lumière : tout ce qui n’est pas précisé peut dériver.
Adapter l’exemple fourni
Partez de l’exemple publié et remplacez la direction créative en conservant le contrat d’entrée de ce mode.
Keep the woman and her satin robe from the image. Place her leaning on the bar of a narrow neon-lit cocktail lounge, and match the warm red lantern light onto her face and shoulders so it reads as one photograph.
Une remise en scène à une seule référence : la femme et le peignoir sont conservés, le bar au néon est décrit par des mots, et l’accord de la lumière est demandé explicitement. L’image doit venir de vous : l’URL ici est un exemple fictif, pas un fichier hébergé.
Vérifier le résultat avant d’itérer
Il n’y a pas de réglage d’intensité et une seule référence est acceptée : une deuxième est refusée avant que la requête ne quitte la plateforme. aspect_ratio vaut 1:1 par défaut et ne suit pas la source ; une photo en portrait revient donc carrée si vous ne réglez pas le format. Ce qui reste de la source dépend de la précision de votre consigne. Fixez seed pour comparer deux formulations de la même retouche sur un tirage identique.
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/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.
