Wan 2.2 Animate combina una imagen de personaje con un vídeo de origen que aporta el movimiento. En el flujo documentado de la API Character Swap de AKOOL, la imagen determina la apariencia del personaje y el MP4 de origen proporciona la actuación. El ejemplo de respuesta de la API identifica el modelo subyacente como wavespeed-ai/wan-2.2/animate.
AKOOL ofrece esta función a través de su API Character Swap. Esto es distinto de seleccionar un modelo genérico de texto a vídeo de una lista de herramientas de vídeo con IA.
Resumen
- La apariencia procede de la imagen: sube una imagen de personaje en PNG o JPEG.
- El movimiento procede del vídeo: proporciona un MP4 con la actuación que deseas transferir.
- Animate y replace son modos de API distintos:
animatetransfiere el movimiento a la imagen del personaje, mientras quereplacerealiza la sustitución de rostros documentada para este endpoint. - Guarda el ID de la tarea: la generación es asíncrona; utiliza el
_iddevuelto para consultar el estado y descargar el vídeo terminado antes de que su URL caduque a los siete días.
Índice
- ¿Qué es Wan Animate?
- ¿En qué se diferencian los modos animate y replace?
- ¿Cómo se prepara un vídeo de referencia de movimiento?
- ¿Cómo se utiliza la API Wan Animate a través de AKOOL?
- ¿Qué prompts ayudan a animar personajes?
- ¿Por qué falla la transferencia de movimiento de personajes con IA?
- ¿Cómo se revisa y guarda el resultado?
- Preguntas frecuentes
¿Qué es Wan Animate?
Wan Animate es un flujo de animación de personajes basado en referencias: una imagen define la apariencia del personaje y un vídeo de origen aporta el movimiento que se aplicará. En la API Character Swap de AKOOL, el modo documentado animate combina ambas entradas y puede utilizar opcionalmente un prompt breve para orientar el resultado.
El flujo se entiende mejor si se considera como tres recursos:
| 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 |
El endpoint de creación de AKOOL requiere la URL de una imagen de personaje en PNG o JPEG y la URL de un vídeo de origen en MP4. El ejemplo de respuesta de la API identifica el modelo como wavespeed-ai/wan-2.2/animate, por lo que ese nombre está respaldado por evidencia específica de la API. Esto no demuestra que el sitio web público ofrezca una opción de menú con el mismo nombre.
¿En qué se diferencian los modos animate y replace?
En el endpoint documentado de AKOOL, animate aplica el movimiento del vídeo de origen a la imagen del personaje. replace es otro modo que sustituye los rostros del vídeo de origen mediante la imagen de personaje proporcionada. Estas definiciones corresponden a este endpoint de la API de AKOOL, no a todos los productos que utilizan la familia de modelos 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 |
El endpoint utiliza animate de forma predeterminada cuando no se especifica ningún modo.
Esta distinción importa porque animate frente a replace describe dos transformaciones diferentes. Si buscas una transferencia de movimiento de personajes con IA completa, empieza con animate.
Para conocer un flujo de producción independiente basado en Kling, consulta la guía de AKOOL sobre sustitución de personajes con control de movimiento. Kling 2.6 parte de la misma idea general de combinar una imagen de personaje con una actuación de referencia, pero utiliza un modelo y un flujo diferentes.
¿Cómo se prepara un vídeo de referencia de movimiento?
Utiliza una actuación de origen clara cuyo encuadre y cobertura del cuerpo coincidan con los de la imagen del personaje. Cuanto más clara sea la referencia, más fácil será determinar si los errores proceden del material de origen o de la generación.
Haz coincidir el encuadre
Si el vídeo de movimiento muestra a alguien caminando de cuerpo entero, utiliza una imagen de personaje que también proporcione suficiente información del cuerpo completo.
Un retrato cerrado combinado con carreras, bailes o movimientos amplios de piernas obliga al modelo a inventar una anatomía que la imagen nunca mostró.
Para conseguir una mayor coherencia de vídeo basada en referencias, AKOOL recomienda sujetos claros, detalles de identidad visibles y recursos de referencia que definan los elementos que deseas conservar.
Mantén visible al intérprete
Elige una referencia de movimiento en la que el intérprete permanezca dentro del encuadre.
Evita los clips de origen en los que:
- los pies salen repetidamente del encuadre,
- las manos desaparecen detrás del cuerpo,
- otra persona pasa por delante del sujeto,
- la cámara cambia de encuadre de repente,
- el intérprete aparece muy pequeño.
Reduce las oclusiones
Los brazos cruzados, las manos ocultas, los objetos que cubren el torso y los giros rápidos dificultan la revisión de la transferencia de la actuación.
Mejor referencia: cuerpo completo visible, movimiento moderado y cámara estable.
Referencia más difícil: pies recortados, giros repetidos, manos ocultas tras objetos y múltiples cortes.
¿Cómo se utiliza la API Wan Animate a través de AKOOL?
Envía la URL de una imagen de personaje y la URL de un MP4 de origen al endpoint de creación de Character Swap de AKOOL, establece mode en animate, añade opcionalmente un prompt y guarda el _id devuelto. Utiliza ese identificador en el endpoint de resultados hasta que la tarea alcance el estado completed.
El endpoint de creación documentado es:
POST https://openapi.akool.com/api/open/v4/characterSwap/create
AKOOL acepta tanto un encabezado x-api-key como autorización Bearer.
Consulta las instrucciones oficiales de la API Character Swap para obtener los detalles actuales de autenticación y del endpoint.
Ejemplo de solicitud con datos sensibles ocultos
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."
}'
Los campos importantes son:
| 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 |
Estos valores son parámetros documentados del endpoint, no límites generales de Wan para todas las plataformas. La respuesta incluye un _id. Guárdalo.
Para consultar la tarea:
GET https://openapi.akool.com/api/open/v3/content/video/infobymodelid?video_model_id=YOUR_TASK_ID
Los estados de la tarea son:
1: en cola2: en procesamiento3: completada4: fallida
Cuando el estado alcanza 3, la URL generada aparece en el campo video.
¿Qué prompts ayudan a animar personajes?
Considera el texto como una orientación, no como el origen de la actuación. La referencia de movimiento debe definir la acción. El prompt debe reforzar la identidad, el encuadre y la sencillez, en lugar de exigir movimientos que contradigan el vídeo de origen.
1. Gesto sencillo
Aplica al personaje proporcionado el gesto lento de saludo del vídeo de referencia. Conserva la misma ropa y el mismo cabello. Utiliza movimientos fluidos.
2. Presentador
Sigue el movimiento de las manos y el ritmo del intérprete de referencia. Mantén al personaje mirando a la cámara. Evita añadir gestos adicionales.
3. Caminata
Sigue el ciclo de caminata proporcionado. Mantén las proporciones y la vestimenta del personaje. Conserva ambos pies visibles.
4. Personaje estilizado
Anima el personaje ilustrado proporcionado siguiendo el ritmo de la referencia. Conserva sus colores planos y sus contornos dibujados.
5. Prompt de corrección
Utiliza el mismo personaje y un clip de referencia más lento y sin recortes. Mantén el movimiento sencillo y el cuerpo completo dentro del encuadre.
No consideres estos ejemplos una sintaxis mágica. Son restricciones opcionales que delimitan una actuación ya proporcionada por el vídeo.
¿Por qué falla la transferencia de movimiento de personajes con IA?
La mayoría de los fallos visibles se deben a una mala correspondencia entre las entradas o a movimientos que obligan al modelo a reconstruir información ausente en la imagen del personaje. Corrige primero la pareja de archivos de origen antes de añadir más instrucciones al 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 |
Una referencia de movimiento puede reducir las suposiciones, pero no garantiza una conservación perfecta del personaje. Por eso, preparar los archivos de entrada importa tanto como el prompt.
¿Cómo se revisa y guarda el resultado?
Que una tarea de API esté completada solo significa que la generación ha terminado. No significa que el resultado visual haya superado tu control de calidad. Revisa el principio, la parte central y el final antes de aceptar el clip.
Comprueba:
- Rostro: ¿La identidad sigue siendo reconocible?
- Manos: ¿Los dedos se conservan correctamente durante los gestos y cruces?
- Pies: ¿Ambos pies se mantienen estables al caminar o durante los movimientos de cuerpo completo?
- Ropa: ¿Los colores, los estampados y las siluetas se mantienen coherentes?
- Fondo: ¿Se mantiene coherente con el movimiento?
El endpoint de resultados de AKOOL devuelve la duración real, la resolución, los créditos descontados, la URL del vídeo final y, cuando corresponde, el motivo del fallo.
Los recursos generados tienen una validez de siete días; descarga y archiva cuanto antes los resultados aprobados.
Prueba el flujo de trabajo
Si necesitas opciones de generación más amplias que las de este flujo de API, explora las herramientas de vídeo con IA de AKOOL.
Para conocer otro enfoque basado en referencias, lee sustitución de personajes con control de movimiento. Si buscas orientación para conservar los personajes y la identidad visual entre clips relacionados, consulta coherencia de vídeo basada en referencias.
