AIFreeAPI Logo

Gemini API 分层速率限制:查清当前限额与 429 原因

A
10 分钟阅读API 指南

Gemini API 层级决定你能获得哪一类限额,不代表所有模型都有同一个固定 RPM。可用额度要结合结算账号、项目、模型、请求方式和 AI Studio 当前读数判断。

Gemini API 分层速率限制总览,展示层级资格、当前限额、429 限制维度与对应处理

Gemini API 的 Free、Tier 1、Tier 2、Tier 3 不能简单换算成“每分钟固定能发多少次请求”。Google 当前要求开发者在 AI Studio 查看项目和模型的生效限额,并明确说明公开列出的限额不构成容量保证,实际可用容量可能变化。

因此,遇到 429 RESOURCE_EXHAUSTED 时,先不要拿旧文章里的 RPM 数字作结论。真正要确认的是:请求用了哪个项目、继承哪个结算账号与用量层级、调用哪个模型和版本、走普通请求还是 Priority/Batch,以及哪一项当前限额被触发。

先把层级、项目和当前限额分开

Google 的 Gemini API 速率限制文档 把 tier 作为影响限额的因素之一,而不是一张适用于所有模型的永久配额表。

一次容量判断至少要看三处信息:

  1. Projects / API keys:确认 API key 属于哪个项目,项目关联哪个结算账号,以及当前 tier。
  2. Dashboard 的 Rate Limit:查看该项目、模型和层级当前生效的 RPM、输入 TPM、RPD 或模型专属限制。
  3. Dashboard 的 Usage:把同一项目、同一时间段的实际用量与当前限额比较。

API key 本身没有独立的层级或结算配置。一个项目内的多个 key 共享项目用量;创建更多 key 不会把 RPM 或 TPM 乘倍。项目关联到结算账号后,还会继承该结算账号的 tier 与账号级支出上限。

2026 年 9 月的层级资格与支出限制

截至 2026 年 9 月 2 日,Google 的 Gemini API 结算说明 给出的资格如下。表中的结算上限和十分钟支出上限,不是某个模型的 RPM。

用量层级当前资格结算账号月度上限滚动 10 分钟支出上限
Free活跃项目或免费试用不适用不适用
Tier 1设置并关联活跃结算账号$250$10
Tier 2累计已支付 $100,且距首次成功付款 3 天$2,000$50
Tier 3累计已支付 $1,000,且距首次成功付款 30 天$20,000–$100,000+$200

Tier 2 和 Tier 3 的累计支出按关联结算账号计算,包括该账号下项目产生的 Google Cloud 服务支出,并不只统计某一个 Gemini API key。符合条件后系统通常自动升级;Free 到 Tier 1 通常立即生效,后续升级通常在 10 分钟内更新,但仍可能受处理和审核影响。应在 AI Studio 的 Projects 页面确认结果,不要仅凭付款成功判断 tier 已经改变。

滚动十分钟支出限制已于 2026 年 9 月 12 日复核,见官方速率限制页。Google 说明它是否适用于某个账号还取决于结算历史和账号状态。即使请求数和输入 token 都低于当前显示值,十分钟内高成本调用超过对应支出上限,也会得到 429。

429 可能来自哪一项限制

Google 目前列出的常见维度包括:

  • RPM:每分钟请求数。短时间并发突增最容易触发。
  • 输入 TPM:每分钟输入 token 数。长上下文和多个并行大请求可能在 RPM 很低时先触发。
  • RPD:每天请求数。它在太平洋时间午夜重置,不按中国或用户本地午夜重置。

部分模型还有专属维度。能生成图片的模型可能计算 IPM(每分钟图片数),其他模型可能有 TPD(每天 token 数)。任何一项达到上限都可以拒绝请求;“RPM 还有余量”并不能排除 TPM、RPD、IPM、TPD 或支出上限。

如果 AI Studio 显示当前 RPM 和输入 TPM,可以先估算有效吞吐:

每分钟可处理请求数 ≈ min(当前 RPM, floor(当前输入 TPM / 单次平均输入 token))

