Wan 2.2 Animate API
Wan 2.2 Animate:给一张角色图和一段参考视频,让图里的角色跟着视频里的人动(animate),或者把视频里的人换成你的角色(replace)。成片长度等于参考视频长度,分辨率 480p 或 720p,按参考视频的秒数计价。
认证
Authorization: Bearer YOUR_API_KEY模型与价格
| 分辨率 | 每秒 | 5 秒参考视频 | 10 秒 | 30 秒 | 画面 |
|---|---|---|---|---|---|
| 480p | $0.0742 | $0.371 | $0.742 | $2.226 | 832x480 |
| 720p (默认) | $0.154 | $0.77 | $1.54 | $4.62 | 1280x720 |
按参考视频的时长计价,不足一秒向上取整(3.5 秒的视频按 4 秒收);建单时就按这个秒数扣,不会事后追加。画幅跟随参考视频,表里是 16:9 参考视频的实际尺寸。失败不扣费。
两种模式
| animate (默认) | 动作驱动:成片里是你图上的角色和背景,动作、表情照着参考视频里的人来。用来让插画、游戏角色、数字人跳舞、说话、做手势。 |
| replace | 角色替换:成片保留参考视频的场景、镜头和动作,只把视频里的人换成你图上的角色。用来把真人镜头换成虚拟角色,或者给已有视频换主角。 |
限制(先看这段)
| 角色图和参考视频都必填 | 角色图收公网 URL 或 base64,不超过 50MB,建议一个人、正面、脸部清晰。参考视频只收公网 https URL(不收 base64、不收需要登录或带过期签名的链接),MP4,不超过 200MB。 |
| 成片长度等于参考视频长度 | 没有 duration 参数。实测 3.54 秒的参考视频出 3.54 秒的成片。参考视频最长 120 秒,超过直接 400。 |
| 读不到视频时长就不建单 | 价格按参考视频的秒数定,所以建单时会先读它的时长。读不到(链接不公开、不是视频、已过期)会立刻返回 400 说明原因,而不是先跑几分钟再失败。 |
| 分辨率只有 480p 和 720p,默认 720p | 不传 resolution 就按 720p 出片并按 720p 计价 —— 要省钱请显式传 480p。没有 1080p。 |
| 成片带参考视频的音轨 | 实测成片保留了参考视频的声音(AAC 立体声),24fps。参考视频没有声音就出无声片。 |
| 出片约两分钟起 | 实测 480p、3.54 秒参考视频 110 秒出片;视频越长、分辨率越高越慢。按异步任务设计你的轮询。 |
代码示例
# ─── Animate: your character follows the motion in the reference video ───
curl -X POST https://api.apimodels.app/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-2.2-animate",
"image": "https://example.com/character.png",
"video": "https://example.com/dance-template.mp4",
"mode": "animate",
"resolution": "480p"
}'
# Response (async — a task is created):
# { "code": 200, "data": { "taskId": "clxxx", "state": "pending" } }
# ─── Replace: swap the person in the video for your character ───
curl -X POST https://api.apimodels.app/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-2.2-animate",
"image": "https://example.com/character.png",
"video": "https://example.com/interview.mp4",
"mode": "replace",
"resolution": "720p",
"prompt": "keep the lighting of the original scene",
"seed": 42
}'
# ─── Poll for the result ──────────────────────────────────
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
# { "code": 200, "data": { "state": "completed", "resultUrls": ["https://r2.apimodels.app/..."] } }请求参数
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| model | 是 | string | wan-2.2-animate |
| image | 是 | string | 角色图:公网图片 URL 或 base64,不超过 50MB。也收 image_url。 |
| video | 是 | string | 参考视频:公网 https MP4 链接,最长 120 秒,不超过 200MB。也收 video_url。 |
| mode | 否 | string | animate(默认)或 replace,见上面「两种模式」。 |
| resolution | 否 | string | 480p 或 720p,默认 720p。 |
| prompt | 否 | string | 可选的风格引导,如光线、动作的细腻程度。不是必需的,不传也能出片。 |
| seed | 否 | number | 随机种子(0 到 2147483647),不传则随机 |
| callback_url | 否 | string | 任务完成后的回调 URL |
适合做什么
| 舞蹈 / 编舞翻跳 | 一张角色图跟着任何舞蹈视频跳。一段 30 秒的 720p 翻跳 $4.62,480p $2.226。 |
| VTuber / 虚拟形象的互动反应 | 预先准备一套参考动作库(挥手、鞠躬、跳一下),粉丝打赏或弹幕触发时按动作生成对应反应;5 秒一段 480p 只要 $0.371。 |
| 给已有素材换主角 | replace 模式保留镜头、场景和动作,把实拍里的人换成虚拟角色 —— 真人素材虚拟化,或者一段视频出多个角色版本。 |
| 数字人 / 动态照片 | 用户上传一张照片或立绘,配一段标准动作视频,就得到一段会动、会做表情的片段;成片保留参考视频的声音,所以用带口播的参考视频就是会说话的数字人。 |
说明
- 异步任务:先建单拿 taskId,再轮询 GET ?task_id= 取结果
- 成片是 H.264 MP4,24fps,画幅和时长都跟参考视频走
- 与 wan-2.2-i2v-spicy / wan-2.7-i2v-spicy 同一个端点、同一把 Key,只换 model 字段
- 结果文件保留 30 天后自动删除,请及时下载或转存
- 失败不扣费
常见问题
Wan 2.2 Animate 多少钱?
按参考视频的秒数计价,不足一秒向上取整:480p $0.0742/秒、720p $0.154/秒。5 秒参考视频 $0.371 或 $0.77,30 秒 $2.226 或 $4.62。建单时就定死,两种模式同价,失败不扣费。
animate 和 replace 有什么区别?
animate 保留你的图(角色和背景),用参考视频里的人的动作和表情去驱动它;replace 保留参考视频(场景、镜头、动作),只把里面的人换成你的角色。默认是 animate。
成片多长?参考视频有什么要求?
成片长度等于参考视频长度,没有 duration 参数。参考视频必须是公网 https 的 MP4 链接,最长 120 秒、不超过 200MB。建单时会先读它的时长,读不到或链接不公开会立刻 400,不会跑几分钟再失败。
成片有声音吗?角色图怎么选?
成片保留参考视频的音轨(实测为 AAC 立体声),24fps;参考视频没有声音就出无声片。角色图建议一个人、正面、脸部清晰无遮挡,公网 URL 或 base64,不超过 50MB。