动作迁移 / 人物替换 · 双路径
动作迁移 / 人物替换 · 双路径可选
同一能力提供两条路径,用同一把 API Key 均可调用,按效果与预算自选(也可同时使用):
| 路径 A · 标准版(应用类) | 路径 B · Pro 版(百炼万相) | |
|---|---|---|
| 入口 | POST /api/v1/apps/action_transfer/submit<br>POST /api/v1/apps/person_replacement/submit | POST /api/v1/services/aigc/video-generation/video-synthesis |
| 模型 | 应用 action_transfer / person_replacement | wan2.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 / max | level = 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_url | string / array | 是 | 参考人物图片,多图参考传数组 |
video_url | string | 是 | 输入视频(也是计费时长来源) |
prompt | string | 否 | 动作 / 人物 / 场景补充描述 |
mode | string | 否 | fast(1点/秒) / standard(2点/秒,默认) / max(3点/秒) |
face_count | integer | 否 | 处理人数 1~7,默认 1 |
duration | number | 否 | 输入视频秒数,通常不传由平台探测 |
详细字段与完整示例见文档中心「应用系列」:动作迁移、人物替换。
路径 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:动作迁移,std40 点/秒 ·pro60 点/秒wan2.2-animate-mix:人物替换 / 视频换人,std60 点/秒 ·pro90 点/秒- 提交后返回
task_id,用GET /api/v1/tasks/{task_id}轮询;SUCCEEDED后按实际时长结算
选型建议
- 大批量、预算敏感(短剧混剪、批量换人)→ 路径 A(1~3 点/秒,成本低一个数量级);
- 成片质量优先、人物一致性要求高 → 路径 B(万相 Pro,官方直连);
- 两者可同时开通,同一把 Key 直接切换,无需改代码鉴权。