这不是 Google 新增的配额,只是容量规划公式。假设同一项目的调用从短问题变成长文档,即使并发和 RPM 不变,输入 TPM 也可能成为新的瓶颈。生产系统还应为流量波动留出余量,不要把公开标注的限额当作百分之百可持续容量。

用同一个项目和模型核对 Dashboard

排查前先从失败请求中记录 API key 对应的项目、完整模型 ID、API 版本、请求端点和发生时间。随后在 AI Studio 中核对同一对象:

  1. 确认 API key 与项目的对应关系,以及项目与结算账号的关系的结算账号和 tier。
  2. 在 Rate Limit 中选择失败请求实际使用的模型和层级。
  3. 在 Usage 中查看同一项目和时间段,而不是另一个 key 或项目。
  4. 确认请求属于普通交互流量、Priority inference 还是 Batch API。

Priority inference 有自己的速率限制。Google 当前写明默认值为同模型、同 tier 标准限额的 0.3 倍,同时 Priority 用量仍计入整体交互流量。普通请求的限额不能原样套给 Priority 请求。

Batch API 与非 Batch 请求分开计算。当前公开限制包括最多 100 个并发 Batch 请求、单个输入文件 2 GB、文件存储 20 GB,以及按模型和 tier 变化的排队 token 上限。完整模型表会随版本改变,应查看 实时 Batch 限额,不要把旧表当成长期不变的容量依据。

Gemini API 项目与结算账号的关系、当前层级、AI Studio 核对、限制维度和容量记录的详细检查图
Gemini API 项目与结算账号的关系、当前层级、AI Studio 核对、限制维度和容量记录的详细检查图

根据触发项选择处理方法

观察到的现象更可能的限制对应动作
一阵并发后立即 429RPM用项目级队列平滑请求,控制并发,经过有上限的等待后重试
请求不多,但每次输入很长输入 TPM去掉重复上下文、减少并行大请求,只检索必要内容
错误明确指向日用量耗尽RPD 或模型 TPD等待对应重置;长期需要则评估合适的付费 tier
高成本请求在十分钟内密集失败支出速率上限等待滚动窗口,降低上下文或输出成本,必要时申请提高限额
只有 Priority 请求失败Priority 专属限制查看 Priority 当前值;只有延迟要求允许时才切回标准请求
Batch 任务无法排队并发 Batch 或排队 token等已有任务完成、缩小批次,或查看该模型的实时 Batch 表
Dashboard 用量低但仍 429项目/模型看错、tier 未更新或容量变化重新核对密钥所属项目、模型 ID 与用量层级,并带齐信息申请限额或联系支持

提高 tier 不能解决所有 429。项目看错、预览版模型限额更紧、所有工作进程同时重试,都会在更高层级下继续制造问题。

重试只能处理暂时性失败

Google 的 故障排查说明 建议对 429、503 等暂时性错误采用指数退避,加入随机抖动并设置最大重试次数。官方 SDK 对部分暂时性错误已经包含自动重试;自己再加一层前,应先确认 SDK 行为。

退避不会增加 RPM、TPM、RPD 或支出容量。如果每个进程都用相同时间重试,下一轮会形成新的突发。更可靠的做法是按项目共享队列或限速器,因为同一项目的多个 key 共用限额。

不要把 400403 当作暂时限流反复重试。它们通常表示请求参数、模型支持、认证或权限问题。可使用 Gemini API 错误排查指南 分开处理。

Gemini API 用量层级、容量公式、Priority、Batch 与 429 处理矩阵的运维图
Gemini API 用量层级、容量公式、Priority、Batch 与 429 处理矩阵的运维图

留下可复核的容量记录

真正能支持生产决策的记录,应包含日期、结算账号、项目、tier、完整模型 ID、请求方式、AI Studio 当前 RPM/TPM/RPD 或模型专属值、平均输入 token、并发和十分钟峰值支出。这样下一次模型或层级变化时,可以重新计算,而不是继续引用一张来源不明的旧表。

如果任务只是确认免费额度是否够做原型,可继续看 Gemini API 免费额度指南。如果已经确定是普通 API 错误,则进入错误排查。

把 tier 当成资格,把 AI Studio 当成当前项目记录,把失败请求当成诊断对象,就能在 Google 调整模型、门槛或界面后继续得到可靠答案。