Wan 2.2 Animate: руководство по изображению персонажа и референсу движения

Updated:

October 19, 2026

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

Оглавление

Wan 2.2 Animate объединяет изображение персонажа с исходным видео, задающим движение. В описанном AKOOL процессе Character Swap API изображение определяет внешность персонажа, а исходный MP4 — его действия. В примере ответа API базовая модель обозначена как wavespeed-ai/wan-2.2/animate.

AKOOL предоставляет эту возможность через Character Swap API. Это отличается от простого выбора универсальной модели генерации видео из текста в списке инструментов ИИ-видео.

Кратко

Внешность задается изображением: загрузите изображение персонажа в PNG или JPEG.
Движение задается видео: предоставьте MP4 с действиями, которые нужно перенести.
Animate и replace — разные режимы API: animate переносит движение на изображение персонажа, а replace выполняет описанную для этой конечной точки замену лица.
Сохраните ID задачи: генерация асинхронна, поэтому используйте полученный _id для проверки статуса и скачайте готовое видео до истечения семидневного срока действия ссылки.

Содержание

Что такое Wan Animate?
Чем отличаются режимы animate и replace?
Как подготовить видео с референсом движения?
Как использовать Wan Animate API через AKOOL?
Какие запросы помогают анимации персонажей?
Почему перенос движения ИИ-персонажа дает сбои?
Как проверить и сохранить результат?
Часто задаваемые вопросы

Что такое Wan Animate?

Wan Animate — процесс анимации персонажей на основе референсов: одно изображение определяет внешность персонажа, а исходное видео задает применяемое движение. В Character Swap API AKOOL документированный режим animate объединяет эти материалы и при необходимости использует короткий текстовый запрос для уточнения результата.

Процесс проще понять как три материала:

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

Конечная точка создания AKOOL требует URL изображения персонажа в PNG или JPEG и URL исходного видео в MP4. В примере ответа API модель обозначена как wavespeed-ai/wan-2.2/animate, что подтверждает это название именно для API. Это не доказывает, что на публичном сайте есть пункт меню с таким же названием.

Чем отличаются режимы animate и replace?

В документированной конечной точке AKOOL режим animate применяет движение исходного видео к изображению персонажа. replace — другой режим, заменяющий лица в исходном видео с помощью предоставленного изображения персонажа. Эти определения относятся к данной конечной точке API AKOOL, а не ко всем продуктам семейства моделей 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

Если режим не указан, конечная точка по умолчанию использует animate.

Это важно, поскольку animate и replace описывают два разных преобразования. Если ваша цель — полный перенос движения ИИ-персонажа, начните с animate.

Отдельный производственный процесс на базе Kling описан в руководстве AKOOL по замене персонажа с управлением движением. Kling 2.6 использует ту же общую идею объединения изображения персонажа с референсным исполнением, но это другая модель и другой процесс.

Как подготовить видео с референсом движения?

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

Согласуйте кадрирование

Если видео движения показывает ходьбу в полный рост, изображение персонажа также должно содержать достаточно информации о всем теле.

Крупный портрет в сочетании с бегом, танцем или активными движениями ног вынуждает модель придумывать анатомию, которой не было на изображении.

Для более высокой согласованности видео на основе референсов AKOOL рекомендует четкие объекты, видимые характерные детали и референсные материалы, определяющие элементы, которые нужно сохранить.

Сохраняйте исполнителя в кадре

Выбирайте референс движения, в котором исполнитель остается внутри кадра.

Избегайте исходных роликов, где:

ступни постоянно выходят за границы кадра,
руки исчезают за телом,
другой человек проходит перед объектом,
камера резко меняет кадрирование,
исполнитель становится очень маленьким.

Сведите перекрытия к минимуму

Скрещенные руки, скрытые кисти, закрывающий торс реквизит и быстрые повороты затрудняют оценку переноса движений.

Лучший референс: все тело видно, движения умеренные, камера стабильна.

