Wan 2.2 Animate associe une image de personnage à une vidéo source qui fournit le mouvement. Dans le processus documenté de l’API Character Swap d’AKOOL, l’image guide l’apparence du personnage tandis que le MP4 source fournit la performance. L’exemple de réponse de l’API identifie le modèle sous-jacent comme wavespeed-ai/wan-2.2/animate.
AKOOL propose cette fonctionnalité via son API Character Swap. Cette approche se distingue du simple choix d’un modèle générique de génération vidéo à partir de texte dans une liste d’outils vidéo IA.
En bref
- L’apparence provient de l’image : importez une image de personnage PNG ou JPEG.
- Le mouvement provient de la vidéo : fournissez un MP4 contenant la performance à transférer.
- Animate et replace sont des modes API différents :
animatetransfère le mouvement à l’image du personnage, tandis quereplaceeffectue le remplacement de visage documenté pour ce point de terminaison. - Conservez l’identifiant de tâche : la génération est asynchrone. Utilisez le
_idrenvoyé pour vérifier l’état et télécharger la vidéo terminée avant l’expiration de son URL après sept jours.
Sommaire
- Qu’est-ce que Wan Animate ?
- Quelle différence entre les modes animate et replace ?
- Comment préparer une vidéo de référence de mouvement ?
- Comment utiliser l’API Wan Animate via AKOOL ?
- Quels prompts facilitent l’animation de personnages ?
- Pourquoi le transfert de mouvement de personnage par IA échoue-t-il ?
- Comment vérifier et enregistrer le résultat ?
- Questions fréquentes
Qu’est-ce que Wan Animate ?
Wan Animate est un processus d’animation de personnages fondé sur des références : une image définit l’apparence du personnage, tandis qu’une vidéo source fournit le mouvement à appliquer. Dans l’API Character Swap d’AKOOL, le mode animate documenté associe ces entrées et peut également utiliser un court prompt textuel pour guider le résultat.
Le processus est plus facile à comprendre sous la forme de trois ressources :
| Input/output | Role |
|---|---|
| Character image | Defines the character you want to animate |
| Motion reference video | Supplies timing, body motion, and performance |
| Generated video | Combines the character appearance with the referenced motion |
Le point de terminaison de création d’AKOOL exige l’URL d’une image de personnage en PNG ou JPEG et l’URL d’une vidéo source en MP4. L’exemple de réponse de l’API identifie le modèle comme wavespeed-ai/wan-2.2/animate : ce nom de modèle est donc étayé par des éléments propres à l’API. Cela ne prouve pas que le site public propose une option de menu portant exactement ce nom.
Quelle différence entre les modes animate et replace ?
Dans le point de terminaison documenté d’AKOOL, animate applique le mouvement de la vidéo source à l’image du personnage. replace est un autre mode qui remplace les visages dans la vidéo source à l’aide de l’image du personnage fournie. Ces définitions concernent ce point de terminaison de l’API AKOOL, et non tous les produits utilisant la famille de modèles Wan.
| Mode | Goal | Required inputs | What to review |
|---|---|---|---|
animate | Animate the supplied character using source-video motion | Character image + motion MP4 | Identity, body motion, clothing, hands, feet |
replace | Replace faces in the source video with the supplied character | Character image + source MP4 | Face match, tracking, pose changes, occlusion |
Le point de terminaison utilise animate par défaut lorsqu’aucun mode n’est spécifié.
Cette distinction est importante, car animate et replace désignent deux transformations différentes. Pour un transfert complet de mouvement de personnage par IA, commencez par animate.
Pour un autre processus de production fondé sur Kling, consultez le guide AKOOL sur le remplacement de personnage avec contrôle du mouvement. Kling 2.6 repose sur la même idée générale d’association d’une image de personnage à une performance de référence, mais utilise un modèle et un processus différents.
Comment préparer une vidéo de référence de mouvement ?
Utilisez une performance source claire dont le cadrage et les parties du corps visibles correspondent à l’image de votre personnage. Plus la référence est nette, plus il est facile de déterminer si les erreurs proviennent des ressources sources ou de la génération.
Faites correspondre le cadrage
Si votre vidéo de mouvement montre une marche en pied, utilisez une image de personnage fournissant également suffisamment d’informations sur l’ensemble du corps.
Un portrait serré associé à de la course, de la danse ou d’amples mouvements de jambes oblige le modèle à inventer une anatomie que l’image ne montre pas.
Pour une meilleure cohérence vidéo guidée par des références, AKOOL recommande des sujets nets, des détails d’identité visibles et des ressources de référence définissant les éléments à préserver.
Gardez l’interprète visible
Choisissez une référence de mouvement dans laquelle l’interprète reste dans le cadre.
Évitez les séquences sources dans lesquelles :
- les pieds sortent régulièrement du cadre,
- les mains disparaissent derrière le corps,
- une autre personne passe devant le sujet,
- la caméra change brusquement de cadrage,
- l’interprète devient très petit à l’image.
Réduisez les occultations
Les bras croisés, les mains cachées, les accessoires couvrant le torse et les rotations rapides compliquent l’évaluation du transfert de performance.
Référence plus adaptée : corps entier visible, mouvement modéré, caméra stable.
Référence plus difficile : pieds coupés, rotations répétées, mains cachées derrière des accessoires, coupes multiples.
Comment utiliser l’API Wan Animate via AKOOL ?
Envoyez l’URL d’une image de personnage et celle d’un MP4 source au point de terminaison de création Character Swap d’AKOOL, définissez mode sur animate, ajoutez éventuellement un prompt, puis conservez le _id renvoyé. Utilisez cet identifiant avec le point de terminaison de résultats jusqu’à ce que la tâche atteigne completed.
Le point de terminaison de création documenté est :
POST https://openapi.akool.com/api/open/v4/characterSwap/create
AKOOL accepte soit un en-tête x-api-key, soit une authentification Bearer.
Consultez les instructions officielles de l’API Character Swap pour connaître les informations actuelles d’authentification et de points de terminaison.
Exemple de requête avec données sensibles masquées
curl --location 'https://openapi.akool.com/api/open/v4/characterSwap/create' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"image": "https://example.com/approved-character.png",
"video": "https://example.com/reference-motion.mp4",
"resolution": "720p",
"mode": "animate",
"prompt": "Follow the reference performance with smooth motion. Keep the character appearance and clothing consistent."
}'
Les champs importants sont :
| Field | Purpose |
|---|---|
image | PNG/JPEG character-image URL |
video | MP4 motion-reference URL |
duration | Optional, 1 to 120 seconds; otherwise detected from source |
resolution | 480p, 720p, or 1080p |
mode | animate or replace |
prompt | Optional guidance, maximum 500 characters |
webhookurl | Optional completion callback |
Ces valeurs sont les paramètres documentés de ce point de terminaison, et non des limites générales de Wan sur toutes les plateformes. La réponse contient un _id. Conservez-le.
Pour vérifier la tâche :
GET https://openapi.akool.com/api/open/v3/content/video/infobymodelid?video_model_id=YOUR_TASK_ID
Les états de tâche sont :
1: en file d’attente2: en cours de traitement3: terminée4: échec
Lorsque l’état atteint 3, l’URL générée apparaît dans le champ video.
Quels prompts facilitent l’animation de personnages ?
Considérez le texte comme un guide, et non comme la source de la performance. La référence de mouvement doit définir l’action. Votre prompt doit renforcer l’identité, le cadrage et la simplicité, plutôt que demander un mouvement incompatible avec la vidéo source.
1. Geste simple
Applique le lent geste de salutation de la vidéo de référence au personnage fourni. Conserve les mêmes vêtements et la même coiffure. Utilise des mouvements fluides.
2. Présentateur
Suis les mouvements des mains et le rythme de l’interprète de référence. Garde le personnage face à la caméra. Évite d’ajouter des gestes supplémentaires.
3. Marche
Suis le cycle de marche fourni. Préserve les proportions et la tenue du personnage. Garde les deux pieds visibles.
4. Personnage stylisé
Anime le personnage illustré fourni en suivant le rythme de la référence. Conserve ses aplats de couleur et ses contours dessinés.
5. Prompt de correction
Utilise le même personnage et une séquence de référence plus lente, sans recadrage. Garde un mouvement simple et le corps entier dans le cadre.
Ne considérez pas ces prompts comme une syntaxe magique. Ce sont des contraintes facultatives qui encadrent une performance déjà fournie par la vidéo.
Pourquoi le transfert de mouvement de personnage par IA échoue-t-il ?
La plupart des échecs visibles proviennent d’une mauvaise correspondance entre les entrées ou d’un mouvement qui oblige le modèle à reconstruire des informations absentes de l’image du personnage. Corrigez la paire de ressources sources avant d’ajouter du texte au prompt.
| Symptom | Likely cause | First correction |
|---|---|---|
| Feet deform or disappear | Feet cropped in image/reference | Use full-body inputs |
| Hands look unstable | Hands hidden or crossing | Choose clearer hand motion |
| Body proportions drift | Image and performer builds differ strongly | Use a closer body/proportion match |
| Fast turn breaks identity | Large rotation or face occlusion | Slow the reference movement |
| Background shifts | Reference camera/background changes | Use a steadier source clip |
| Illustrated style softens | Motion reconstruction changes edges/textures | Simplify motion and inspect style drift |
Une référence de mouvement réduit les approximations, mais ne garantit pas une préservation parfaite du personnage. C’est pourquoi la préparation des entrées compte autant que le prompt.
Comment vérifier et enregistrer le résultat ?
Une tâche API terminée signifie uniquement que la génération est achevée. Cela ne signifie pas que le résultat visuel a passé votre contrôle qualité. Vérifiez le début, le milieu et la fin avant d’accepter la séquence.
Vérifiez :
- Visage : l’identité reste-t-elle reconnaissable ?
- Mains : les doigts restent-ils corrects pendant les gestes et les croisements ?
- Pieds : les deux pieds restent-ils stables pendant la marche ou les mouvements du corps entier ?
- Vêtements : les couleurs, les motifs et les silhouettes restent-ils cohérents ?
- Arrière-plan : reste-t-il cohérent avec le mouvement ?
Le point de terminaison de résultats d’AKOOL renvoie la durée réelle, la résolution, les crédits déduits, l’URL de la vidéo finale et, le cas échéant, la raison de l’échec.
Les ressources générées sont valables sept jours. Téléchargez et archivez donc rapidement les résultats approuvés.
Essayez ce processus
Pour accéder à des options de génération plus larges que ce processus API, explorez les outils vidéo IA d’AKOOL.
Pour une autre approche fondée sur des références, consultez le remplacement de personnage avec contrôle du mouvement. Pour préserver les personnages et l’identité visuelle entre plusieurs séquences liées, consultez la cohérence vidéo guidée par des références.
