Wan 2.2 Animate API

Wan 2.2 Animate превращает утверждённое изображение персонажа и отдельный референс движения в новый клип, где этот персонаж играет сцену. Используйте его, когда внешность и движение уже заданы в разных материалах и не нужно требовать и то и другое от одного источника.

Режимов два. При animation_mode, равном animate, персонаж с вашего изображения двигается так, как в управляющем видео; при replace человек в управляющем видео заменяется тем, кто на вашем изображении, а сцена видео сохраняется. Результат длится столько же, сколько управляющее видео, — от 2 до 30 секунд, в 480p или 720p.

Чистая A-поза важнее длинного промпта

Опубликованное референсное изображение — именно то, что нужно этому эндпоинту: фигура в кадре целиком, нейтральная A-поза, бесшовный фон, ровный свет. Весь облик результата берётся из этого изображения. Обрезанное или сильно перекрытое изображение ограничивает каждый клип, который вы из него сделаете, и никакой промпт это не исправит.

Клип длится столько же, сколько исходник, до 30 секунд

Результат длится столько же, сколько управляющее видео, а оно должно быть от 2 до 30 секунд, поэтому двухминутный исходник сначала нужно обрезать. Оплата идёт за фактически выданные секунды, а не за предел, использованный в оценке, так что обрезка управляющего видео перед загрузкой — прямой способ контролировать расходы.

Проверьте сходство в 480p, прежде чем платить за 720p

Опубликованный клип — то же изображение, приведённое в движение референсным видео: тот же бордовый топ, те же широкие брюки, теперь в середине поворота. Разрешение — это ценовой уровень, и 720p стоит дороже за секунду, чем 480p, поэтому сначала проверьте в 480p на самом коротком пригодном управляющем видео, сохраняются ли узнаваемость и силуэт.

Персонаж в уже снятом материале

При animation_mode, равном replace, человек в управляющем видео заменяется персонажем с вашего изображения, а материал сохраняет собственную сцену. Используйте это, когда локация уже есть на видео и сменить нужно только исполнителя.

Короткие лупы из одного листа персонажа

До 30 секунд хватает на луп для ленты, стикер или клип-реакцию. Оставьте одно изображение и меняйте управляющие видео, чтобы собрать библиотеку жестов — взмах рукой, поворот, пожатие плечами, — которые читаются как один и тот же персонаж, потому что у них общее референсное изображение.

Танцевальные и сценические номера

Изображение персонажа плюс управляющее видео с нужным номером: одежду и телосложение фиксирует изображение, а темп, вес и камера берутся из съёмки. Ограничение здесь — права: вам нужны права и на изображение, и на управляющее видео, и вы отвечаете за то, как используется результат.

Проверка изображения перед длинным рендером

Сделайте пятисекундный перенос в 480p, чтобы увидеть, сохраняет ли новое изображение персонажа лицо, руки и силуэт в движении. Это самый дешёвый способ отбраковать неудачное изображение, прежде чем тратить на него полноценную 30-секундную задачу.

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

Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.