# 多图生视频

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

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

输入多张图片和提示词即可生成一段平滑过渡的视频

## 请求参数

### 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
必需
function
string
必需
功能名称。多图参考设置为image_reference。
多图参考支持最多3张参考图。图像内容可以包括主体与背景，例如人物、动物、服饰、场景等。使用 prompt 描述期望生成的视频画面内容，模型可将多张图片融合生成连贯的视频内容。
prompt
string
必需
提示词，用来描述生成视频中期望包含的元素和视觉特点。
支持中英文，长度不超过800个字符，每个汉字/字母占一个字符，超过部分会自动截断。
提示词技巧请参见文生视频/图生视频Prompt指南。
ref_images_url
array
[string]
必需
输入参考图像的URL 数组。
URL 需为公网可访问地址，支持 HTTP 或 HTTPS 协议。如需获取本地文件的公网URL，请参见上传文件获取临时URL 。
参考图像支持 1-3 张图像，若超过 3 张，则仅保留前 3 张作为输入。
图像限制：
图像格式：JPG、JPEG、PNG、BMP、TIFF、WEBP。
图像分辨率：图像的宽和高范围在[360, 2000]，单位像素。
图像大小：不超过10MB。
URL地址中不能包含中文字符。
使用建议：
若使用参考图像中的主体时，建议每张图像中仅包含一个主体。背景建议为纯色（如白色或单一颜色），以便更好地突出主体。
若使用参考图像的背景时，背景图像最多只有一张，且背景图像中不包含任何主体对象。
parameters
object
可选
prompt_extend
boolean
可选
是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写。对于较短的prompt生成效果提升明显，但会增加耗时。
true（默认值）：开启智能改写。
false：关闭智能改写。
obj_or_bg
array
[string]
可选
该参数用于标识每张参考图像的用途，与 ref_images_url 参数一一对应。数组中每个元素表示对应位置的图像为“主体”还是“背景”：
obj：表示该图像作为主体参考。
bg：表示该图像作为背景参考 （最多仅允许一个）。
使用说明：
建议传入该参数，且长度必须与 ref_images_url保持一致，否则将报错。
仅当 ref_images_url为单元素数组时，可不传，此时默认值为 ["obj"]。
示例值： ["obj", "obj", "bg"]。
size
string
可选
生成视频的分辨率（宽*高）。目前支持生成720P 视频，分辨率的取值为：
1280*720（默认值）：视频宽高比为16:9。其中，1280代表宽度，720代表高度。
720*1280：视频宽高比为9:16。
960*960：视频宽高比为1:1。
832*1088：视频宽高比为3:4。
1088*832：视频宽高比为4:3。
duration
integer
可选
视频生成时长，单位为秒。当前参数值固定为5，且不支持修改。模型将始终生成5秒时长的视频。
seed
integer
可选
随机数种子，用于控制模型生成内容的随机性。seed参数取值范围是[0, 2147483647]。
如果不提供，则算法自动生成一个随机数作为种子。如果您希望生成内容保持相对稳定，请使用相同的seed参数值。
watermark
boolean
可选
是否添加水印标识，水印位于图片右下角，文案为“AI生成”。
false（默认值）：不添加水印。
true：添加水印。
示例
{
"model"
:
"wanx2.1-vace-plus"
,
"input"
:
{
"function"
:
"image_reference"
,
"prompt"
:
"视频中，一位女孩自晨雾缭绕的古老森林深处款款走出，她步伐轻盈，镜头捕捉她每一个灵动瞬间。当女孩站定，环顾四周葱郁林木时，她脸上绽放出惊喜与喜悦交织的笑容。这一幕，定格在了光影交错的瞬间，记录下女孩与大自然的美妙邂逅。"
,
"ref_images_url"
:
[
"http://wanx.alicdn.com/material/20250318/image_reference_2_5_16.png"
,
"http://wanx.alicdn.com/material/20250318/image_reference_1_5_16.png"
]
}
,
"parameters"
:
{
"prompt_extend"
:
true
,
"obj_or_bg"
:
[
"obj"
,
"bg"
]
,
"size"
:
"1280*720"
}
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/qwen/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "wanx2.1-vace-plus",
    "input": {
        "function": "image_reference",
        "prompt": "视频中，一位女孩自晨雾缭绕的古老森林深处款款走出，她步伐轻盈，镜头捕捉她每一个灵动瞬间。当女孩站定，环顾四周葱郁林木时，她脸上绽放出惊喜与喜悦交织的笑容。这一幕，定格在了光影交错的瞬间，记录下女孩与大自然的美妙邂逅。",
        "ref_images_url": [
            "http://wanx.alicdn.com/material/20250318/image_reference_2_5_16.png",
            "http://wanx.alicdn.com/material/20250318/image_reference_1_5_16.png"
        ]
    },
    "parameters": {
        "prompt_extend": true,
        "obj_or_bg": ["obj","bg"],
        "size": "1280*720"
    }
}'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

```text
object
```

#### 示例

```json
{}
```