万相-视频换人
更新时间 2026-09-06 17:31:51
最近更新时间: 2026-09-06 17:31:51
本文介绍万相视频换人模型调用API。
模型简介
wan2.2‑animate‑mix(万相‑视频换人模型),支持基于一张人物参考图片与一段参考视频,将视频内主体人物替换为图片中的人物形象,完整保留原视频的动作、表情、场景、光照、色调,实现视频角色无缝替换。
支持的模型
| 模型 | 说明 |
|---|---|
| wan2.2‑animate‑mix | 万相‑视频换人,视频角色替换模型,必传此 model 名称 |
调用流程
接口采用异步任务模式,分两步执行:
step1:调用创建任务接口,成功返回task_id
step2:调用查询任务接口查询对应task_id,直到task_status值为SUCCEEDED,获取生成视频url
创建任务接口详情
http调用
请求方式:POST
请求路径:https://ai.ctaigw.cn/v1/services/aigc/image2video/video-synthesis
请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| Content‑Type | 是 | 固定application/json |
| Authorization | 是 | Bearer ${YOUR_APP_KEY} |
| X‑DashScope‑Async | 是 | 必须enable |
请求参数
| 参数名 | 类型 | 是否必选 | 说明 |
|---|---|---|---|
| model | string | 必选 | 模型调用名称或模型ID |
| input | object | 必选 | 输入素材对象 |
| input.image_url | string | 必选 | 人物参考图片公网 HTTP/HTTPS URL。 格式:JPG/JPEG/PNG/BMP/WEBP; 尺寸:宽高 [200,4096] px,宽高比 1:3 ~ 3:1;大小≤5MB; 链接不能含中文,本地文件需先上传获取临时 URL |
| input.video_url | string | 必选 | 参考视频公网 HTTP/HTTPS URL。 格式:MP4、AVI、MOV; 尺寸:宽高 [200,2048] px,宽高比 1:3 ~3:1; 大小≤200MB;时长 2‑30s; 链接不能含中文 |
| input.watermark | bool | 可选 | 是否添加水印标识,水印位于视频右下角,文案固定为“AI生成”。 - false:默认值,不添加水印。 - true:添加水印。 |
| parameters | object | 必选 | 模型业务参数 |
| parameters.mode | string | 必选 | 服务模式:wan‑std标准模式 / wan‑pro专业模式 |
| parameters.check_image | bool | 可选 | 是否前置校验输入图片,默认true; false跳过图片校验直接推理 |
响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
| request_id | string | 请求唯一标识,用于问题排查溯源 |
| output | object | 任务输出主体 |
| output.task_id | string | 查询的任务 ID |
| output.task_status | string | 任务状态 - PENDING:任务排队中 - RUNNING:任务处理中 - SUCCEEDED:任务执行成功 - FAILED:任务执行失败 - CANCELED:任务已取消 - UNKNOWN:任务不存在或状态未知 |
查询任务接口详情
http调用
请求方式:GET
请求路径:https://ai.ctaigw.cn/v1/tasks/{task_id}
Path 路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 创建异步任务接口返回的任务 ID |
请求头
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | 身份认证,格式:Bearer ${YOUR_APP_KEY} |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| request_id | string | 请求唯一标识 |
| output | object | 任务详情 |
| output.task_id | string | 任务 ID |
| output.task_status | string | 任务状态 - PENDING:任务排队中 - RUNNING:任务处理中 - SUCCEEDED:任务执行成功 - FAILED:任务执行失败 - CANCELED:任务已取消 - UNKNOWN:任务不存在或状态未知 |
| output.submit_time | string | 任务提交时间 YYYY‑MM‑DD HH:mm:ss.SSS |
| output.scheduled_time | string | 任务调度执行时间 |
| output.end_time | string | 任务结束时间 |
| output.results | object | 输出结果,仅 SUCCEEDED 返回 |
| output.results.video_url | string | 生成 MP4 (H.264) 视频临时 URL,有效期 24h |
| usage | object | 计费用量信息,任务成功返回 |
| usage.video_duration | float | 输出视频时长(秒) |
| usage.video_ratio | string | 本次请求使用的服务模式。选择标准模式wan-std时返回standard,选择专业模式wan-pro时返回pro |
请求/响应示例
创建任务示例
请求示例
curl --location 'https://ai.ctaigw.cn/v1/services/aigc/image2video/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer ${YOUR_APP_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.2-animate-mix",
"input": {
"image_url": "https://aaaa.ctyun.cn/pic/001.jpeg",
"video_url": "https://aaaa.ctyun.cn/video/001.mp4",
"watermark": true
},
"parameters": {
"mode": "wan-std"
}
}'正常响应
{
"output": {
"task_status": "PENDING",
"task_id": "xxxx‑xxxx‑xxxx‑xxxx"
},
"request_id": "00d06a841873c0a83bfaf1fae0184625"
}异常响应示例
{
"error": {
"type:": "Invalid_request",
"code": "missing_parameter",
"message": "Missing required parameters"
}
}查询任务请求示例
请求
curl -X GET https://ai.ctaigw.cn/v1/tasks/{task_id} \
--header "Authorization: Bearer ${YOUR_APP_KEY}"正常响应示例
{
"request_id": "00d06a841873c0a83bfaf1fae0184625",
"output": {
"task_id": "xxxx‑xxxx‑xxxx‑xxxx",
"task_status": "SUCCEEDED",
"submit_time": "2026-08-26 12:10:05.001",
"scheduled_time": "2026-08-26 12:10:05.201",
"end_time": "2026-08-26 12:10:25.001",
"results": {
"video_url": "https://aaaa.ctyun.cn/xxx.mp4"
}
},
"usage": {
"video_duration": 5.2,
"video_ratio": "standard"
}
}