Veo3视频生成

使用Google Veo3模型进行视频生成。支持文生视频和图生视频，提供高质量的视频内容创作。

支持的Veo3模型：

veo-3.0-generate-preview：标准版Veo3模型，支持高质量视频生成，仅支持16:9宽高比，生成音频为必选项

veo-3.0-fast-generate-preview：快速版Veo3模型，提供更快的生成速度

请求体格式：

Veo3模型使用instances和parameters格式：

model：模型ID，支持veo-3.0-generate-preview和veo-3.0-fast-generate-preview

instances：实例数组，包含prompt和可选的image

parameters：生成参数，包含aspectRatio、generateAudio等

Veo3模型特点：

图片支持：

支持Base64编码的图片输入

图片将作为视频的起始帧

可配合文本提示词生成定制化视频内容

使用image字段，包含bytesBase64Encoded和mimeType

参数控制：

aspectRatio：宽高比，veo-3.0-generate-preview仅支持16:9

durationSeconds：视频时长（秒），支持1-8秒

enhancePrompt：提示词增强，提升生成质量

generateAudio：音频生成控制，对于veo-3.0-generate-preview为必选项

negativePrompt：反向提示词，描述不希望出现的内容

personGeneration：人物生成策略，如allow/deny

sampleCount：生成样本数量

seed：随机种子，控制生成结果的随机性

Request

Header Params

Content-Type

string

optional

请求体类型，固定为 application/json

Example:

application/json

Authorization

string

optional

API 鉴权 Token，格式为 Bearer {API_KEY}

Example:

Bearer sk-soMNI5jlatIxMzwDA8A7A7D079A2475bA00bE92b52E39b4b

Body Params application/json

model

enum<string>

required

Veo3模型名称

Allowed values:

veo-3.0-generate-previewveo-3.0-fast-generate-preview

Example:

veo-3.0-generate-preview

instances

array[object (Veo3Instance) {2}]

required

生成实例列表，每个实例可包含文本和图片提示词

prompt

string

required

文本提示词，描述希望生成的视频内容

image

object (Veo3Image)

optional

可选，图片提示词，Base64 编码

parameters

object (Veo3Parameters)

required

aspectRatio

string

required

宽高比，如 16:9、9:16、1:1

durationSeconds

integer

required

视频时长（秒）

enhancePrompt

boolean

required

是否增强提示词

generateAudio

boolean

required

是否生成音频

negativePrompt

string

required

反向提示词，描述不希望出现的内容

personGeneration

string

required

人物生成策略，如 allow/deny

sampleCount

integer

required

生成样本数量

seed

integer <uint32>

required

随机种子

Examples

Veo3文生视频示例Veo3图生视频示例Veo3完整参数示例

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

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Veo3视频生成任务提交成功

Body

task_id

string

required

生成任务ID

Example:

veo3-20250714221020-668xc

task_status

string

required

任务状态

Example:

succeed

message

string

required

响应消息

Example:

Example

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

支持的Veo3模型：#

请求体格式：#

Veo3模型特点：#

图片支持：#

参数控制：#

Request

Request samples

Responses

支持的Veo3模型：

请求体格式：

Veo3模型特点：

图片支持：

参数控制：