Model and Modality Playbooks2026年6月22日Big Y

面向多供应商视频路由的 Veo API 访问检查清单

使用此 Veo API 访问检查清单，在视频流量进入前核对 model IDs、定价单位、异步任务、目录状态、重试和路由。

Veo API access 如果你只看模型名称，似乎很简单。可在生产环境中，它是一套包含模型生命周期检查、按秒计费、异步操作、分辨率选择、重试成本和路由级可观测性的完整视频工作流。如果你的团队正在将 Veo 与 Seedance、Sora 风格路由或网关后面的其他视频模型进行比较，请把访问视为一份检查清单，而不是一次简单的一行 API 替换。

本指南于 2026 年 6 月 17 日（Asia/Shanghai）依据 Google 的 Gemini API Veo 视频文档、Google 的 Veo 3.1 定价表、一次新的 Ahrefs MCP 运行结果以及一份实时的 Flatkey 定价目录快照进行了核对。目标并不是声称今天每条路由都已准备好投入生产。目标是明确说明：在通过多供应商路由器发送可计费的视频任务之前，究竟需要验证哪些内容。

快速答案：如何检查 Veo API 访问权限

在为生产流量批准 Veo API 访问权限 之前，请确认以下七项：

官方模型 ID：确定工作流需要 veo-3.1-generate-preview、veo-3.1-fast-generate-preview 还是 veo-3.1-lite-generate-preview。
生命周期状态：除非你正在处理短期迁移，否则避免使用较旧的 Veo 3.0 和 Veo 2.0 ID，因为 Google 已将它们列为 2026 年 6 月 30 日停用。
计价单位：在与基于 token/resource-pack 的视频提供商比较之前，先按秒数、分辨率和变体对 Veo 进行统一。
异步任务路径：记录操作名称、轮询状态、最终视频数量、时长、分辨率、重试次数和失败原因。
Flatkey 目录行：在你路由流量当天，验证准确的模型行、端点家族、分组、价格标签和可用性状态。
回退规则：确定失败的 Veo 任务何时可以切换到另一条路径，以及何时必须因质量或预算原因直接失败关闭。
使用证明：运行一个小型测试，并确认仪表盘显示所选模型、路由、状态、可计费单位和成本负责人。

这就是 Veo API 访问权限 的实用版本：不只是“我能不能调用 Veo”，而是“我能不能证明哪条视频路径被执行了、花了多少钱，以及失败时会发生什么”。

Veo API 访问清单

清单项	重要原因	需保存的证据
Model ID	Veo 变体在成本、延迟、分辨率或路由支持方面不可互换。	Google 官方 model ID 以及匹配的 Flatkey 行。
Endpoint family	即使网关暴露的是 OpenAI 兼容表面，视频路由的行为也未必像聊天补全一样。	Endpoint 类型、请求模板、可接受参数以及响应形状。
Pricing unit	Veo 按秒计费，而其他视频提供商可能使用 token、生成媒体或资源包。	变体、分辨率、预期秒数、重试策略以及价格来源日期。
Async operation logging	Veo 生成使用提交并轮询的流程，因此一次用户操作可能创建多个内部事件。	Operation ID、轮询尝试次数、最终状态、生成的视频元数据以及重试次数。
Availability status	目录中的一行不等同于成功的生产路由。	仪表板状态、上次检查时间、测试响应以及 usage-log 条目。
Fallback boundary	切换视频模型可能会改变风格、时长、质量、策略行为和成本。	已批准的回退矩阵和 fail-closed 条件。

确认官方 Veo 模型和生命周期

Google 的 Gemini API 文档目前在 Veo 生成示例中使用 veo-3.1-generate-preview。定价表列出了三个 Veo 3.1 预览 ID：veo-3.1-generate-preview、veo-3.1-fast-generate-preview 和 veo-3.1-lite-generate-preview。这是开始进行 Veo API 访问 审查的第一步，因为网关目录可能同时包含旧 ID、别名以及特定于提供商的标签。

