Introduction
Qwen Image 2.1 Retouche d’image reprend de une à dix images sources d’après une consigne écrite et renvoie une seule image nouvelle. L’équipe Qwen d’Alibaba a ouvert les poids du modèle le 21 septembre 2026 ; ce point de terminaison est passé en ligne ici le jour même.
Il tourne sans filtre de contenu et sans indicateur de maturité. Lors de notre recette, il a mené une source sans censure au bout de nos consignes sans rhabiller le sujet, sans rien flouter et sans se replier sur une composition plus prudente — le mode de défaillance qui rend la plupart des points de terminaison de retouche inutilisables pour le travail sans censure.
Choisir un mode Qwen Image 2.1 selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| De une à dix images sources à retravailler | Qwen Image 2.1 Retouche d’image |
| Un brief écrit et rien d’autre | Qwen Image 2.1 Texte vers image |
| Des sources plus vos propres poids LoRA | Qwen Image 2.1 LoRA Retouche d’image |
Fonctionnalités et points forts
Dix références dans une seule requête
La plupart des points de terminaison de retouche prennent une source, ou trois. Celui-ci en lit jusqu’à dix, et c’est ce qui rend une série cohérente praticable : gardez l’image qui a établi le personnage, ajoutez la référence qui porte la tenue, ajoutez celle qui porte le lieu, et ne changez qu’une variable par lancement.
Une source reste telle que vous l’envoyez
Un point de terminaison de retouche qui rhabille discrètement son sujet est pire qu’un refus, parce qu’il vous facture la mauvaise image. Nous lui avons donné une source sans censure avec la consigne de la garder telle quelle et d’ajouter de nouveaux éléments ; il a renvoyé exactement cela, chaque élément nommé étant présent.
Chaque référence est tarifée, donc le devis suit la requête
Ajouter des sources fait monter le coût en droite ligne, et l’estimation affichée avant envoi est ce qui se règle. Une requête à dix sources vaut plusieurs fois une requête à une source au même palier — raison de plus pour envoyer les références qui travaillent et laisser les autres.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 5 000 caractères. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | De une à dix images de référence. 1 éléments minimum · 10 éléments maximum |
mask_url | Non | Image noir et blanc facultative qui fait passer la retouche en mode local : le blanc marque la zone à repeindre, le noir est conservé tel quel, et quelques pixels de bord adouci… |
aspect_ratio | Non | Compose le cadre avant la génération plutôt que de le recadrer ensuite : choisissez la forme à laquelle vous publierez. |
resolution | Non | Le palier qui fixe la taille de sortie et le prix : 1k est le défaut et le moins cher, 1.5k se situe entre les deux, 2k est le palier où la texture de la peau, les cheveux et le… |
enable_prompt_expansion | Non | Activé par défaut : avant la génération, le prompt est réécrit en une description de scène plus complète. Désactivez-le pour que votre formulation soit utilisée telle quelle. Valeur par défaut: |
background | Non | opaque par défaut. |
output_format | Non | JPEG par défaut. PNG quand l’image part dans une étape de composition, WebP quand elle est publiée directement sur une page. |
seed | Non | Stabilise un tirage pour qu’une série reste dans le même voisinage. |
Tarification
| Spécification | Prix |
|---|---|
| $0.036 / image |
| $0.048 / image |
| $0.072 / image |
Cas d’utilisation
Cohérence d’un personnage sur toute une série
Gardez une image validée comme référence d’identité et relancez-la avec une consigne différente par image. Bien plus stable que d’espérer qu’une seed reproduise un visage.
Composition de scènes à partir d’une figure existante
Partez d’une figure que vous avez déjà et ajoutez le deuxième sujet, la contrainte, le décor ou les marques. Les consignes sont exécutées telles qu’elles sont écrites.
Changements de tenue et de décor
Deux références — une pour la personne, une pour le vêtement ou la pièce — et un prompt qui dit laquelle est laquelle.
Monter en résolution une image gardée, sans perdre son contexte
Relancez une image 1k en retouche 2k avec une consigne qui préserve la composition, quand vous voulez le détail sans refaire toute la scène.
Guide de prompt et conseils pratiques
Nommez ce qu’apporte chaque référence
Le modèle ne déduit pas les rôles. « La première image est la femme, la deuxième est la pièce où elle se tient » : c’est la différence entre une retouche et un mélange.
Dites ce qui ne doit pas changer
Il n’y a pas de prompt négatif ici, les protections vont donc dans la consigne principale. « Garde-la exactement comme dans la source, n’ajoute rien à sa tenue » est la phrase qui empêche un modèle de retouche de couvrir un sujet qu’il juge devoir couvrir.
Envoyez moins de références, mais meilleures
L’identité tient bien à partir d’une source propre et se délite à mesure que les sources s’empilent. Comme chaque référence ajoute aussi au prix, moins est en général à la fois moins cher et plus net.
Regardez le devis, pas seulement le palier
Sur ce point de terminaison, le nombre de références fait bouger le prix autant que le palier de résolution. L’estimation affichée avant envoi fait foi : lisez-la avant d’envoyer une requête à dix sources.
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.1/edit",
"input": {
"aspect_ratio": "1:1",
"background": "opaque",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.