Более сложный референс: обрезанные ступни, повторяющиеся вращения, кисти за реквизитом, несколько монтажных склеек.

Как использовать Wan Animate API через AKOOL?

Отправьте URL изображения персонажа и исходного MP4 в конечную точку создания Character Swap AKOOL, установите mode в animate, при необходимости добавьте запрос и сохраните полученный _id. Используйте его в конечной точке результатов, пока задача не достигнет completed.

Документированная конечная точка создания:

POST https://openapi.akool.com/api/open/v4/characterSwap/create

AKOOL принимает заголовок x-api-key или авторизацию Bearer.

Актуальные сведения об аутентификации и конечных точках смотрите в официальных инструкциях Character Swap API.

Пример запроса со скрытыми данными

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."
  }'

Важные поля:

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

Это документированные параметры конечной точки, а не общие ограничения Wan на всех платформах. Ответ содержит _id. Сохраните его.

Чтобы проверить задачу:

GET https://openapi.akool.com/api/open/v3/content/video/infobymodelid?video_model_id=YOUR_TASK_ID

Состояния задачи:

1: в очереди
2: обработка
3: завершена
4: ошибка

Когда статус достигнет 3, ссылка на результат появится в поле video.

Какие запросы помогают анимации персонажей?

Считайте текст подсказкой, а не источником действий. Референс движения должен определять действие. Запрос должен поддерживать узнаваемость, кадрирование и простоту, а не требовать движений, противоречащих исходному видео.

1. Простой жест

Примени медленный приветственный жест из референсного видео к предоставленному персонажу. Сохрани одежду и прическу. Используй плавные движения.

2. Ведущий

Следуй движениям рук и темпу исполнителя из референса. Сохраняй персонажа лицом к камере. Не добавляй лишних жестов.

3. Ходьба

Следуй предоставленному циклу ходьбы. Сохрани пропорции и одежду персонажа. Обе ступни должны оставаться видимыми.

4. Стилизованный персонаж

Анимируй предоставленного рисованного персонажа, соблюдая ритм референса. Сохрани его плоские цвета и нарисованные контуры.

5. Запрос для исправления

Используй того же персонажа и более медленный референсный ролик без обрезки. Сохрани простые движения и все тело в кадре.

Не считайте эти запросы магическим синтаксисом. Это необязательные ограничения для действий, уже заданных видео.

Почему перенос движения ИИ-персонажа дает сбои?

Большинство видимых ошибок связано с плохим соответствием исходных материалов или движениями, вынуждающими модель восстанавливать недостающую на изображении персонажа информацию. Исправьте пару исходных материалов, прежде чем усложнять запрос.

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

Референс движения снижает неопределенность, но не гарантирует идеальное сохранение персонажа. Поэтому подготовка материалов так же важна, как и запрос.

Как проверить и сохранить результат?

Завершенная задача API означает лишь окончание генерации. Это не означает, что визуальный результат прошел проверку качества. Перед приемкой просмотрите начало, середину и конец ролика.

Проверьте:

Лицо: сохраняется ли узнаваемость?
Кисти: сохраняются ли пальцы при жестах и пересечениях?
Ступни: стабильны ли обе ступни при ходьбе и движениях всего тела?
Одежда: сохраняются ли цвета, узоры и силуэты?
Фон: остается ли он согласованным с движением?

Конечная точка результатов AKOOL возвращает фактическую длительность, разрешение, списанные кредиты, итоговый URL видео и, при наличии, причину ошибки.

Сгенерированные материалы доступны семь дней, поэтому своевременно скачивайте и архивируйте одобренные результаты.

Попробуйте этот процесс

Если нужны более широкие возможности генерации за пределами этого API-процесса, изучите инструменты ИИ-видео AKOOL.

О другом подходе на основе референсов читайте в статье замена персонажа с управлением движением. Рекомендации по сохранению персонажей и визуальной идентичности в связанных роликах доступны в статье согласованность видео на основе референсов.

Часто задаваемые вопросы