Un portrait approuvé n’a parfois besoin que d’un seul changement de garde-robe : une écharpe au tissage et au tombé différents, avec le visage, le chapeau et la pose toujours reconnaissables. Un éditeur d’images peut proposer ce changement, mais le choix de la bonne opération compte quand le reste de la photographie doit rester exact.
Qwen Image Edit Spicy accepte une image source, une instruction de retouche et une seed facultative. Au tarif actuel de $0.038 par image, utilisez-le pour une modification pilotée par texte d’une composition existante ; n’attendez ni masque ni réglage de l’intensité de la source. Pour un changement de couleur exact qui doit préserver chaque bord de visage et de vêtement, l’ajustement de couleur classique avec masque est la méthode la plus directe. Pour une proposition générative de garde-robe, utilisez la source et l’instruction de retouche ci-dessous, puis comparez le résultat à la source d’origine.
L’exemple fictif met en scène une femme adulte en blazer prune et chemise ivoire, portant une écharpe bleu-vert pâle et tenant un chapeau en feutre orange brûlé. Le changement demandé est une écharpe cuivre atténué, au tissage plus épais. Les illustrations existantes montrent le brief, pas la capacité de préservation de Qwen.
Choisir la bonne tâche Qwen
Ouvrez Qwen Image Edit Spicy, dont l’identifiant public est alibaba/qwen-image-spicy-edit/edit. Elle est distincte de la retouche Qwen Image 2.1 et des tâches Qwen LoRA.
| Champ | Valeur pour cet essai | Signification |
|---|---|---|
image_url | Le fichier du portrait approuvé | Source unique, pas image_urls |
prompt | Instruction pour l’écharpe ci-dessous | Obligatoire, non vide |
seed | 314159 | Entier facultatif, 0–2147483647 ; zéro demande une seed aléatoire |
Deux limites concernent ce travail de garde-robe :
- Pas de contrôle de zone : la tâche n’expose ni masque ni réglage de l’intensité de la source. « Change uniquement » décrit le résultat visé ; cela ne verrouille pas le reste de l’image.
- Pas de contrôles de livraison ni de réglage : résolution, rapport d’aspect, format de sortie, prompt négatif et champs LoRA des autres tâches Qwen ne sont pas acceptés ici. Inspectez le fichier renvoyé avant de préparer le recadrage final.
La présentation plus générale de Qwen Image Edit traite de la retouche sémantique et d’apparence. Elle n’établit ni la révision de base exacte ni le fonctionnement interne de cette tâche Spicy hébergée. Pour la requête réelle, utilisez les champs actuels de cette tâche.
Préparer une source où toute l’écharpe est visible
Utilisez le portrait d’origine en plan taille, avec le pli inférieur de l’écharpe, les deux revers du blazer, la main et le bord complet du chapeau. Ne recadrez pas sur la seule écharpe : il vous faut le visage et le chapeau dans la même image renvoyée pour repérer les changements collatéraux. Une écharpe en partie cachée sous les cheveux peut quand même être retouchée, mais un prompt ne peut pas protéger des limites que vous ne distinguez pas dans la source.

