# 图生动作

**方法**: `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=2981852)

通义万相-图生动作模型，可基于人物图片和参考视频，生成人物动作视频。

功能简述：将视频角色的动作/表情迁移到图片角色中，赋予图片角色动态表现力。

适用场景：复刻舞蹈、复刻高难度肢体动作、复刻影视剧表演表情及肢体动作细节，低成本动捕替代。

## 请求参数

### 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/adsyrp/move_input_image.jpeg
video_url
string
必需
输入视频的公网可访问的HTTP/HTTPS链接，不能包含中文等非ASCII字符，否则需要进行编码后再传入。
本地文件可通过上传文件获取临时URL。
建议：提高参考视频的分辨率和帧率，可有效提升生成视频的画质效果。
格式：MP4、AVI、MOV。
时长：2～30s。
尺寸：视频的宽度和高度都在[200, 2048]像素范围内，宽高比在1:3至3:1范围内。
文件大小：不超过200MB。
内容：画面中仅有一人，正对镜头，人脸完整无遮挡，且在画面中的占比适中，避免过大或过小。
示例值：
https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4
parameters
object
必需
mode
string
必需
模型服务模式选择，支持两种模式。
wan-std：标准模式，生成速度较快，性价比高，适用于快速预览和基础动画场景，处理1s视频耗时约8s。
wan-pro：专业模式，动画流畅度更高，效果更佳，但处理时间和费用也相应增加，处理1s视频耗时约13s。
check_image
boolean
可选
是否进行图像检测。
true：默认值，接口将对传入的图片进行检测。
false：跳过图片检测环节，直接对图片进行后续处理。
示例
{
"model"
:
"wan2.2-animate-move"
,
"input"
:
{
"image_url"
:
"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg"
,
"video_url"
:
"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_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-move",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg",
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4"
    },
    "parameters": {
        "mode": "wan-std"
    }
  }'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

```text
object
```

#### 示例

```json
{}
```