Introduction
Wan 2.7 Pro Retouche d’image retravaille des images fournies avec une modification ciblée. Utilisez-la quand l’image source contient des détails qui doivent rester reconnaissables pendant qu’une décision locale ou stylistique change.
Choisir un mode Wan 2.7 Pro selon le matériau de départ
| Ce que vous avez au départ | Mode |
|---|---|
| un brief visuel écrit | Wan 2.7 Pro Texte vers image |
| une image qui demande une modification ciblée | Wan 2.7 Pro Retouche d’image |
Fonctionnalités et points forts
Jusqu’à 4K, en text-to-image
Ici, le text-to-image travaille en 2k par défaut, environ 4 mégapixels, et monte jusqu’à 4k, environ 16 mégapixels, là où la famille standard s’arrête à 2k. L’image-to-image travaille en 2k. Toute l’idée est là : passez en 4k pour une image phare qui sera recadrée ou imprimée, pas pour recolorer un packshot.
Lumière de bougie, peau et coups de pinceau
La seconde image de cette page est un intérieur à la facture picturale : une silhouette derrière un paravent à contre-jour, une bougie et un verre de vin sur une table laquée. Chute de lumière douce, texture de brosse visible et un visage qui se lit à cette taille sont les premières choses à s’effondrer sur une petite toile, et exactement ce à quoi sert la grande.
Il retient chaque clause d’une longue consigne
Sur l’image-to-image, la capacité supplémentaire va au suivi d’instructions composées — prends cet objet, pose-le sur cette surface, accorde la lumière de la deuxième image, ne touche pas à la condensation. La famille standard laisse tomber une clause d’une instruction pareille plus souvent que celle-ci.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Écrivez le changement et la liste de ce qui ne doit pas changer. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | De une à neuf références en un appel. L’ordre a du sens : le prompt y renvoie par position et la dernière fixe les proportions quand |
bounding_boxes | Non | Rectangles facultatifs qui indiquent où la retouche doit avoir lieu, jusqu’à deux par image de référence. 18 éléments maximum |
aspect_ratio | Non | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 ou 2:3. Pas de défaut. |
color_palette | Non | Thème de couleurs facultatif de 3 à 10 couleurs (8 recommandées). 3 éléments minimum · 10 éléments maximum |
seed | Non | De 0 à 2147483647. Fixez-la sur tout un jeu de variantes, pour que la seule différence entre deux retouches soit la clause que vous avez changée. |
Tarification
$0.075 / image
Cas d’utilisation
Adapter une image validée à un nouveau contexte de campagne
Envoyez le packshot et la surface de destination comme deux références étiquetées, et demandez d’accorder la direction de la lumière et la température de couleur de la seconde. La condensation, l’étiquette et la forme du verre restent intactes parce que vous l’avez dit explicitement.
Explorer une modification maîtrisée de la direction artistique
Gardez la pose et la tenue de la référence et changez la lumière ou le décor dans la même consigne. Les consignes composées sont précisément ce pour quoi ce point de terminaison est réglé ; nommez donc la direction de la lumière, la température de couleur et les parties qui ne doivent pas bouger.
Préparer une série de variantes cohérente
Fixez seed sur toute une série de variantes pour que la seule différence entre deux retouches soit la proposition modifiée. Chaque retouche se fait sur une surface 2k, environ 4 mégapixels ; le 4k n’existe qu’en texte vers image.
Guide de prompt et conseils pratiques
Dire ce qui doit rester et ce qui peut changer
Désignez les sources par leur position — image 1, image 2 — et écrivez la modification suivie de la liste de ce qui ne doit pas changer. Avec une à neuf références, précisez le rôle de chacune ; la dernière fixe les proportions quand aspect_ratio est omis.
Garder la retouche vérifiable par étapes
Chaque requête renvoie une image. Construisez une série de variantes en répétant l’appel avec le seed et tout le reste inchangés, changez une proposition à la fois et comparez chaque résultat à la source, pas à la retouche précédente.
Valider le résultat qui dépend de la source
Chaque référence doit être au format JPEG, PNG sans transparence, BMP ou WEBP, mesurer de 240 à 8 000 pixels de côté, avoir un rapport compris entre 1:8 et 8:1 et ne pas dépasser 20 Mo. Un autre aspect_ratio recompose l’image au lieu de la recadrer ; vérifiez donc que les éléments conservés sont toujours à leur place.
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/wan-2.7-pro/edit",
"input": {
"image_urls": [
"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.