Illustration, pas un résultat du modèle cible : l’écharpe entière, les revers, les mains et le chapeau fournissent un brief concret de préservation de la source.
Pour une personne réelle, utilisez une source que vous êtes autorisé à traiter. Pour une série de personnages, revenez au même portrait approuvé quand une révision ratée modifie le visage ; n’utilisez pas le visage raté comme prochain original.
Séparer un changement de couleur d’un nouveau vêtement
Une retouche de garde-robe peut demander trois choses différentes. Un changement de couleur conserve la position des coutures, la matière et le tombé. Un changement de matière conserve le dessin du vêtement mais modifie la façon dont la lumière s’y réfléchit. Un remplacement change aussi le col, les bretelles, la fermeture ou la coupe. Mélanger les trois dans « rends la tenue plus attirante » laisse au modèle le soin de décider quels détails d’identité et de pose redessiner.
Pour l’écharpe, « tissu tissé brun-cuivre atténué » nomme une couleur et une surface. « Écharpe cuivre » peut aussi évoquer du métal, ce qui explique l’échec brillant du tableau ci-dessous. Pour du satin, distinguez la couleur de base du tissu des reflets : les reflets pâles peuvent rester pâles tandis que le corps du tissu devient bordeaux. Exiger une couleur parfaitement uniforme efface les informations de lumière et de plis qui font ressembler la pièce à du tissu.
Pour une série de garde-robe d’un personnage adulte fictif, partez d’une source approuvée et nette, où le visage et la limite du vêtement sont visibles. Demandez d’abord le changement d’un seul vêtement. Si la tenue obtenue est utile mais que l’éclairage est mauvais, faites une révision d’éclairage à partir de la variante acceptée ; si le visage est mauvais, repartez de l’original. Répéter les retouches sur un visage modifié finit par faire du visage modifié la source.
Une nouvelle tenue qui couvre une autre zone change aussi les informations que le modèle doit inventer. Une source ne contient pas la construction cachée d’un autre vêtement ni une main masquée. Gardez la pose et le point de vue de la caméra stables pendant que vous explorez les vêtements, afin qu’un nouveau résultat de garde-robe n’exige pas aussi une nouvelle solution d’anatomie ou de perspective. C’est une façon proposée de réduire les consignes contradictoires, pas un taux de réussite testé pour cet endpoint.
Essayer la retouche de l’écharpe dans le Playground
- Sur la page du modèle, ouvrez l’onglet Playground et ajoutez le portrait approuvé sous Input image (JPG, PNG, WEBP ou GIF, jusqu’à 10 MB). Téléversez le fichier, ou collez un lien public à téléchargement direct avec Asset URL et Add URL ; les pages de visionneuse et les liens signés de courte durée échouent.
- Dans Prompt, saisissez : « Change only the pale-teal scarf to muted copper woven fabric with heavier texture. Keep its wrap, the face, plum blazer, ivory shirt, hands, orange hat, lighting and framing. »
- Laissez Seed vide, ou saisissez
314159pour comparer des formulations avec la même seed. Cliquez sur Run model et comparez le visage, l’écharpe et le chapeau à la source.
Utiliser la configuration approuvée via l’API
Définissez SPICY_API_KEY dans votre environnement. Définissez SOURCE_IMAGE_URL sur l’URL HTTPS directe de votre portrait approuvé ; pour un fichier présent sur votre ordinateur, téléversez-le d’abord comme décrit dans le guide des médias. Exécutez le script avec Python 3 ; ne confirmez le devis affiché que si vous voulez un nouvel essai payant.
import json
import os
import uuid
from pathlib import Path
from urllib.request import Request, urlopen
payload = {"model": 'alibaba/qwen-image-spicy-edit/edit', "input": {
'image_url': os.environ['SOURCE_IMAGE_URL'],
'prompt': "Change the pale-teal scarf to muted copper woven fabric with a heavier weave and soft folds. Keep its wrap and placement around the neck. Retain the adult woman's face, hairstyle, plum blazer, ivory shirt, hand positions, burnt-orange felt hat, studio background, lighting and camera framing. The scarf remains fabric, not metallic jewelry.",
'seed': 314159,
}}
def api(action, body, key=None):
headers = {"Authorization": "Bearer " + os.environ["SPICY_API_KEY"],
"Content-Type": "application/json"}
if key:
headers["Idempotency-Key"] = key
request = Request("https://api.spicyapi.ai/api/v1/jobs/" + action,
data=json.dumps(body).encode(), headers=headers)
with urlopen(request, timeout=60) as response:
result = json.load(response)
if result.get("code") != 200:
raise RuntimeError(result)
return result["data"]
quote = api("quote", payload)
print("Maximum charge (USD):", quote["maxCharge"])
if input("Create this new attempt? Type yes: ").strip() != "yes":
raise SystemExit("No task created")
key = str(uuid.uuid4())
body = {**payload, "quoteId": quote["quoteId"],
"expectedCost": quote["estimatedCost"]}
Path(key + ".json").write_text(json.dumps({"key": key, "request": body}))
task = api("createTask", body, key)
Path(key + ".task.json").write_text(json.dumps(task))
print("Task ID:", task["taskId"])Conservez la clé enregistrée pour relancer cette même requête. La récupération des résultats et la gestion des fichiers sont décrites dans le guide de l’API des tâches.
Pour des retouches répétées, un Agent peut prendre en charge le brief approuvé :
- CLI :
npx @spicyapi/cli tasks create --model alibaba/qwen-image-spicy-edit/edit --input-file input.json --wait, oùinput.jsoncontient{"image_url": "...", "prompt": "..."}. - MCP : demandez-lui d’utiliser
spicyapi_task_create, puisspicyapi_task_wait. - Skill : installez-la avec
npx skills add spicyapi-ai/spicy-skill, puis demandez à la Skillspicyapid’exécuter cette configuration après avoir affiché son devis.
Corriger en fonction de l’échec visible
| Problème renvoyé | Action suivante à partir de la source d’origine approuvée |
|---|---|
| L’écharpe ressemble à du métal brillant | Remplacez « copper » par « muted copper-brown woven fabric with soft diffuse highlights » ; conservez les plis d’origine. |
| Le chapeau devient cuivre lui aussi | Ajoutez « The burnt-orange felt hat keeps its original color and matte felt texture; only the scarf changes. » |
| Un pli inférieur reste bleu-vert | Nommez ce pli explicitement : « Recolor the entire visible scarf, including the long fold over the ivory shirt. » |
| Un revers du blazer est recoloré | Utilisez un ajustement de couleur classique avec masque, ou un éditeur capable de gérer des zones ; répéter « uniquement » n’ajoute pas de masque à cet endpoint. |
| Le visage ou la pose change | Rejetez cette révision comme retouche de préservation et repartez du portrait approuvé. Ne l’enchaînez pas. |
| La forme de sortie ou le type de fichier ne convient pas au design | Inspectez le fichier renvoyé et préparez une version dérivée pour la livraison ; il n’existe pas de réglage de taille ni de format ici. |
Pour le brief simple, limité à la couleur, une finition ordinaire suffit souvent : sélectionnez l’écharpe dans un éditeur à calques, appliquez le changement de teinte à travers cette sélection et conservez les calques d’origine du visage et du chapeau. Si le travail demande plutôt une autre matière d’écharpe ou un nouveau tombé, une proposition générative peut être utile, mais elle devient un changement de garde-robe plus large.
Quand un masque est nécessaire
Qwen Image 2.1 edit expose un contrôle mask_url distinct. Son masque noir et blanc utilise le blanc pour repeindre et le noir pour conserver, avec exactement une image de référence. Le masque prend en charge 1k et 2k, à $0.036 et $0.048 par image respectivement. C’est une tâche alternative, pas un champ supplémentaire à ajouter à Spicy Edit. Téléversez le portrait d’origine comme source unique et incluez l’écharpe et sa limite dans la zone de retouche.
Même avec un éditeur gérant les zones, comparez ensuite le visage, le chapeau et les revers. Si la livraison exige des pixels d’origine identiques en dehors de l’écharpe, compositez le traitement accepté de l’écharpe dans l’original à l’aide d’un masque de calque classique, plutôt que de présenter une consigne générative de préservation comme une garantie.