生命周期与当前 ID 同样重要。本文检查的 Google 定价页面警告称，Veo 3 模型 veo-3.0-generate-001 和 veo-3.0-fast-generate-001 已弃用，并计划于 2026 年 6 月 30 日关闭。页面还说明 Veo 2 veo-2.0-generate-001 已弃用，并计划在同一天 2026 年 6 月 30 日关闭。如果旧代码示例、已保存的路由或仪表板收藏仍指向这些模型，请将其视为迁移任务，而不是可直接放行的访问路径。

生命周期警告：不要仅根据旧的 Veo 2 或 Veo 3.0 示例批准长期的 Veo API 访问。请在上线当天检查当前的 Google 模型页面以及你的网关目录。

在比较路由之前，先统一 Veo API 定价口径

对于 Veo API 访问，只有在你把请求口径统一之后，标题级定价才有参考价值。Google 当前的 Veo 3.1 付费层定价以 USD 按秒计费，Standard、Fast 和 Lite 变体对应不同的行项目。

Veo 3.1 变体	官方模型 ID	定价确认	规划说明
Standard	`veo-3.1-generate-preview`	720p 或 1080p 为 $0.40/秒；4K 为 $0.60/秒。	当质量要求足以证明更高的默认行项目合理时使用。
Fast	`veo-3.1-fast-generate-preview`	720p 为 $0.10/秒；1080p 为 $0.12/秒；4K 为 $0.30/秒。	在将面向用户的任务路由到这里之前，先测试输出质量和延迟。
Lite	`veo-3.1-lite-generate-preview`	720p 为 $0.05/秒；1080p 为 $0.08/秒；不支持 4K。	当不需要 4K 时，可用于更低成本的草稿。

Google 的定价页面还说明，只有在视频成功生成时才会收费。但这并不意味着你可以不记录重试。失败的操作、变更后的提示词，或用户要求重新运行，都可能在之后产生另一笔可计费任务。你的 Veo API 访问 检查清单应为每个请求包含时长、分辨率、变体、成功状态和重试次数。

如果你在比较 Veo 与其他提供商，请使用更广泛的 AI 视频生成 API 定价对比作为统一口径的中心。不要把 Veo 的按秒计费行直接与按 token/资源包计费的提供商进行比较，而不先转换实际请求形态。

将 Veo 生成视为长时间运行的操作

Google 的 Veo 指南展示了一种长时间运行的操作流程：提交生成请求，轮询该操作直到完成，然后检索生成的视频。这使得 Veo API 访问 与普通的一次性文本请求不同。你的路由器和仪表板需要在轮询过程中保留作业状态，而不仅仅是捕获第一个 HTTP 调用。

一个适合生产环境的日志应该回答这些问题：

哪个应用、团队密钥、环境和工作流创建了视频作业？
使用了哪个 Veo 模型 ID、宽高比、分辨率、提示类型和输入媒体？
返回了哪个操作 ID 或等效的异步句柄？
完成或失败前运行了多少次轮询尝试？
作业是成功、失败、取消、重试，还是被路由到其他地方？
返回了多少个生成的视频，输出存储在什么位置？
财务后续可以对账的使用记录和成本记录是哪一条？

这也是端点兼容性需要真正测试的地方。网关可以为许多模型系列暴露一个 OpenAI 兼容的 base URL，但视频生成通常带有特定于提供方的字段和异步语义。在你测试当前的 Flatkey 密钥、当前的 Veo 模型行以及应用将使用的精确请求体之前，请将代码片段保留为模板。

在生产前验证 Flatkey 目录行

本文于 2026 年 6 月 17 日 Asia/Shanghai 检查了 Flatkey 的公开定价目录。响应包含 638 行模型记录以及定价版本 a42d372ccf0b5dd13ecf71203521f9d2。其中存在与 Veo 相关的行，包括 Google 风格的 ID 和别名，例如 veo-3.1-generate-preview、veo-3.1-fast-generate-preview、veo-3.1-lite-generate-preview、veo3.1、veo3.1-fast 和 veo3.1-pro。

一个重要的注意事项是：该快照中检查到的每一条 Veo 记录都显示 unknown_failure 可用性状态。这意味着本文可以将这些行作为带日期的目录证据使用，但不能声称它们已具备实时生产就绪能力。正确的 Veo API access 工作流是打开当前的 Flatkey pricing page，确认准确的记录，验证控制台标签，检查端点家族，并在发送生产流量之前运行一个小型冒烟测试。

