动作迁移 / 人物替换 · 双路径

动作迁移 / 人物替换 · 双路径可选

同一能力提供两条路径,用同一把 API Key 均可调用,按效果与预算自选(也可同时使用):

路径 A · 标准版(应用类)路径 B · Pro 版(百炼万相)
入口POST /api/v1/apps/action_transfer/submit<br>POST /api/v1/apps/person_replacement/submitPOST /api/v1/services/aigc/video-generation/video-synthesis
模型应用 action_transfer / person_replacementwan2.2-animate-move(动作迁移)<br>wan2.2-animate-mix(人物替换)
价格fast 1 点/秒 · standard 2 点/秒 · max 3 点/秒std 40 / 60 点/秒 · pro 60 / 90 点/秒
计费依据输入视频时长(可传 duration,不传自动探测)生成时长(seconds,默认 5 秒)
档位字段mode = fast / standard / maxlevel = std / pro
多人物face_count 1~7单主体
查询POST /api/v1/apps/{app}/query 或 GET /api/v1/tasks/{task_id}GET /api/v1/tasks/{task_id}
适合批量、低成本、快速出片质量优先、换人精细、官方直连

两条路径都是先冻结点数、完成后按实际时长结算,失败自动全额退回。


路径 A · 标准版(应用类,1~3 点/秒)

动作迁移

POST /api/v1/apps/action_transfer/submit
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
{
  "type": "action_transfer",
  "file_url": "https://example.com/person.png",
  "video_url": "https://example.com/input.mp4",
  "prompt": "一个女生在跳舞",
  "mode": "standard",
  "face_count": 1
}

人物替换

{
  "type": "person_replacement",
  "file_url": ["https://example.com/person-1.png", "https://example.com/person-2.png"],
  "video_url": "https://example.com/input.mp4",
  "prompt": "一个女生在跳舞",
  "mode": "max",
  "face_count": 2
}
参数类型必填说明
file_urlstring / array是参考人物图片,多图参考传数组
video_urlstring是输入视频(也是计费时长来源)
promptstring否动作 / 人物 / 场景补充描述
modestring否fast(1点/秒) / standard(2点/秒,默认) / max(3点/秒)
face_countinteger否处理人数 1~7,默认 1
durationnumber否输入视频秒数,通常不传由平台探测

详细字段与完整示例见文档中心「应用系列」:动作迁移、人物替换。


路径 B · Pro 版(百炼万相,官方直连)

{
  "model": "wan2.2-animate-mix",
  "image_url": "https://example.com/person.png",
  "video_url": "https://example.com/motion.mp4",
  "prompt": "保持人物特征,替换视频中的主角",
  "level": "pro",
  "seconds": 5
}
  • wan2.2-animate-move:动作迁移,std 40 点/秒 · pro 60 点/秒
  • wan2.2-animate-mix:人物替换 / 视频换人,std 60 点/秒 · pro 90 点/秒
  • 提交后返回 task_id,用 GET /api/v1/tasks/{task_id} 轮询;SUCCEEDED 后按实际时长结算

选型建议

  • 大批量、预算敏感(短剧混剪、批量换人)→ 路径 A(1~3 点/秒,成本低一个数量级);
  • 成片质量优先、人物一致性要求高 → 路径 B(万相 Pro,官方直连);
  • 两者可同时开通,同一把 Key 直接切换,无需改代码鉴权。

同类文章