Introduction
Ce que fait cet endpoint
Qwen Image 2.1 Turbo Retouche d’image reprend vos images sources d’après une consigne écrite et renvoie de une à six nouvelles images, grâce au checkpoint à 8 pas de Qwen Image 2.1 d’Alibaba. Nos retouches ont pris de 26 à 59 secondes de bout en bout.
Entrées
image_urls porte de une à dix références, dans l’ordre où vous les appelez Image 1, Image 2, et ainsi de suite. prompt est la consigne. Omettez aspect_ratio pour garder la forme de la source à environ 2K, ou réglez-le avec resolution pour une taille fixe. num_outputs demande de un à six résultats, enable_prompt_expansion (désactivée par défaut) et enable_thinking pilotent la réécriture d’Alibaba, et seed stabilise une série.
Contenu
Aucun filtre côté plateforme. Expansion désactivée, les retouches qui changent des vêtements ou dévoilent davantage sont revenues comme demandé ; activée, la même consigne est revenue inchangée.
| Champ | Valeur |
|---|---|
| Entrée | Image |
| Sortie | Image |
| Statut sur SpicyAPI | En ligne : texte vers image et retouche d’image |
| Construit sur | Qwen Image 2.1, en tant que checkpoint accéléré à 8 pas du même modèle 7B |
| Images par requête | 1 à 6, facturées à l’image renvoyée |
| Prix | Un prix unique par image en 1k, 1.5k et 2k ; le devis en direct est sur cette page |
| Formats d’image | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Tailles en 2K | 1:1 2048 × 2048, 16:9 2688 × 1536, 9:16 1536 × 2688, 4:3 2368 × 1760, 3:2 2496 × 1664, 2:3 1664 × 2496 |
| Retouche | 1 à 10 images de référence ; sans format d’image, la sortie suit la source à environ 2K |
| Prompt | Jusqu’à 5 000 caractères ; pas de prompt négatif : écrivez les exclusions dans le prompt |
| Expansion de prompt | Désactivée par défaut ; réécriture direct ou agent quand elle est activée, avec une passe de réflexion facultative |
| Attente mesurée | 13 à 39 secondes en texte vers image, 26 à 59 secondes en retouche, sur l’ensemble de nos essais |
| Politique de contenu | Sans censure : aucun filtre côté plateforme, aucun indicateur de maturité |
| Poids ouverts | Qwen/Qwen-Image-2.1-Turbo sous la Qwen Research License Agreement |
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | La consigne de retouche, jusqu’à 5 000 caractères. Dites d’abord ce qui change, puis ce qui doit rester : visage, cheveux, pose, lumière. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | De une à dix images sources, dans l’ordre où vous les désignez. Le nombre de références ne change pas le prix. 1 éléments minimum · 10 éléments maximum |
aspect_ratio | Non | Omettez-le et le résultat garde la forme de votre source à environ 2K. |
resolution | Non | 1k, 1.5k ou 2k, utilisé uniquement quand vous réglez un format d’image. Chaque palier coûte le même prix par image. |
num_outputs | Non | De un à six résultats à partir de la même consigne dans une seule requête. Chaque image renvoyée est facturée. |
enable_prompt_expansion | Non | Désactivée par défaut. Valeur par défaut: |
enable_thinking | Non | Consacre un raisonnement supplémentaire à la réécriture, au prix d’une attente plus longue. Ne fonctionne que si l’expansion de prompt est activée. Valeur par défaut: |
seed | Non | Stabilise un tirage pour comparer un changement à la fois. Cela ne garantit pas une image identique au pixel près. |
Tarification
$0.014 / image
Cas d’utilisation
Travail d’image sans censure
SpicyAPI ne place aucun filtre de contenu devant Turbo. Expansion de prompt désactivée, nos tests sont sortis tels qu'écrits à chaque niveau de contenu que nous lançons, de Léger à Maximum, pour les femmes comme pour les hommes. Au niveau Très fort, un essai sur deux est passé ; l'autre s'est arrêté avant la fin de la requête.
Beaucoup de brouillons avant la bonne image
Huit pas et jusqu’à six images par appel offrent un large éventail pour pas cher. Explorez tenue, pose et lumière en une seule requête, gardez le cadre qui fonctionne et consacrez vos retouches à celui-là.
Un personnage sur toute une série
Générez un personnage, puis renvoyez l’image comme référence et changez la robe, la pièce ou la lumière en passes séparées. Chaque retouche part de votre image validée plutôt que d’un nouveau tirage : le visage se retrouve donc d’une image à l’autre.
Des couples à partir de deux portraits
Envoyez deux portraits comme Image 1 et Image 2 et décrivez la scène qu’ils partagent. Dans notre test, un homme et une femme photographiés séparément se sont retrouvés à rire côte à côte sur un toit au crépuscule, tous deux toujours reconnaissables.
Affiches et typographie
Turbo compose proprement les titres courts. Mettez les mots entre guillemets, dites où ils se placent et décrivez le style de l’affiche : notre affiche de cabaret est revenue avec les deux lignes orthographiées exactement.
Visuels produit et couvertures
Un prix unique jusqu’en 2K et six images par appel conviennent aux miniatures, aux couvertures et aux visuels produit, quand vous voulez plusieurs cadrages d’une même idée et un master pleine taille à recadrer.
Guide de prompt et conseils pratiques
Laissez l’expansion de prompt désactivée pour le travail adulte
L'expansion transmet votre prompt au réécrivain d'Alibaba avant que l'image ne soit dessinée, et le réécrivain adoucit les briefs non filtrés : dans nos tests, il a adouci une image de niveau Fort, transformé une scène de niveau Très fort en une scène seulement suggérée, et renvoyé une modification qui demandait d'aller plus loin sans rien changer. Expansion désactivée, les mêmes prompts sont revenus tels qu’écrits. Elle est désactivée par défaut ici ; gardez-la ainsi, sauf si vous voulez la réécriture.
Activez-la pour les prompts courts du quotidien
Un brief de six mots donne une scène plus fournie quand l’expansion est activée. direct réécrit en une seule passe et convient à la plupart des prompts ; agent réécrit en plusieurs étapes pour un résultat plus fin. Le mode réflexion consacre un raisonnement supplémentaire à cette réécriture et ajoute du temps ; il ne fait rien tant que l’expansion est désactivée.
Prenez la 2K, c’est le même prix
Chaque palier coûte le même prix par image : la 2K est donc le réglage par défaut et le choix logique. Passez en 1k seulement si vous voulez un fichier plus léger ou un retour un peu plus rapide.
Demandez plusieurs images d’un coup
Réglez
num_outputsde 1 à 6 pour obtenir des variantes d’un même prompt en un seul appel. Chaque image renvoyée est facturée : six images coûtent donc six fois une image. C’est le moyen le moins cher de trouver la pose ou la composition qui vous plaît avant de commencer à retoucher.En retouche, d’abord le changement, ensuite la liste de ce qu’on garde
Écrivez l’unique chose qui change, puis tout ce qui doit rester : « Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression. » (transforme sa robe de velours sombre en robe de satin carmin dos nu ; garde son visage, ses cheveux et son expression). Désignez les références par leur numéro. Dans notre test à deux portraits, « the man from Image 1 and the woman from Image 2 » (l’homme de l’Image 1 et la femme de l’Image 2) a gardé les deux visages reconnaissables dans un même cadre.
Mettez entre guillemets les mots qui doivent apparaître
Placez le texte exact entre guillemets et dites où il se trouve. Notre affiche de test, « VELVET HOUR » en haut et « LATE SHOW · FRIDAYS 11 PM » en bas, est revenue lettre pour lettre. Gardez chaque ligne courte et vérifiez-la en pleine taille avant de publier.
Écrivez le prompt dans un ordre fixe
Sujet, tenue, pose, lumière, objectif et palette, en phrases simples. Nommez la source de lumière et sa direction (une lampe chaude à gauche, une vitre ruisselante derrière elle) plutôt qu’un mot d’ambiance. Expansion désactivée, Turbo dessine ce que vous écrivez et ne comble pas les trous à votre place.
Introduction
Qwen Image 2.1 Turbo Retouche d’image modifie une image existante à partir d’une consigne en langage courant. L’équipe Qwen d’Alibaba a publié Turbo avec des poids ouverts le 9 octobre 2026 et l’a conçu pour poursuivre la création par des retouches en langage naturel, de l’ajout d’un accessoire au changement de scène, en 8 pas de débruitage sur la même architecture 7B que Qwen Image 2.1.
Sur SpicyAPI, il est en ligne. Une requête accepte de une à dix références et renvoie de un à six résultats à un prix unique par image, sans aucun filtre de contenu devant le modèle. Chaque exemple de cette page a été généré avec Turbo, avec le prompt affiché.
Choisir un mode selon ce que vous avez
| Matériau de départ | Mode |
|---|---|
| Une ou plusieurs images à modifier | Qwen Image 2.1 Turbo Retouche d’image |
| Un brief écrit, rien d’autre | Qwen Image 2.1 Turbo Texte vers image |
Ce que nous avons mesuré
Vitesse
De 26 à 59 secondes par retouche de bout en bout sur l’ensemble de nos essais.
Forme
Sans format d’image, un portrait 2:3 est revenu en cadre 2:3 à environ 2K (1680 × 2512). Réglez un format d’image quand vous avez besoin d’une taille fixe.
Contenu
Expansion de prompt désactivée (par défaut), les modifications à chaque niveau de contenu testé sont revenues conformes à la demande, pour un portrait de femme et un portrait d'homme. Expansion activée, la demande d'aller plus loin est revenue deux fois à l'identique et a été facturée comme terminée.
Deux références
Un homme et une femme photographiés séparément sont revenus côte à côte sur un même toit, tous deux reconnaissables, avec la tenue de la femme changée comme demandé.
Retouche Turbo ou Qwen Image 2.1
| Turbo | Qwen Image 2.1 | |
|---|---|---|
| Pas de débruitage | 8 | 40 |
| Résultats par requête | 1 à 6 | 1 |
| Prix par référence supplémentaire | Aucun | Chacune s’ajoute au prix |
| Masque pour retouches locales | Non | Oui |
| Format de sortie | PNG | JPEG, PNG ou WebP |
| Filtre de contenu | Aucun | Aucun |
Choisissez Turbo pour des chaînes de retouches rapides et le travail multi-références à prix unique. Choisissez Qwen Image 2.1 quand vous avez besoin d’un masque.
Guide des prompts et conseils de pro
D’abord le changement, ensuite ce qu’on garde
« Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression » (transforme sa robe de velours sombre en robe de satin carmin dos nu ; garde son visage, ses cheveux et son expression) est une retouche. « Make it better » (fais mieux) est un nouveau tirage.
Nommer chaque référence
Le modèle n’attribue pas de rôles aux références de lui-même. Dites quelle image est la personne, laquelle est le vêtement et laquelle est le lieu.
Laisser l’expansion désactivée
La réécriture peut écarter votre consigne et rendre la source. Désactivée, la consigne parvient au modèle telle qu’écrite.
Un changement par passe
Un seul changement est facile à juger. Cinq à la fois rendent difficile de savoir quelle consigne a déplacé le visage ou les mains.
Revenir à l’original après quelques retouches
Les visages peuvent dériver au fil d’une longue chaîne de retouches. Revenez à votre première image validée quand les détails commencent à bouger.
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-turbo/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# 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.
