Google Veo 视频生成 API 文档

概述

Veo 是 Google DeepMind 推出的视频生成模型，支持文生视频（Text-to-Video）和图生视频（Image-to-Video）。本平台通过统一的 OpenAI Videos 风格接口封装了 Veo 3.1 系列模型，支持异步任务提交与轮询。

支持的模型

模型名称	说明	720p 价格/秒	1080p 价格/秒	4K 价格/秒
`veo-3.1-fast-generate-001`	Fast 模式，速度快	$0.10	$0.12	$0.30
`veo-3.1-generate-001`	Standard 模式，质量高	$0.40	$0.40	$0.60
`veo-3.1-lite-generate-001`	Lite 模式，成本低	$0.05	$0.08	不支持

说明：价格按视频秒数计费，总费用 = 单价 × 时长(秒)

分辨率倍率

分辨率	Fast	Standard	Lite
720p	1.0x (基础价)	1.0x (基础价)	1.0x (基础价)
1080p	1.2x	1.0x	1.6x
4K	3.0x	1.5x	不支持

调用流程

第一步：创建视频生成任务

POST /v1/video/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

请求参数：

参数	类型	必填	说明
model	string	✅	模型名称，见上方支持的模型列表
prompt	string	✅	视频内容描述
image	string	❌	图片 URL（图生视频时必填）
size	string	❌	分辨率，默认 `1280x720`，可选 `1920x1080`、`720x1280`、`1080x1920`
duration	int	❌	视频时长（秒），默认 `5`，范围 5-10 秒
metadata	object	❌	高级参数（见下方）

metadata 参数：

参数	类型	说明
durationSeconds	int	视频时长（秒），优先级高于 duration 参数
resolution	string	分辨率：`720p`、`1080p`、`4k`
aspectRatio	string	宽高比：`16:9`、`9:16`、`1:1`
sampleCount	int	生成数量，默认 1
generateAudio	bool	是否生成音频，默认 true

请求示例（文生视频）：

请求示例（图生视频）：

成功响应（202）：

{
  "id": "task_7beFseSETNNSIgR2cDqPE4U6Jb13Kr1Z",
  "task_id": "task_7beFseSETNNSIgR2cDqPE4U6Jb13Kr1Z",
  "object": "video",
  "model": "veo-3.1-fast-generate-001",
  "status": "queued",
  "progress": 0,
  "created_at": 1782357987
}

⚠️ 请保存返回的 id 或 task_id，用于后续轮询查询。

第二步：查询任务状态（轮询）

GET /v1/video/generations/{task_id}
Authorization: Bearer YOUR_API_KEY

按固定间隔（建议 5 秒）重复请求，读取响应中的 status 字段。

status	含义	客户端处理
`queued`	排队中	继续轮询
`in_progress`	生成中	继续轮询
`completed`	已完成	使用视频地址
`failed`	失败	停止轮询，检查 `fail_reason`

查询示例：

生成中响应：

{
  "id": 2,
  "task_id": "task_7beFseSETNNSIgR2cDqPE4U6Jb13Kr1Z",
  "status": "in_progress",
  "progress": "50%",
  "quota": 250000,
  "properties": {
    "origin_model_name": "veo-3.1-fast-generate-001",
    "upstream_model_name": "veo-3.1-fast-generate-001"
  }
}

完成响应：

{
  "id": 2,
  "task_id": "task_7beFseSETNNSIgR2cDqPE4U6Jb13Kr1Z",
  "status": "SUCCESS",
  "progress": "100%",
  "result_url": "https://storage.googleapis.com/.../video.mp4",
  "quota": 250000
}

使用 result_url 字段获取视频下载地址。

第三步（可选）：下载视频

视频生成完成后，直接访问 result_url 下载 MP4 文件。

计费说明

计费公式

总费用 = 模型单价(720p) × 分辨率倍率 × 时长(秒)

价格示例

模型	分辨率	时长	计算过程	总价
Fast	720p	5秒	$0.10 × 1.0 × 5	$0.50
Fast	1080p	8秒	$0.10 × 1.2 × 8	$0.96
Fast	4K	5秒	$0.10 × 3.0 × 5	$1.50
Standard	720p	5秒	$0.40 × 1.0 × 5	$2.00
Standard	1080p	8秒	$0.40 × 1.0 × 8	$3.20
Lite	720p	5秒	$0.05 × 1.0 × 5	$0.25
Lite	1080p	8秒	$0.05 × 1.6 × 8	$0.64

预扣费机制

提交任务时预扣费用

任务完成后按实际生成时长结算

预扣费与实际费用可能有差额，系统会自动调整

Python 示例

Node.js 示例

错误码

HTTP 状态码	说明
200	成功
202	任务已创建
400	参数错误
401	鉴权失败
403	无模型调用权限或配额不足
404	模型不存在
500	服务器内部错误
502	上游服务失败
503	无可用资源

常见问题

Q: 生成需要多长时间？

A: 通常 30 秒 ~ 2 分钟，取决于模型和参数。Fast 模式最快，Standard 模式质量最高但较慢。

Q: 视频可以保存多久？

A: 生成的视频链接有效期约 24 小时，请及时下载。

Q: 支持哪些分辨率？

A: 支持 720p、1080p、4K（Lite 模式不支持 4K）。

Q: 配额如何计算？

A: 按视频秒数计费，不同模型和分辨率价格不同，详见模型价格表。

Q: 为什么 1080p 比 720p 贵？

A: 不同分辨率有不同的倍率系数，1080p 和 4K 需要更多计算资源。

Q: 可以生成音频吗？

A: 是的，Veo 3.1 模型默认生成带同步音频的视频。

Q: 图生视频支持什么格式？

A: 支持 JPG、PNG 格式的图片 URL。

模型选择建议

场景	推荐模型	理由
快速原型验证	Fast	速度快，成本低
正式内容生产	Standard	质量最高，适合发布
批量处理	Lite	成本最低，适合大规模生成
高清需求	Fast/Standard + 1080p/4K	根据质量要求选择

更新日志

2026-06-25: 初始版本，支持 Veo 3.1 Fast/Standard/Lite 模型

Google Veo 视频生成 API 文档

概述#

支持的模型#

分辨率倍率#

调用流程#

第一步：创建视频生成任务#

第二步：查询任务状态（轮询）#

第三步（可选）：下载视频#

计费说明#

计费公式#

价格示例#

预扣费机制#

Python 示例#

Node.js 示例#

错误码#

常见问题#

Q: 生成需要多长时间？#

Q: 视频可以保存多久？#

Q: 支持哪些分辨率？#

Q: 配额如何计算？#

Q: 为什么 1080p 比 720p 贵？#

Q: 可以生成音频吗？#

Q: 图生视频支持什么格式？#

模型选择建议#

更新日志#

概述