跳到主要内容

视频生成（Veo）

API 参考/Multimodal/Veo 视频生成

创建视频生成任务

POST/v1/video/generations

提交 Veo 文生视频或图生视频异步任务。接口受理后返回 task_id，视频结果需到控制台任务中心下载。

认证​

通过 Bearer Token 认证。

Authorizationstring必填

API Key，格式为 Bearer YOUR_API_KEY。

默认值：-
Content-Typestring必填

请求体格式。

默认值：application/json
Request-Idstring可选

客户侧生成的唯一请求标识，用于追踪和排查。

默认值：-

请求​

请求体必须包含 model 和 prompt。视频比例、分辨率、负面提示词、人物生成控制和音频开关请放在 metadata 对象中。传入 image 时为图生视频，不传时为文生视频。

modelstring必填

Veo 模型 ID，例如 veo-3.1-generate-001 或 veo-3.1-fast-generate-001。

默认值：-
promptstring必填

视频提示词，描述主体、动作、视觉风格、镜头和音频线索。

默认值：-
durationinteger可选

视频时长，单位为秒；常用 4、6、8 秒。

默认值：-
imageobject可选

图生视频输入对象；不传时为文生视频。

默认值：-
image.mime_typestring可选

图片类型，例如 image/png、image/jpeg 或 image/webp。

默认值：-
image.datastring可选

Base64 编码后的图片内容。

默认值：-
metadataobject可选

视频生成配置对象，用于设置比例、分辨率、音频和安全相关选项。

默认值：-
metadata.durationSecondsinteger可选

视频时长，单位为秒；建议与顶层 duration 保持一致。

默认值：-
metadata.aspectRatiostring可选

视频比例，常用 16:9 或 9:16。

默认值：16:9
metadata.resolutionstring可选

输出分辨率，常用 720p 或 1080p。

默认值：720p
metadata.negativePromptstring可选

不希望出现在视频中的内容。

默认值：-
metadata.personGenerationstring可选

人物生成控制，具体可用值以模型开放能力为准。

默认值：-
metadata.generateAudioboolean可选

是否生成音频。Veo 3 / 3.1 可按模型能力开启音频生成。

默认值：-
seedinteger可选

随机种子，用于提高结果相似度。

默认值：-

响应​

视频生成是异步任务。接口返回任务受理信息，而不是直接返回视频文件。

idstring必填

任务 ID。

默认值：-
task_idstring必填

任务中心查询和下载使用的任务 ID。

默认值：-
objectstring必填

对象类型。

默认值：video
modelstring必填

本次任务使用的模型。

默认值：-
statusstring必填

任务状态，例如 queued、processing、completed 或 failed。

默认值：-
progressinteger必填

任务进度，范围 0 到 100。

默认值：-
created_atinteger必填

创建时间，Unix 时间戳。

默认值：-

下载结果​

拿到 task_id 后，请到控制台任务中心下载视频：

打开任务中心

错误​

状态码说明
400请求体字段错误、模型不支持参数或图片格式不符合要求
401API Key 缺失或无效
403当前账户无权调用该模型
429请求超过速率限制
500 / 503平台或上游模型服务异常

相关指南​