# Veo图生视频 

**方法**: `POST`
**路径**: `/v2/videos/generations`

当模型是带 veo2-fast-frames 最多支持两个，分别是首尾帧
当模型是 veo3-pro-frames 最多支持一个首帧
当模型是 veo2-fast-components 最多支持 3 个，此时图片为视频中的元素

不传 aspect\_ratio 参数时，会根据参考图自动匹配比例，如果无法判断默认生成横屏

## 请求参数

### Header 参数

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

### Body 参数 application/json

```text
prompt
string
必需
model
enum<string>
必需
枚举值:
veo3-pro-frames
支持图生视频
veo3-fast-frames
veo2-fast-frames
veo2-fast-components
veo3.1
支持首尾帧，Google最新的高级人工智能模型, veo3 快速 模式，支持视频自动配套音频生成，质量高价格很低，性价比最高的选择, 自适应首帧和文生视频
veo3.1-pro
支持首尾帧，Google最新的高级人工智能模型, veo3 高质量 模式，支持视频自动配套音频生成，质量超高，价格也超高，使用需注意, 自适应首帧和文生视频
veo3.1-components
多图参考（1-3）张图
enhance_prompt
boolean
可选
是否优化提示词，一般是false；由于 veo 只支持英文提示词，所以如果需要中文自动转成英文提示词，可以开启此开关
images
array
[string]
必需
url or base64；当模型是带 veo2-fast-frames 最多支持两个，分别是首尾帧，当模型是 veo3-pro-frames 最多支持一个首帧，当模型是 veo2-fast-components 最多支持 3 个，此时图片为视频中的元素
aspect_ratio
enum<string>
可选
枚举值:
9:16
16:9
示例
{
"prompt"
:
"string"
,
"model"
:
"veo3-pro-frames"
,
"enhance_prompt"
:
true
,
"images"
:
[
"string"
]
,
"aspect_ratio"
:
"9:16"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/v2/videos/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "string",
    "model": "veo3-pro-frames",
    "enhance_prompt": true,
    "images": [
        "string"
    ],
    "aspect_ratio": "9:16"
}'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

```text
object
```

#### 示例

```json
{
    "task_id": "f0aa213c-c09e-4e19-a0e5-c698fe48acf1"
}
```