Introduction
Qwen Image Edit Spicy retouche une seule image source d’après une seule consigne en anglais simple. Il n’y a ni masque, ni sélecteur de zone, ni réglage d’écart : la phrase est la seule commande, et seul ce que vous nommez est protégé.
La requête se compose de image_url, prompt et d’un seed facultatif ; un seed à 0 demande un tirage aléatoire. Chaque requête renvoie une image.
Fonctionnalités et points forts
Ni masque, ni intensité, ni procédure d’inpainting
La plupart des éditeurs vous font choisir une zone et un degré d’écart avant de pouvoir changer quoi que ce soit. Celui-ci prend une phrase. Nommez ce qui change, nommez ce qui doit rester, et envoyez. L’absence de réglage d’intensité est voulue : la préservation s’exprime avec des mots, et c’est aussi ainsi qu’une retouche se vérifie après coup.
Retouches de tenue audacieuses, sans filtre
Un changement de tenue que refusent les éditeurs filtrés est ici une consigne ordinaire, et non un cas particulier. Il n’y a pas d’indicateur de maturité à activer ni d’autre point de terminaison vers lequel la requête serait déviée. Votre formulation dans la consigne est transmise telle qu’elle est écrite.
Changer le texte d’une enseigne sans redessiner la pièce
Comme il hérite de la typographie de la gamme Qwen Image, il peut modifier un texte déjà présent dans l’image : une affichette de porte, une ardoise de menu, l’étiquette d’une bouteille. Citez la chaîne actuelle et celle que vous voulez, et précisez que la pose, le cadrage et l’étalonnage ne bougent pas.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
image_url | Oui | Un lien public et directement téléchargeable vers une image dont vous détenez les droits. 1 caractères minimum |
prompt | Oui | Une instruction portant les deux moitiés de la retouche. 1 caractères minimum |
seed | Non | Renvoyez la même seed avec la même image et la même instruction pour que le tirage reste identique entre deux retouches, la seule différence étant ce que vous avez changé ; c’es… |
Tarification
$0.038 / image
Cas d’utilisation
Affiner un visuel fourni
Utilisez ce point de terminaison quand une photo existante doit rester cette photo et qu’une seule chose doit changer. Envoyez-la en image_url, nommez le changement et les éléments qui doivent rester — pose, cadrage, lumière, étalonnage — puis comparez le résultat à la source.
Des consignes que d’autres éditeurs refusent
Les consignes de tenue audacieuses que rejettent les API de retouche filtrées passent ici comme des retouches ordinaires. Rien ne change dans la requête : mêmes noms de champs, même cycle de vie de tâche, même interrogation asynchrone du résultat.
Changements de tenue sur une image validée
Vous avez déjà un portrait dont la pose et la lumière fonctionnent. Remplacez la tenue par une tenue de soirée ou un look plus audacieux sans régénérer la scène, afin que le visage, la pièce et l'étalonnage survivent au changement et que l'ensemble reste cohérent.
Variantes de texte sur une photo déjà payée
Ne changez que les mots d’une enseigne, d’une affichette ou d’une étiquette et gardez la photographie identique. C’est moins cher et bien plus cohérent que de régénérer toute la scène pour chaque langue ou chaque accroche de campagne.
Guide de prompt et conseils pratiques
Héberger l’image source à une adresse accessible
image_url doit être un lien public téléchargeable directement — pas une page de visualisation, ni une URL signée qui expire avant l’exécution de la tâche. La source fixe la composition et le plafond de qualité de toute la passe.
Écrire une consigne qui nomme les deux côtés de la retouche
Dites ce qui change et ce qui doit rester identique, en une phrase chacun. La retouche de ce point de terminaison vient de : « Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade. »
Adapter l’exemple fourni
Partez de l’exemple publié, avec une URL publiquement accessible dans image_url. Remplacez le sujet et la direction créative en conservant le contrat d’entrée de ce mode.
Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.
C'est la consigne exacte derrière la retouche présentée pour ce point de terminaison : un changement de tenue plus une modification du texte de la plaque de porte, avec la pose, le cadrage, l'éclairage et l'étalonnage tous indiqués comme inchangés. Fournissez votre propre image source : l’image_url ici est un exemple fictif, pas un fichier hébergé.
Vérifier le résultat avant d’itérer
La voie fiable est un changement par appel, en nommant explicitement ce qui est préservé : pose, cadrage, lumière, étalonnage. Demandez un changement de tenue et un changement de texte dans la même consigne, et l’un des deux dérive généralement. L’identité tient bien sur une retouche ciblée unique et se dégrade sur de longues chaînes ; repartez donc de l’original plutôt que du résultat précédent. Il n’y a pas de réglage d’intensité : si une retouche est allée trop loin, la solution est une phrase plus précise, pas un chiffre plus bas.
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-spicy-edit/edit",
"input": {
"image_url": "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.
