Wan 2.2 Animate：角色图像与动作参考指南

Wan 2.2 Animate 将角色图像与提供动作的源视频结合起来。在 AKOOL 文档中的 Character Swap API 工作流中，图像指导角色外观，源 MP4 提供表演动作。API 响应示例将底层模型标识为 wavespeed-ai/wan-2.2/animate。

AKOOL 通过 Character Swap API 提供这一能力。这与从AI 视频工具列表中选择通用的文生视频模型不同。

要点速览

• 外观来自图像：上传 PNG 或 JPEG 格式的角色图像。
• 动作来自视频：提供包含待迁移表演动作的 MP4 视频。
• Animate 和 replace 是不同的 API 模式：animate 将动作迁移到角色图像，replace 则执行该端点文档所述的面部替换。
• 保存任务 ID：生成过程是异步的，使用返回的 _id 查询状态，并在有效期为七天的链接到期前下载成片。

目录

1. 什么是 Wan Animate？
2. animate 与 replace 模式有何区别？
3. 如何准备动作参考视频？
4. 如何通过 AKOOL 使用 Wan Animate API？
5. 哪些提示词有助于角色动画？
6. AI 角色动作迁移为何会失败？
7. 如何审核并保存输出？
8. 常见问题

什么是 Wan Animate？

Wan Animate 是由参考素材驱动的角色动画工作流：一张图像定义角色外观，一段源视频提供待应用的动作。在 AKOOL 的 Character Swap API 中，文档所述的 animate 模式会结合这两项输入，也可选择使用简短文字提示词指导结果。

将其理解为三项素材会更直观：

AKOOL 创建端点要求提供 PNG 或 JPEG 角色图像的 URL，以及 MP4 源视频的 URL。API 响应示例将模型标识为 wavespeed-ai/wan-2.2/animate，因此该模型名称有 API 层面的依据，但不能据此断定公开网站上存在同名菜单选项。

animate 与 replace 模式有何区别？

在 AKOOL 文档所述的端点中，animate 将源视频动作应用于角色图像。replace 是另一种模式，使用提供的角色图像替换源视频中的面部。这些定义适用于此 AKOOL API 端点，并非所有使用 Wan 模型系列的产品。

未指定模式时，该端点默认为 animate。

这一差别很重要，因为 animate 与 replace 描述的是两种不同的转换。如果你的目标是完整的 AI 角色动作迁移，请从 animate 开始。

如需了解基于 Kling 的另一套制作流程，请参阅 AKOOL 的带动作控制的角色替换指南。Kling 2.6 同样采用角色图像与参考表演相结合的思路，但模型和工作流不同。

如何准备动作参考视频？

选择清晰的参考表演，使其取景和身体覆盖范围与角色图像匹配。参考素材越清楚，就越容易判断问题来自源素材还是生成过程。

匹配取景范围

如果动作视频展示的是全身行走，角色图像也应提供足够的全身信息。

将近景肖像与跑步、舞蹈或大幅腿部动作配对，会迫使模型补全图像中从未出现的身体结构。

为了增强参考素材引导的视频一致性，AKOOL 建议使用清晰主体、可见的身份细节，以及明确体现待保留元素的参考素材。

确保表演者始终可见

选择表演者始终位于画面内的动作参考。

避免使用以下源片段：

• 脚部反复移出画面，
• 手部消失在身体后方，
• 其他人从主体前方经过，
• 镜头突然重新构图，
• 表演者在画面中变得很小。

减少遮挡

交叉的手臂、隐藏的手部、遮住躯干的道具，以及快速转身，都会让表演迁移更难审核。

更好的参考：全身可见、动作适中、镜头稳定。

更难处理的参考：脚部被裁切、反复旋转、手部被道具遮挡、存在多次剪辑。

如何通过 AKOOL 使用 Wan Animate API？

向 AKOOL 的 Character Swap 创建端点发送角色图像 URL 和源 MP4 URL，将 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."
  }'

重要字段如下：

这些值是该端点文档规定的参数，并非适用于所有平台的通用 Wan 限制。响应中包含 _id，请保存。

查询任务：

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

任务状态如下：

• 1：排队中
• 2：处理中
• 3：已完成
• 4：失败

当状态达到 3 时，生成视频的 URL 会出现在 video 字段中。

哪些提示词有助于角色动画？

将文字视为指导，而非表演的来源。动作参考应决定实际动作。提示词应强化角色身份、取景和简洁性，避免要求与源视频冲突的运动。

1. 简单手势

将参考视频中缓慢打招呼的手势应用于提供的角色。保持服装和发型不变，使用流畅的动作。

2. 主持人

跟随参考表演者的手部动作和节奏。让角色始终面向镜头，避免添加额外手势。

3. 行走

跟随提供的行走循环。保持角色的身体比例和服装，并让双脚始终可见。

4. 风格化角色

根据参考视频的节奏，让提供的插画角色动起来。保留其平涂色彩和绘制轮廓。

5. 修复提示词

使用同一个角色和更慢、未经裁切的参考片段。保持动作简单，并让全身位于画面内。

不要将这些示例当作万能语法。它们只是对视频已经提供的表演动作添加可选的范围约束。

AI 角色动作迁移为何会失败？

大多数明显问题源于输入素材匹配不足，或动作要求模型重建角色图像中缺失的信息。增加提示词描述前，先修正这对源素材。

动作参考可以减少猜测，但无法保证角色完全不变。因此，输入准备与提示词同样重要。

如何审核并保存输出？

API 任务完成只意味着生成已结束，并不代表视觉结果通过质量审核。接受片段前，请检查开头、中间和结尾。

检查以下项目：

• 面部：角色身份是否仍然清晰可辨？
• 手部：在手势和交叉动作中，手指是否保持完整？
• 脚部：在行走或全身动作中，双脚是否稳定？
• 服装：颜色、图案和轮廓是否保持一致？
• 背景：是否与运动保持连贯？

AKOOL 结果端点会返回实际时长、分辨率、扣除的积分、最终视频 URL，以及适用时的失败原因。

生成资源的有效期为七天，请及时下载并归档已批准的输出。

试用这一工作流

如果需要此 API 工作流之外的更多生成选项，请探索 AKOOL 的 AI 视频工具。

另一种参考驱动方法请参阅带动作控制的角色替换。有关在相关片段中保持角色和视觉身份的指导，请参阅参考素材引导的视频一致性。