Veo3 视频生成 API
概述
接口信息
POST /v1/video/generationsapplication/json模型能力
支持的模型
| 模型名称 | 模型 ID | 支持功能 | 特点 |
|---|---|---|---|
| Veo 3.0 | google/veo3 | 文生视频、图生视频 | 支持 8 秒视频，最高 1080p，支持音频生成 |
基础参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 | 限制 |
|---|---|---|---|---|---|
model | string | ✅ | - | 模型 ID | 见支持的模型列表 |
prompt | string | ✅/❌ | - | 文本提示词 | 文生视频功能时为必需的参数。 如果提供了图片输入（图生视频），则为可选。 |
视频生成参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 | 取值范围 |
|---|---|---|---|---|---|
aspect_ratio | string | ❌ | 16:9 | 视频宽高比 | 16:9, 9:16, 1:1, 4:3, 3:4 |
duration_seconds | int | ❌ | 8 | 视频时长（秒） | Veo 2.0: 5-8秒，Veo 3.0: 8秒（固定） |
resolution | string | ❌ | 720p | 视频分辨率 | 720p, 1080p（仅 Veo 3.0） |
enhance_prompt | bool | ❌ | true | 是否使用 Gemini 优化提示词 | true, false |
generate_audio | bool | ❌ | true | 是否生成音频 | true, false（仅 Veo 3.0） |
person_generation | string | ❌ | allow_adult | 人物生成控制 | allow_adult, dont_allow |
sample_count | int | ❌ | 1 | 生成视频数量 | 1-4 |
seed | uint32 | ❌ | - | 随机种子 | 0 到 4294967295 |
图像相关参数
基础图生视频
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
image | string | ✅ | - | 输入图片，支持 Base64 Data URL 或 Google Cloud Storage URI |
首尾帧图生视频（仅 Veo 2.0）
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
image | string | ✅ | - | 首帧图片，支持 Base64 Data URL 或 Google Cloud Storage URI |
last_frame | string | ✅ | - | 尾帧图片，支持 Base64 Data URL 或 Google Cloud Storage URI |
图片格式要求
| 项目 | 要求 |
|---|---|
| 支持格式 | JPEG (.jpg/.jpeg)、PNG (.png) |
| MIME 类型 | image/jpeg、image/png |
| 编码方式 | Base64 Data URL 或 Google Cloud Storage URI |
| 不支持 | ❌ HTTP/HTTPS URL（如 https://example.com/image.jpg） |
支持的图片输入格式
1.
data:image/<format>;base64,<base64_data>data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...2.
gs://bucket-name/path/to/image.jpggs://my-bucket/images/input.png参数详细 说明
宽高比 (aspect_ratio)
| 值 | 说明 | 支持模型 |
|---|---|---|
16:9 | 横屏（默认） | 所有模型 |
9:16 | 竖屏 | 仅 Veo 2.0 |
视频时长 (duration_seconds)
| 模型 | 支持范围 | 默认值 | 说明 |
|---|---|---|---|
| Veo 2.0 | 5-8 秒 | 8 秒 | 可调节时长 |
| Veo 3.0 | 8 秒（固定） | 8 秒 | 固定时长，不可调节 |
分辨率 (resolution)
| 值 | 说明 | 支持模型 |
|---|---|---|
720p | 720p 分辨率（默认） | 所有模型 |
1080p | 1080p 高分辨率 | 仅 Veo 3.0 |
仅 Veo 3.0 支持选择分辨率
视频数量 (sample_count)
人物生成控制 (person_generation)
| 值 | 说明 |
|---|---|
allow_adult | 仅允许生成成年人（默认） |
dont_allow | 禁止在图片中包含人物/人脸 |
高级参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
negative_prompt | string | ❌ | - | 负向提示词，描述不希望看到的内容 |
storage_uri | string | ❌ | - | Google Cloud Storage 存储 URI |
请求示例
基础文生视频
{
"model": "google/veo3",
"prompt": "一只可爱的小猫在花园里追逐蝴蝶，阳光明媚，画面温馨，电影级画质",
"negative_prompt": "模糊，低质量，变形",
"aspect_ratio": "16:9",
"duration_seconds": 8,
"enhance_prompt": true
}高分辨率视频生成（Veo 3.0）
{
"model": "google/veo3",
"prompt": "北极天空中舞动的北极光、闪烁的星星、白雪覆盖的景观的延时摄影",
"aspect_ratio": "16:9",
"duration_seconds": 8,
"resolution": "1080p",
"generate_audio": true,
"enhance_prompt": true
}固定种子复现
{
"model": "google/veo3",
"prompt": "在美丽的落日余晖下，一个孤独的牛仔骑着马在开阔的平原上奔驰，光线柔和，色彩温暖",
"duration_seconds": 8,
"seed": 42,
"sample_count": 1,
"person_generation": "allow_adult"
}多视频生成
{
"model": "google/veo3",
"prompt": "许多斑点水母在水下脉动。它们的身体是透明的，在深海中会发光",
"duration_seconds": 5,
"sample_count": 4
}基础图生视频（使用 Data URL）
{
"model": "google/veo3",
"image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"prompt": "让图片中的人物微笑并轻轻点头",
"duration_seconds": 8,
"aspect_ratio": "16:9"
}基础图生视频（使用 GCS URI）
{
"model": "vertex/veo-2.0-generate-001",
"image": "gs://your-bucket/input.jpg",
"prompt": "让场景动起来，添加微风效果",
"negative_prompt": "人物变形，面部扭曲",
"duration_seconds": 8
}首尾帧图生视频（仅 Veo 2.0）
{
"model": "google/veo2",
"image": "gs://your-bucket/start_frame.jpg",
"last_frame": "gs://your-bucket/end_frame.jpg",
"prompt": "从起始状态平滑过渡到结束状态",
"duration_seconds": 8,
"aspect_ratio": "16:9"
}修改于 2025-09-12 01:41:21