已检查的 Flatkey 行	看到的端点类型	看到的定价字段	快照中的状态
`veo-3.1-generate-preview`	`gemini`, `openai`	`quota_type: 1`, `model_price: 0.4`	`unknown_failure`
`veo-3.1-fast-generate-preview`	`gemini`, `openai`	`quota_type: 1`, `model_price: 0.15`	`unknown_failure`
`veo-3.1-lite-generate-preview`	`gemini`, `openai`	`model_ratio: 37.5`, `completion_ratio: 1`	`unknown_failure`
`veo3.1`, `veo3.1-fast`, `veo3.1-pro`	`openai`	`model_ratio: 37.5`, `completion_ratio: 1`	`unknown_failure`

Flatkey 的公开产品文案支持一种谨慎的路由叙事：一个 API key、清晰的定价、统一计费、用于密钥、用量和路由的控制台，以及自动切换/负载均衡的表述。实现证明应比营销承诺更窄。对于 Veo API access，验收测试应是一个真实的、由控制台支持的请求记录，而不仅仅是一条目录记录。

设置多提供商视频路由规则

视频故障切换比文本故障切换更敏感。如果 Veo 任务失败，切换到另一个提供商可能会改变时长、视觉风格、提示词理解、内容过滤、输出格式和价格。Veo API 访问方案应明确自动回退在何种情况下是安全的，以及工作流在何种情况下应停止并交由人工审核。

情况	建议的路由决策	原因
临时性提供商错误或超时	重试一次，或在工作流允许的情况下切换到已批准的等效路由。	在不掩盖重复失败的前提下保护用户体验。
已弃用的模型 ID	阻止该路由，并在生产流量进入前迁移到当前模型。	防止无意中依赖一个有固定下线日期的路由。
不支持的请求参数	失败即关闭，并修正客户端请求。	盲目回退通常会在其他地方重复同样的错误请求。
高分辨率最终渲染	若要回退到更昂贵的路由，需要显式批准。	分辨率和时长会迅速放大视频成本。
草稿或内部创意迭代	仅当输出差异可接受时，才允许更低成本的回退。	草稿工作流可以容忍比面向客户的输出更多的变化。

这一决策中的可靠性部分在 AI API 负载均衡和故障切换操作手册中有更深入的说明。对于视频，请在每一层回退梯子中都加入成本和创意输出约束。

在上线前运行此烟雾测试

一个负责任的 Veo API access 烟雾测试应当小、可控且易于检查：

创建或选择一个非生产环境的 Flatkey 密钥。
从实时定价页面选择一条当前的 Veo 记录，并记录其精确的模型标签。
与产品/文档负责人确认端点系列和请求模板。
使用已知时长和分辨率设置运行一个低风险的视频作业。
捕获操作 ID、状态轮询路径、最终结果、计费单位和使用日志条目。
在可能的情况下，再重复一次受控失败，例如被阻止的已弃用模型或不受支持的参数。
决定该路由是否可以服务生产流量、仅用于预发布，或仅用于研究待办事项。

如果这些检查中的任何一项失败，就不要将该路由投入生产。缺少使用日志、定价单位不明确，或 unknown_failure 可用性状态，对视频而言不是一个文书问题；它会改变成本、支持和客户预期。

常见问题

如何获取 Veo API 访问权限？

先查看 Google 当前的 Gemini API Veo 文档和计费要求，然后在你实际开发当天确认模型 ID、端点和价格。如果你使用 Flatkey 进行路由，在将 Veo API 访问视为可用于生产之前，请检查当前的价格目录和控制台。

我应该使用哪个 Veo 模型 ID？

Google 当前的 Veo 3.1 价格表列出了 veo-3.1-generate-preview、veo-3.1-fast-generate-preview 和 veo-3.1-lite-generate-preview。新生产项目应避免使用较旧的 Veo 3.0 和 Veo 2.0 ID，因为 Google 将它们列为 2026 年 6 月 30 日停用。