# 图生视频

**方法**: `POST`
**路径**: `/vidu/v2/img2video`

### 参数名称及描述

| 参数名称 | 类型 | 必填 | 参数描述 |
| --- | --- | --- | --- |
| `model` | String | 是 | 模型名称， 可选值：  - `viduq2-pro`: 新模型，效果好，细节丰富  - `viduq2-turbo`: 新模型，效果好，生成快  - `viduq1`: 画面清晰，平滑转场，运镜稳定  - `viduq1-classic`: 画面清晰，转场、运镜更丰富  - `vidu2.0`: 生成速度快  - `vidu1.5`: 动态幅度大 |
| `images` | Array[String] | 是 | 首帧图像。支持 Base64 编码或图片 URL，支持格式：png、jpeg、jpg、webp。图片比例需小于 1:4 或 4:1，大小不超过 50 MB。 |
| `prompt` | String | 可选 | 生成视频的文本描述，字符长度不超过 2000 个字符。 |
| `is_rec` | Bool | 可选 | 是否使用推荐提示词：  - `true`: 系统自动推荐提示词，生成视频时使用推荐词（推荐提示词数量=1）  - `false`: 使用自定义提示词生成视频。启用推荐提示词每个任务额外消耗10积分。 |
| `duration` | Int | 可选 | 视频时长，依据模型默认值设置：  - `viduq2-pro`、`viduq2-turbo`、`viduq1`、`viduq1-classic`: 默认为 5秒，可选：1、2、3、4、5、6、7、8  - `vidu2.0`: 默认为 4秒，可选：4、8  - `vidu1.5`: 默认为 4秒，可选：4、8 |
| `seed` | Int | 可选 | 随机种子。默认不传或传0时使用随机数替代，手动设置则使用设置的种子。 |
| `resolution` | String | 可选 | 分辨率：  - `viduq2-pro`: 1-8秒，默认 720p，可选：540p、720p、1080p  - `viduq1`、`viduq1-classic`: 默认 1080p  - `vidu2.0`: 4秒默认 360p，8秒默认 720p，可选：360p、720p、1080p  - `vidu1.5`: 4秒默认 360p，8秒默认 720p，可选：360p、720p、1080p |
| `movement_amplitude` | String | 可选 | 运动幅度：默认 `auto`，可选值：`auto`、`small`、`medium`、`large` |
| `bgm` | Bool | 可选 | 是否添加背景音乐，默认为 `false`。若 `true`，系统自动挑选并添加合适音乐。 |
| `payload` | String | 可选 | 透传参数，最大字符长度为 1048576。 |
| `off_peak` | Bool | 可选 | 错峰模式，默认为 `false`，可选值：`true`（错峰生成），`false`（即时生成）。错峰模式消耗积分较低，任务会在48小时内生成。 |
| `watermark` | Bool | 可选 | 是否添加水印，`true` 表示添加水印，`false` 表示不添加。默认不加。 |
| `wm_position` | Int | 可选 | 水印位置：  - 1: 左上角  - 2: 右上角  - 3: 右下角  - 4: 左下角  默认：3 |
| `wm_url` | String | 可选 | 自定义水印内容的图片 URL，若不传，使用默认水印。 |
| `meta_data` | String | 可选 | 元数据标识，JSON 格式字符串，可自定义或使用示例格式。 |

### 示例格式

```
{
"Label": "your_label",
"ContentProducer": "yourcontentproducer",
"ContentPropagator": "your_content_propagator",
"ProduceID": "yourproductid",
"PropagateID": "your_propagate_id",
"ReservedCode1": "yourreservedcode1",
"ReservedCode2": "your_reserved_code2"
}
```

## 请求参数

### Header 参数

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

### Body 参数 application/json

```text
model
string
必需
images
array
[string]
必需
prompt
string
必需
duration
integer
必需
seed
integer
必需
resolution
string
必需
movement_amplitude
string
必需
off_peak
boolean
必需
示例
{
"model"
:
"viduq2-pro"
,
"images"
:
[
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
]
,
"prompt"
:
"The astronaut waved and the camera moved up."
,
"duration"
:
5
,
"seed"
:
0
,
"resolution"
:
"720p"
,
"movement_amplitude"
:
"auto"
,
"off_peak"
:
false
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/vidu/v2/img2video' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "viduq2-pro",
    "images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"],
    "prompt": "The astronaut waved and the camera moved up.",
    "duration": 5,
    "seed": 0,
    "resolution": "720p",
    "movement_amplitude": "auto",
    "off_peak": false
}'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

```text
object
```

#### 示例

```json
{
    "task_id": "885482446060003328",
    "type": "img2video",
    "state": "created",
    "model": "viduq2-pro",
    "style": "general",
    "prompt": "The astronaut waved and the camera moved up.",
    "images": [
        "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
    ],
    "duration": 5,
    "seed": 1283649749,
    "aspect_ratio": "",
    "resolution": "720p",
    "movement_amplitude": "auto",
    "created_at": "2025-11-10T15:03:01.749836088Z",
    "credits": 55,
    "payload": "",
    "cus_priority": 0,
    "off_peak": false,
    "watermark": false,
    "is_rec": false,
    "wm_position": "unspecified",
    "wm_url": "",
    "meta_data": ""
}
```