# 视频换人

**方法**: `POST`
**路径**: `/qwen/api/v1/services/aigc/image2video/video-synthesis`

[官方api 文档](https://bailian.console.aliyun.com/?spm=5176.12818093_47.resourceCenter.1.3a9d2cc9l8f5UQ&userCode=okjhlpr5&tab=api#/api/?type=model&url=2982219)

通义万相-视频换人模型能够依据人物图片和参考视频，将视频中的主角替换为图片中的角色，同时保留原视频的场景、光照和色调，实现无缝换人。

核心功能： 在不改变原始视频的动作、表情及环境的条件下，将视频中的角色替换为指定图片中的人物。

适用场景：适用于二次创作、影视后期制作等需要进行角色替换的场景。

## 请求参数

### Header 参数

```text
X-DashScope-Async
string
必需
示例:
enable
Content-Type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json 必填

```text
model
string
必需
input
object
必需
image_url
string
必需
输入图像的公网可访问的HTTP/HTTPS链接，不能包含中文等非ASCII字符，否则需要进行编码后再传入。
本地文件可通过上传文件获取临时URL。
格式限制：JPG、JPEG、PNG、BMP、WEBP
尺寸限制：图像的宽度和高度都在[200,4096]像素范围内，宽高比在1:3至3:1范围内。
大小限制：不超过5MB
示例：
https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/bhkfor/mix_input_image.jpeg
video_url
string
必需
输入视频的公网可访问的HTTP/HTTPS链接，不能包含中文等非ASCII字符，否则需要进行编码后再传入。
本地文件可通过上传文件获取临时URL。
建议：提高参考视频的分辨率和帧率，可有效提升生成视频的画质效果。
格式限制：MP4、AVI、MOV
尺寸限制：视频的宽度和高度都在[200, 2048]像素范围内，宽高比在1:3至3:1范围内。
大小限制：不超过200MB
时长限制：不小于2s且不大于30s
示例：
https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/wqefue/mix_input_video.mp4
parameters
object
必需
mode
string
必需
模型服务模式选择，支持两种模式。
wan-std：标准模式，生成速度较快，性价比高，适用于快速预览和基础动画场景，处理1s视频耗时约9s。
wan-pro：专业模式，动画流畅度更高，效果更佳，但处理时间和费用也相应增加，处理1s视频耗时约16s。
check_image
boolean
可选
是否进行图像检测。
true：默认值，接口将对传入的图片进行检测。
false：跳过图片检测环节，直接对图片进行后续处理。
示例
{
"model"
:
"wan2.2-animate-mix"
,
"input"
:
{
"image_url"
:
"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/bhkfor/mix_input_image.jpeg"
,
"video_url"
:
"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/wqefue/mix_input_video.mp4"
}
,
"parameters"
:
{
"mode"
:
"wan-std"
}
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/qwen/api/v1/services/aigc/image2video/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "wan2.2-animate-mix",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/bhkfor/mix_input_image.jpeg",
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/wqefue/mix_input_video.mp4"
    },
    "parameters": {
        "mode": "wan-std"
    }
  }'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
object
```

#### 示例

```json
{}
```