Wan 2.2 Animate API

Wan 2.2 Animate convierte una imagen de personaje aprobada y una referencia de movimiento separada en un clip nuevo con la actuación de ese personaje. Úsalo cuando la apariencia y el movimiento ya están decididos en materiales distintos, en lugar de pedirle ambas cosas a una sola fuente.

Funciona en dos modos. Con animation_mode en animate, el personaje de tu imagen se mueve con el movimiento del video guía; con replace, la persona del video guía se cambia por la de tu imagen y se conserva la escena del video. El resultado dura lo mismo que el video guía, de 2 a 30 segundos, en 480p o 720p.

Una pose en A limpia vale más que un prompt largo

La imagen de referencia publicada es justo el tipo de imagen que necesita este endpoint: cuerpo completo en cuadro, pose neutra en A, fondo continuo y luz pareja. Todo el aspecto del resultado sale de esa imagen. Una imagen recortada o muy tapada limita cada clip que hagas con ella, y ningún prompt lo recupera.

El clip dura lo mismo que la fuente, hasta 30 segundos

El resultado dura lo mismo que el video guía, que debe durar de 2 a 30 segundos, así que una fuente de dos minutos hay que recortarla antes. El cobro sigue los segundos entregados y no el máximo usado para la cotización, por lo que recortar el video guía antes de subirlo es la forma directa de controlar el costo.

Comprueba el parecido en 480p antes de pagar 720p

El clip publicado es esa misma imagen guiada por un video de referencia: la misma blusa color vino, el mismo pantalón de pierna ancha, ahora a mitad de un giro. La resolución es un nivel de precio y 720p cuesta más por segundo que 480p, así que confirma primero en 480p, con el video guía más corto que sirva, que la identidad y la silueta se mantienen.

Pon a tu personaje en un material existente

Con animation_mode en replace, la persona del video guía se cambia por el personaje de tu imagen mientras el material conserva su propia escena. Úsalo cuando la locación ya existe en video y solo hay que cambiar a quien actúa.

Loops cortos a partir de una hoja de personaje

Hasta 30 segundos alcanzan para un loop de feed, un sticker o un clip de reacción. Conserva una imagen y cambia los videos guía para armar una biblioteca de gestos, como un saludo, un giro o un encogimiento de hombros, que se reconocen como el mismo personaje porque comparten la misma imagen de referencia.

Coreografías y rutinas de actuación

Una imagen de personaje más un video guía de la rutina que quieres: el vestuario y la complexión los fija la imagen, mientras el ritmo, el peso y la cámara vienen del material. El límite lo pone la propiedad: necesitas los derechos de la imagen y del video guía, y eres responsable del uso del resultado.

Prueba una imagen antes de un render más largo

Haz una transferencia de cinco segundos en 480p para ver si una imagen de personaje nueva mantiene el rostro, las manos y la silueta en movimiento. Es la forma más económica de descartar una mala imagen antes de usarla en un trabajo completo de 30 segundos.

# 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"

Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.