Introduction
Wan 2.2 Animate transforme une image de personnage validée et une référence de mouvement séparée en un nouveau clip où ce personnage joue la scène. Utilisez-le quand l’apparence et le mouvement ont déjà été fixés dans des éléments distincts, au lieu de demander les deux à une seule source.
Il fonctionne selon deux modes. Avec animation_mode sur animate, le personnage de votre image bouge avec le mouvement de la vidéo pilote ; avec replace, la personne de la vidéo pilote est remplacée par celle de votre image et la scène de la vidéo est conservée. La sortie dure aussi longtemps que la vidéo pilote, de 2 à 30 secondes, en 480p ou 720p.
Fonctionnalités et points forts
Une pose en A nette vaut mieux qu’un long prompt
L’image de référence publiée est exactement le type d’image que ce point de terminaison attend : corps entier dans le cadre, pose neutre en A, fond uni, lumière homogène. Tout l’aspect du résultat vient de cette image. Une image recadrée ou très masquée limite chaque clip que vous en tirerez, et aucun prompt ne rattrape cela.
Le clip dure autant que la source, jusqu’à 30 secondes
La sortie dure autant que la vidéo pilote, qui doit faire de 2 à 30 secondes : une source de deux minutes doit donc être coupée d’abord. La facturation suit les secondes réellement livrées et non le plafond utilisé pour le devis, si bien que couper la vidéo pilote avant de l’envoyer est le moyen direct de maîtriser le coût.
Vérifiez la ressemblance en 480p avant de payer la 720p
Le clip publié montre la même image animée par une vidéo de référence : même haut bordeaux, même pantalon large, cette fois en pleine rotation. La résolution est un palier tarifaire et la 720p coûte plus cher à la seconde que la 480p : vérifiez d’abord en 480p, sur la vidéo pilote la plus courte possible, que l’identité et la silhouette tiennent.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
animation_mode | Non | Animate fait bouger le personnage de votre image avec le mouvement de la vidéo pilote. |
image_url | Oui | L’image de personnage. C’est cette personne qui est animée : utilisez donc une plaque en pied avec une silhouette nette et une lumière uniforme. 1 caractères minimum |
video_url | Oui | La vidéo source, de 2 à 30 secondes : importez un MP4 ou transmettez l’URL d’un MP4 ou d’un MOV. Son mouvement est transféré et sa durée fixe la durée de sortie. 1 caractères minimum |
resolution | Non | 480p ou 720p, 720p par défaut, et c’est un palier de prix. Prouvez le transfert en 480p, puis re-rendez les prises que vous comptez livrer. |
prompt | Non | Facultatif, jusqu’à 2000 caractères. Il guide le style et le contenu de l’animation — pas l’identité, qui appartient à l’image de personnage. 2000 caractères maximum |
seed | Non | De 0 à 2147483647 ; zéro demande une seed aléatoire. Fixez-la pour comparer deux tirages sur la même vidéo source. |
Tarification
La durée du résultat suit celle de la vidéo pilote et se facture à la seconde.
| Spécification | Prix |
|---|---|
| $0.053 / seconde |
| $0.11 / seconde |
Cas d’utilisation
Placer votre personnage dans des images existantes
Avec animation_mode sur replace, la personne de la vidéo pilote est remplacée par le personnage de votre image, tandis que les images gardent leur propre scène. Utilisez ce mode quand le lieu existe déjà en vidéo et que seul l’interprète doit changer.
Des boucles courtes à partir d’une fiche personnage
Jusqu’à 30 secondes suffisent pour une boucle de fil, un sticker ou un clip de réaction. Gardez une seule image et changez de vidéo pilote pour constituer une bibliothèque de gestes, un salut, une rotation, un haussement d’épaules, qui se lisent tous comme le même personnage parce qu’ils partagent la même image de référence.
Danses et numéros
Une image de personnage et une vidéo pilote de l’enchaînement voulu : la tenue et la morphologie restent fixées par l’image, tandis que le rythme, le poids et la caméra viennent des images vidéo. La limite, c’est la propriété : vous devez détenir les droits sur l’image comme sur la vidéo pilote, et vous êtes responsable de l’usage du résultat.
Tester une image avant un rendu plus long
Lancez un transfert de cinq secondes en 480p pour voir si une nouvelle image de personnage garde le visage, les mains et la silhouette en mouvement. C’est le moyen le moins cher d’écarter une mauvaise image avant de l’engager dans un travail complet de 30 secondes.
Guide de prompt et conseils pratiques
Construire l’image du personnage
Corps entier dans le cadre, pose neutre, fond uni, lumière homogène. Cette image décide du visage, de la tenue et des proportions de chaque clip que vous animez avec elle : il vaut la peine d’en générer et d’en écarter quelques-unes avant de vous décider. Si aucun visage ni aucune personne n’y est détecté, la tâche est refusée avec invalid_request. L’image publiée vient de ce prompt : « Full-body studio photograph of an adult female dancer standing in a neutral A-pose against a seamless grey backdrop, wearing a cropped burgundy tank top and high-waisted wide-leg trousers, barefoot, hair tied back, even soft studio lighting, sharp full-length framing, clean reference plate for character animation. »
Couper la vidéo pilote aux secondes nécessaires
La durée de sortie égale celle de la source, qui doit faire de 2 à 30 secondes, et vous payez les secondes livrées. Envoyez le fichier MP4 ou passez un lien direct vers un fichier MP4 ou MOV ; une page web qui se contente de lire la vidéo n’est pas un fichier, et l’appel échoue avec remboursement.
Le prompt pour le style, pas pour l’identité
prompt est facultatif et accepte jusqu’à 2000 caractères. Il oriente le style et le contenu de l’animation ; l’identité relève de l’image du personnage. Fixez seed pour comparer deux passes sur la même vidéo pilote.
Vérifier le résultat avant d’itérer
Les deux entrées sont obligatoires et non interchangeables : l’identité vient de l’image, le mouvement de la vidéo. En mode animate, le décor reste celui de l’image du personnage ; lors du test de référence, la vidéo pilote avait été tournée dans une cuisine et le résultat est resté sur le fond de studio gris de l’image, seuls le mouvement et la caméra ayant été repris. Une source plus longue n’est pas compressée : coupez-la avant de l’envoyer.
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.2-animate/character-animation",
"input": {
"animation_mode": "animate",
"image_url": "https://example.com/reference.png",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.
