Veo视频生成

使用 Google Veo 系列模型进行视频生成。请求体与 Vertex AI 官方 API 保持一致（透传），仅需额外添加 model 字段用于路由。

支持的模型

Veo 2： veo-2.0-generate-001

Veo 3.0： veo-3.0-generate-001、veo-3.0-fast-generate-001、veo-3.0-generate-preview、veo-3.0-fast-generate-preview

Veo 3.1： veo-3.1-generate-preview、veo-3.1-fast-generate-preview、veo-3.1-generate-001、veo-3.1-fast-generate-001

请求体格式

使用 instances 和 parameters 格式（与 Vertex AI 官方一致）：

model：模型 ID

instances：实例数组，包含 prompt 和可选的 image、lastFrame、video、mask、referenceImages

parameters：生成参数

注意：本 API 仅支持 bytesBase64Encoded 方式传递媒体数据，不支持 gcsUri。

功能支持

功能	Veo 2	Veo 3.0	Veo 3.1
文生视频 (prompt)	✅	✅	✅
图生视频 (image)	✅	✅	✅
末帧控制 (lastFrame)	✅ veo-2.0-generate-001	❌	✅
视频延长 (video)	✅ veo-2.0-generate-001	❌	❌
遮罩编辑 (mask)	✅ veo-2.0-generate-preview	❌	❌
素材参考图 (referenceImages)	✅ veo-2.0-generate-exp	❌	✅ veo-3.1-generate-preview

媒体对象格式

image / lastFrame / video 等字段使用扁平的 bytesBase64Encoded + mimeType 结构（不支持 gcsUri）：

{"bytesBase64Encoded": "BASE64...", "mimeType": "image/jpeg"}

⚠️ 不要使用 Gemini API 的 inlineData 嵌套格式，否则会报 image is empty 错误。

参数说明

durationSeconds（必填）：Veo 2 支持 5-8 秒，Veo 3/3.1 支持 4、6、8 秒

generateAudio：Veo 3/3.1 必填

enhancePrompt：仅 Veo 2 支持

resizeMode：仅 Veo 3 系列图生视频时可用，可选 pad（默认）或 crop

resolution：仅 Veo 3/3.1 支持，可选 720p（默认）或 1080p

personGeneration：可选 allow_adult（默认）或 dont_allow

sampleCount：生成数量 1-4

seed：随机种子（0-4294967295）

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

Veo文生视频示例Veo图生视频示例Veo首帧+末帧控制示例Veo素材参考图示例

{
    "model": "veo-3.1-generate-preview",
    "instances": [
        {
            "prompt": "A cat playing piano in the rain, cinematic, 4K"
        }
    ],
    "parameters": {
        "aspectRatio": "16:9",
        "durationSeconds": 8,
        "generateAudio": true,
        "negativePrompt": "blurry, low quality",
        "personGeneration": "allow_adult",
        "sampleCount": 1
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200OK

application/json

Veo视频生成任务提交成功

Body

示例

{
    "task_id": "veo3-20250714221020-668xc",
    "task_status": "succeed",
    "message": ""
}

🟠400请求参数错误

🟠401鉴权失败

🟠403无权限访问

🟠404资源不存在

🟠429请求过于频繁，请稍后重试

🔴500服务内部错误

支持的模型#

请求体格式#

功能支持#

媒体对象格式#

参数说明#