付费 Gemini API 项目上的 Veo 429 RESOURCE_EXHAUSTED:原因与解决方法
即使你的 Gemini API 项目已是付费项目且配额显示未用完,Veo 3.1 仍会返回 429 RESOURCE_EXHAUSTED。本文介绍六个原因、各自的排查方法,以及另一种调用 Veo 的方式。
如果通过 Gemini API 调用 Veo 时,在付费项目上出现 429 RESOURCE_EXHAUSTED 错误,原因不外乎以下六种:Veo 的每日请求配额用尽、基于支出的限制、密钥所属项目与你升级的项目不一致、预付余额为空、你的用量等级与你以为的不同,或者项目的配额从未被正确开通。前四种你可以自行解决,后两种需要 Google 介入。
本指南介绍如何区分这几种情况,以及在等待期间可以怎么做。
资料核查于 2026 年 11 月 22 日:Google 的 Gemini API 速率限制与故障排查文档,以及下文链接的 Google AI Developers Forum 帖子。
错误是什么样的
429 RESOURCE_EXHAUSTED
You exceeded your current quota, please check your plan and billing details.
开发者反馈,该错误出现在 veo-3.1-generate-preview、veo-3.1-fast-generate-preview 和 veo-3.1-lite-generate-preview 上,而同一个密钥下的文本和图像模型往往仍能正常工作。
Gemini API 的限制如何运作
Google 速率限制文档中的四条说明可以解释大多数情况:
- “Rate limits are applied per project, not per API key.”(速率限制按项目而非按 API 密钥计算。)
- “Requests per day (RPD) quotas reset at midnight Pacific time.”(每日请求数(RPD)配额在太平洋时间午夜重置。)
- “Rate limits are more restricted for experimental and preview models.”(实验性和预览模型的速率限制更为严格。)上述 Veo 3.1 模型都属于预览模型。
- “Specified rate limits are not guaranteed and actual capacity may vary.”(所列速率限制不作保证,实际容量可能有所不同。)
等级根据账单历史分配:
| 等级 | 达成条件 |
|---|---|
| Free | 一个有效项目 |
| Tier 1 | “Set up and link an active billing account”(设置并关联一个有效的结算账户) |
| Tier 2 | “Paid $100 + 3 days from first successful payment”(已支付 100 美元,且距首次成功付款满 3 天) |
| Tier 3 | “Paid $1,000 + 30 days from first successful payment”(已支付 1,000 美元,且距首次成功付款满 30 天) |
除请求数限制外,付费等级还有按滚动 10 分钟窗口计量的支出限制,超出同样会返回 429 RESOURCE_EXHAUSTED。视频是你能请求的最昂贵的内容,因此短时间内的一批 Veo 任务触及支出限制的速度,远快于文本流量。
六种原因
1. 你用完了 Veo 的每日配额
在论坛帖子中,Tier 1 项目的 Veo 限制为每个模型每分钟 2 次请求、每天 10 次请求。十段视频,也就是一个下午的测试量。重试没有用;计数器要到太平洋时间午夜才会重置。
2. 你触及了支出限制
十分钟内提交几段视频,即使请求计数器还有余量,也可能越过 Tier 1 的支出限制。请把任务错开提交,或升级到更高等级。
3. 密钥属于另一个项目
限制和等级属于项目。如果你在一个项目上开通了结算,而代码使用的是在另一个项目下创建的密钥,那么你仍然适用另一个项目的限制。在同一项目中新建密钥不会有任何改变。
4. 预付余额为空
Google 论坛上关于 429 错误的指引指出,预付余额耗尽同样会使响应中断。在查看配额之前,请先检查余额。
5. 等级与你付费时的不一致
在一个2026 年 8 月的帖子中,一位开发者的项目已被确认为 Tier 2,几天后却发现退回了 Tier 1,Veo 每日限制从 50 降到 10,生成失败。结算支持无法更改;帖子中的一条回复指向了一个用于报告意外等级降级的表单,问题在两天后得到解决。
6. 配额显示未使用,却仍然返回 429
这是唯一没有自助解决办法的情况。在一个2026 年 9 月的帖子中,一位 Tier 1 开发者的预付余额为正,控制台中每个 Veo 模型都显示 0/2 RPM 和 0/10 RPD,但第一次请求就收到了 429,而同一密钥下的其他 Gemini 调用都成功。另一位开发者也报告了相同的数字。唯一的回复只是询问项目 ID 和一次失败请求的时间。6 月的一个更早的帖子描述了每日配额超过 48 小时未重置的情况;该帖被自动关闭,没有得到答复。
按此顺序排查
- 密钥属于哪个项目? 在 AI Studio 中打开该密钥并记下项目。确认关联了结算的是这个项目,而不是别的项目。
- 该项目处于哪个等级? 从该项目的速率限制页面读取,而不是看确认邮件。
- Veo 那一行显示什么? 如果 RPD 已达上限,请等到太平洋时间午夜。如果显示未使用,继续往下。
- 是否有预付余额,是否触及支出上限?
- 你是否在几分钟内发送了多个视频任务? 等待十分钟,然后只发送一个。
- 配额未使用却仍然失败? 收集项目 ID、模型 ID、一次失败请求的 UTC 时间,以及速率限制页面的截图。把它们发布到 Google AI Developers Forum;如果等级看起来不对,请使用上述帖子中提到的等级降级表单。Google 声明:“We offer no guarantees about increasing your rate limit.”(我们不保证会提高你的速率限制。)
在代码中正确处理
Google 的故障排查指南建议对 429 使用指数退避。这对按分钟计的限制是对的,对按天计的限制则毫无用处,所以要限制重试次数,然后停止。
import random
import time
def call_with_backoff(submit, max_attempts=4):
for attempt in range(max_attempts):
try:
return submit()
except Exception as err:
if "RESOURCE_EXHAUSTED" not in str(err):
raise
if attempt == max_attempts - 1:
# 每分钟限制在几次重试内就会解除。
# 如果还停在这里,说明是每日限制或账户级限制:
# 停止重试,切换到第二条路线。
raise
time.sleep(min(60, 2 ** attempt * 5) + random.random())
把视频任务排队发送,而不是并行发送,并按太平洋时间的日期为每个模型记录请求计数,这样你就能在 Google 告诉你之前知道自己已接近限制。
调用 Veo 的另一种方式
如果你的产品依赖 Veo,而每天十次请求不够用,你需要一条不经过同一项目配额的第二条路线。Google 自家的替代方案是 Vertex AI,它有独立的配额,但需要配置 Google Cloud。
WaveSpeedAI 通过其 API 提供 Veo 3.1 和 Veo 3.1 Fast,支持文生视频和图生视频:
- 任何有余额的账户都可使用。 无需申请预览配额。
- 按请求付费。 你所选设置对应的价格会在运行前显示在模型页面上。
- 无冷启动,失败的任务全额退款。
- 一个 API 对接所有模型。 同样的两个调用适用于 Veo、Kling、Seedance、Wan 以及目录中的其他模型,因此几分钟内就能加上第二个模型作为备用。
curl --request POST 'https://api.wavespeed.ai/api/v3/google/veo3.1-fast/text-to-video' \
--header "Authorization: Bearer $WAVESPEED_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"prompt": "A paper boat drifting down a rain-soaked street at dusk, cinematic, shallow depth of field"}'
curl --request GET "https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result" \
--header "Authorization: Bearer $WAVESPEED_API_KEY"
第一个调用返回 data.id;第二个返回 data.status,完成后在 data.outputs 中返回视频 URL。速率限制取决于你的账户等级,详见文档。
如需无代码试用,请打开视频生成器。
常见问题
为什么我的配额显示已用 0,Veo 却返回 429 RESOURCE_EXHAUSTED?
可能是密钥所属项目与你正在查看配额的项目不同;可能是支出限制或预付余额为空阻止了请求;也可能是该项目的 Veo 配额工作不正常。2026 年有多位开发者在付费 Tier 1 项目上报告了最后一种情况,需要 Google 检查该项目。
Gemini API Tier 1 的 Veo 速率限制是多少?
Google 的速率限制页面没有列出 Veo。根据 2026 年的开发者报告,Tier 1 的控制台显示每个 Veo 模型每分钟 2 次请求、每天 10 次请求。请在你自己项目的速率限制页面查看当前数值。
Veo 每日配额何时重置?
根据 Google 的文档,在太平洋时间午夜重置。
换一个新的 API 密钥能解决 429 吗?
如果新密钥在同一项目中创建,则不能。限制按项目计算,而不是按密钥。
如何获得更高的 Veo 限制?
通过付款记录升到下一等级(Tier 2 需要已支付 100 美元,且距首次成功付款满三天),或提交 Google 的速率限制提升申请表。Google 不保证一定会提高限制。
不使用 Gemini API 配额也能用 Veo 吗?
可以。Vertex AI 有自己的配额,WaveSpeedAI 等平台也通过各自的 API 以按请求计费的方式提供 Veo 3.1。
/filters:quality(82)/media/images/1773962750383987480_n3hqzHRZ.webp)