---
title: "Veo 3.0"
description: "谷歌顶级高保真电影级视频生成模型，具备出色的物理世界模拟与音画同步能力"
seo:
  title: "Veo 3.0 API 文档：参数与调用示例"
  description: "Veo 3.0 API 文档：模型 ID google/veo-3.0-generate-001、输入模式、参数取值与默认值，附请求示例。谷歌顶级高保真电影级视频生成模型，具备出色的物理世界模拟与音画同步能力。"
---

{/* 由 scripts/generate-model-pages.mjs 根据 openapi/model-contracts.json 生成，请勿手改；补充说明写在 docs/zh/models/_notes/ */}

| 模型 ID | 别名 | 接口 |
| --- | --- | --- |
| `google/veo-3.0-generate-001` | `google/veo-3.0`、`google/veo-3`、`veo-3.0`、`veo-3`、`veo3`、`veo3.0` | [视频生成](/zh/docs/guides/video-generation) |

> 已下架，停止新任务时间为 2026-10-05T00:00:00Z。旧任务和幂等重放保留；不要为结果不明的原请求换幂等键。选择替代模型后核对参数并重新报价，确认是新任务后才使用新键。

## 输入模式

| 模式 | 参考数量 | 参考角色 |
| --- | --- | --- |
| `text` 纯文本 | — | — |
| `image` 图片输入 | 1 | `first_frame` |

## 参数

| 参数 | 说明 | 取值 | 默认值 | 必填 |
| --- | --- | --- | --- | --- |
| `duration` | 时长：输出视频的秒数。 | `4`、`6`、`8` | `8` | 否 |
| `resolution` | 分辨率：输出内容的分辨率。 | `720p`、`1080p` | `720p` | 否 |
| `aspect_ratio` | 画幅：输出内容的宽高比。 | `16:9`、`9:16` | `16:9` | 否 |
| `generate_audio` | 生成音频：随视频生成原生音频。 | `false`、`true` | `true` | 否 |
| `n` | 单次请求输出数量：单次 API 请求（一个 Job）的输出数量，不是应用的批量张数。应用可提交多个独立请求组成一批；n=1 不表示应用只能生成一张。 | `1` | `1` | 否 |
完整合同以 `GET /v1/models/google/veo-3.0-generate-001?view=contract` 为准。参数合法不代表每个渠道都能执行，请对完整请求[报价](/zh/docs/concepts/billing#获取报价)。价格与渠道见[模型市场](https://yir.ai/zh/models)。