Illustration, pas un résultat du modèle cible : les tissus expriment une direction de couleur ; cette impression de planification distincte n’est pas un résultat avant-après correspondant.
Ce que les tests historiques pour adultes montrent, et ce qu’ils ne montrent pas
Lors de nos tests de septembre 2026, Spicy Edit a réalisé les retouches demandées dans les cinq catégories de contenu pour adultes. Les résultats des tests comportent de vraies paires avant-après. Son traitement des contenus sans censure ne rend pas la préservation de la source automatique : une retouche menée à bien peut tout de même altérer un visage ou une main.
À $0.038, deux candidats voulus coûtent $0.076 au total ; aucun nombre de candidats ne garantit que le portrait soit préservé.
Commencez par la requête à source unique quand une variante générative approximative est utile. Choisissez une tâche réellement capable de masque, ou une finition ordinaire, quand la préservation exacte du portrait environnant est l’exigence centrale.
Questions fréquentes
Qwen Image Edit Spicy est-il la même tâche que la retouche Qwen Image 2.1 ?
Non. Spicy Edit utilise une image_url et une seed facultative. La tâche de retouche 2.1, distincte, accepte un mask_url ; avec ce masque, fournissez exactement une référence. Choisissez la tâche avant de copier une requête plutôt que de combiner leurs champs.
Puis-je laisser inchangé chaque pixel en dehors de l’écharpe ?
Cette tâche n’a pas de masque qui l’impose. Pour un simple changement de couleur, faites une sélection dans un éditeur classique. Pour un changement de matière généré, recompositez la zone acceptée de l’écharpe dans l’original si des pixels environnants inchangés sont requis.
La seed conservera-t-elle le même visage ?
Une seed pilote la tentative de génération ; ce n’est pas un contrôle de préservation du visage. Conservez la source approuvée et comparez le visage, la ligne des cheveux, les mains et les limites des vêtements dans la sortie réelle.
Puis-je relancer si j’ai perdu la réponse à l’envoi ?
Envoyez le même Idempotency-Key avec la même requête ; le script ci-dessus enregistre les deux dans <key>.json. Le guide de l’idempotence explique la fenêtre de 24 heures. Lancer un nouvel essai, c’est une autre image payante.






