Introduction
Ce que fait cet endpoint
Qwen Image 2.1 Pro Retouche d’image reprend vos images sources d’après une consigne écrite et renvoie de une à six nouvelles images, grâce au palier Pro hébergé de Qwen Image 2.1 d’Alibaba. Nos retouches ont pris de 39 à 48 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. Avec l’expansion désactivée, chaque édition testée est revenue comme demandé, sur les cinq niveaux d’intensité, du Léger au Maximum.
| 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 palier Pro hébergé d’Alibaba |
| 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 | 14 à 43 secondes en texte vers image, 39 à 48 secondes en retouche, sur l’ensemble de nos essais |
| Politique de contenu | Sans censure : aucun filtre côté plateforme, aucun indicateur de maturité |
| Poids | Non publiés ; Alibaba propose Pro comme API hébergée |
Fonctionnalités et points forts
Un titre bien orthographié du premier coup
Citez les mots et dites où ils se placent. « AFTER DARK » en haut et la petite ligne de couverture en dessous sont revenus lettre pour lettre, dans les deux images de la requête.
Deux portraits, une seule table aux chandelles
Un homme et une femme photographiés séparément, désignés comme Image 1 et Image 2, se retrouvent à une même table sur une terrasse de vignoble, les deux visages toujours reconnaissables et sa robe changée comme demandé.
Pro ou Turbo, sans réécrire une ligne
Pro et Turbo lisent les mêmes champs sur SpicyAPI : un prompt qui fonctionne sur l’un peut être envoyé tel quel à l’autre. Ébauchez vite sur Turbo et gardez les images qui comptent sur Pro, ou l’inverse.
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, si bien que votre consigne parvient au modèle telle qu’écrite. Activée, Alibaba la réécrit d’abord, ce qui peut atténuer une demande plus audacieuse. 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.036 / image
Cas d’utilisation
Travail d’image sans censure
SpicyAPI ne place aucun filtre de contenu devant Pro. Avec l’expansion de prompt désactivée, nos tests sont revenus tels qu’écrits à chaque niveau d’intensité testé, du Léger au Maximum, avec des sujets féminins et masculins.
Couvertures et affiches au texte exact
Alibaba annonce une typographie améliorée pour Pro. Citez le titre et la ligne de couverture, dites où chacun se place et décrivez la photographie : notre couverture de magazine est revenue avec les deux lignes orthographiées exactement, dans les deux images de la requête.
Un même personnage sur toute une série
Générez un personnage, puis renvoyez l’image comme référence et changez la tenue, 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 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 à une même table aux chandelles sur une terrasse de vignoble, tous deux reconnaissables.
Portraits et lumières d’ambiance
Alibaba met en avant l’éclairage de portrait et le détail fin comme points forts de Pro. Nommez une source de lumière et l’endroit où elle tombe, une lampe-tempête, une haute fenêtre, une applique, et l’image se construit autour d’elle.
Beaucoup de brouillons avant la bonne image
Jusqu’à six images par appel à un prix unique : un éventail d’options peu coûteux. Explorez tenue, pose et lumière en une seule requête, gardez l’image qui fonctionne et consacrez vos retouches à celle-là.
Guide de prompt et conseils pratiques
Gardez l’expansion de prompt désactivée quand la formulation compte
L’expansion transmet votre prompt au réécrivain d’Alibaba avant le rendu de l’image, et cette réécriture peut atténuer une consigne audacieuse. Elle est désactivée par défaut ici, et chaque test de contenu que nous avons lancé sans elle est revenu tel qu’écrit. Lors de notre unique essai Pro avec l’expansion activée, un prompt que l’application officielle bloquerait est tout de même passé, mais gardez-la désactivée dès que la formulation exacte compte.
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.
Utilisez la 2K, elle coûte autant
Chaque palier coûte le même prix par image : la 2K est donc le réglage par défaut et le choix raisonnable. Descendez en 1k seulement si vous voulez un fichier plus léger ou un retour un peu plus rapide.
Demandez plusieurs images à la fois
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 six fois une image. C’est le moyen le moins cher de trouver une pose ou une composition qui vous plaît avant de passer à la retouche.Retouchez avec le changement d’abord, la liste de ce qui reste ensuite
Écrivez d’abord le seul élément qui change, puis tout ce qui doit rester : « Remplace sa robe en velours par une robe du soir ivoire ; garde son visage, ses cheveux et son expression. » Nommez les références par leur numéro. Dans notre test à deux portraits, « l’homme de l’image 1 et la femme de l’image 2 » attablés à la bougie sont restés reconnaissables tous les deux dans un même cadre.
Citez les mots qui doivent apparaître
Mettez le texte exact entre guillemets et dites où il se place. Notre couverture de magazine, « AFTER DARK » en haut et « THE SILK ISSUE · NO. 07 » en petites lettres en dessous, est revenue lettre pour lettre. Gardez chaque ligne courte et vérifiez-la en taille réelle 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 à huile à gauche, un faisceau tournant derrière elle) plutôt qu’un mot d’ambiance. Expansion désactivée, Pro dessine ce que vous écrivez et ne comble pas les vides à votre place.
Introduction
Qwen Image 2.1 Pro Retouche d’image modifie une image existante à partir d’une consigne en langage courant. Pro est le palier hébergé de Qwen Image 2.1 d’Alibaba, qui réunit génération et retouche dans un seul modèle ; Alibaba cite la retouche avec jusqu’à dix références, des retouches locales qui préservent les personnes et les produits, et un éclairage de portrait et un détail fin améliorés.
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 Pro, 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 Pro Retouche d’image |
| Un brief écrit, rien d’autre | Qwen Image 2.1 Pro Texte vers image |
Ce que nous avons mesuré
Vitesse
De 39 à 48 secondes par retouche de bout en bout sur l’ensemble de nos essais, dont deux résultats à partir de deux références en un seul appel.
Forme
Sans format d’image, un portrait 2:3 est revenu en cadre 2:3 à environ 2K (1664 × 2496). Réglez un format d’image quand vous avez besoin d’une taille fixe.
Contenu
Avec l’expansion de prompt désactivée, valeur par défaut, chaque édition testée est revenue comme demandé, sur les cinq niveaux d’intensité, du Léger au Maximum. Pas une seule édition n’a été refusée.
Deux références
Un homme et une femme photographiés séparément sont revenus côte à côte à une même table aux chandelles, tous deux reconnaissables, avec la tenue de la femme changée comme demandé.
Retouche Pro ou Turbo
| Pro | Turbo | |
|---|---|---|
| Ce que c’est | Le palier Pro hébergé d’Alibaba | Checkpoint à 8 pas |
| Poids | Non publiés | Ouverts, Qwen Research License |
| Résultats par requête | 1 à 6 | 1 à 6 |
| Prix par référence supplémentaire | Aucun | Aucun |
| Prix par image | Plus élevé | Plus bas |
| Filtre de contenu | Aucun | Aucun |
La requête est la même : vous pouvez lancer une consigne sur les deux et garder le résultat que vous préférez.
Guide des prompts et conseils de pro
D’abord le changement, ensuite ce qui reste
« Remplace sa robe en velours par une robe du soir ivoire ; garde son visage, ses cheveux et son expression » est une édition. « Rends-le meilleur » est un nouveau tirage.
Nommez 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.
Laissez l’expansion désactivée
La réécriture peut adoucir votre consigne avant que le modèle ne la voie. 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.
Revenez à 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-pro/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.
