Gemini API 速率限制 2026：按项目计算，429 对应哪种限额、怎么提额

Gemini Developer API（用 AI Studio 创建的 Key 调用）的速率限制按项目计算，不按 API Key：同一项目里多建几个 Key，额度不会增加。限额有三个基本维度，每分钟请求数（RPM）、每分钟输入 token 数（TPM）和每日请求数（RPD），图片模型另有每分钟图片数（IPM），部分模型还有每日 token 数（TPD）。各模型在你这个层级的具体数值，Google 只在 AI Studio 的速率限制页显示，文档不印数值表，并且说明列出的限额不保证、实际容量可能不同。

除了这几项，付费项目还受两道和钱有关的上限约束：按使用层级设定的滚动 10 分钟花费上限（Tier 1 为 $10，Tier 2 为 $50，Tier 3 为 $200），以及结算账号的月度花费上限（Tier 1 为 $250，Tier 2 为 $2,000，Tier 3 为 $20,000 到 $100,000 以上）。报 429 时，可能是每分钟、每日或 10 分钟花费上限中的任何一条；报 402 则是预付余额用完。以下规则截至 2026 年 10 月 5 日，来自 Google 的速率限制文档（2026 年 9 月 2 日更新）和结算文档（2026 年 9 月 28 日更新）。

Gemini API 有哪些限额：每分钟、每日、10 分钟花费和月度上限

任何一个维度超限都会报错。Google 文档举的例子是：RPM 上限为 20 时，一分钟内发出第 21 个请求就会失败，即使 TPM 还远没用完。下面这张表把各类限额按"在哪一级计算"排开：

有三点最容易误判：

• 按项目共享：同一项目下的所有 Key、所有服务、所有同事的调用共用同一份 RPM、TPM、RPD。"我今天只调了几次"不能说明额度还在，要看整个项目的用量。
• 失败的请求也占额度：返回 400 或 500 的请求不收费，但仍计入限额。代码里没有上限的重试循环，会把额度消耗在失败请求上。
• 实验版和预览版模型的限额更紧。同一个项目里，正式版模型还能用、预览版模型已经 429，属于正常现象。

在哪看自己的限额：AI Studio 速率限制页和项目页

自己的实际限额去 AI Studio 看，入口有三个：

1. 速率限制页：选中报错的那个项目，查看各模型当前的 RPM、TPM、RPD 等数值和用量。层级或账号状态变化后，这里的数值会自动更新。
2. 项目页：Billing Tier 一列显示项目当前的使用层级和结算方式。需要处理的结算状态也显示在这里：没有关联结算账号显示 "Set up billing"，需要开通预付显示 "Set up Prepay"，预付账户没设置好或余额用完显示 "No credits"，点击即可进入对应操作。
3. Dashboard > Usage：查看项目的历史用量，用来核对报错那段时间的请求量是否真的到顶。

Google 文档不公布各层级、各模型的 RPM 数值，所以写着"免费层几 RPM、Tier 3 几千 RPM"的分层数值表都不是 Google 公布的数据，不能拿来规划容量。规划时以速率限制页上自己项目的数值为准，并预留余量。

如果你还在用免费层，哪些模型免费、免费额度怎么变化，见 Gemini API 免费层速率限制。在 AI Studio 里直接试用模型不收费，只有关联了付费 Key 才开始计费。另外，Gemini API 和 AI Studio 的支持地区列表里没有中国大陆和中国香港，在这些地区无法正常使用。

使用层级怎么升：Tier 1 绑结算，Tier 2、Tier 3 看累计付款和天数

层级决定 RPM 等限额的大小，也决定两道花费上限。截至 2026 年 10 月 5 日，Google 公布的条件和上限如下：

这张表背后有几条规则：

• 层级跟着结算账号走。关联到同一个结算账号的所有项目继承同一个层级；把项目换到另一个结算账号，层级也随之改变；解除结算关联，项目回到免费层。API Key 没有自己的结算设置，继承所在项目的层级和结算状态。
• Tier 2、Tier 3 的累计付款算的是整个结算账号在 Google Cloud 上的花费，不只是 Gemini API。
• 10 分钟花费上限不一定对每个账号生效，Google 的说法是取决于结算历史和账号状况；撞到时返回 429 RESOURCE_EXHAUSTED。
• 升级是自动的。从免费层升到 Tier 1 通常立即生效，之后的升级一般在 10 分钟内生效。满足条件后通常都会通过，但 Google 也说明极少数情况下会因其他因素被拒。升级是否生效，回到项目页的 Billing Tier 一列确认。
• 开通 Tier 1 的方式：在 AI Studio 的 API Key 页或项目页点 "Set up billing"，选择或新建 Cloud 结算账号。2026 年 3 月 23 日之后新用户默认用预付方式，需要先充值至少 $5；也有部分账号被分配为后付或可以自己选。Google Cloud 的 $300 新用户赠金不能用来支付 Gemini API 费用（2026 年 3 月 2 日之后开的账号）。预付、后付和 "No credits" 的细节见 Gemini API 计费层级详解。

10 分钟花费上限换算成图片数量：Nano Banana Pro 的 1K/2K 图片每张 $0.134，Tier 1 的 $10 ÷ $0.134 ≈ 74 张（向下取整），4K 每张 $0.24 则约 41 张。这只算图片输出，不含输入和思考 token，实际能生成的会更少。图片价格见 Gemini 3 Pro Image API 定价，图片项目怎么扩容见 Nano Banana Pro API 提额。

想把项目一路升到 Tier 3，具体步骤和等待期见 Gemini API Key 申请与升级到 Tier 3。

报 429 还是 402：按错误判断撞了哪条限额

429 说明撞到了某条限额，但不同限额的处理方式完全不同，先按下表对上号。Interactions API 会在错误里给出 rate_limit_exceeded、quota_exceeded 这样的错误类型；generateContent 则统一返回 429 RESOURCE_EXHAUSTED，要看错误消息里说的是每分钟、每日还是花费。

后两种情况影响面最大，值得单独说明：

• 预付余额归零时，该结算账号下所有项目的所有 API Key 会同时停止工作，请求一律返回 HTTP 402，直到充值为止。结算数据有大约 10 分钟的延迟，Batch 和智能体这类长任务可能在系统停掉之前继续消耗，余额因此变成负数，负数部分会从下次充值里扣除。打开自动充值可以避免中断。
• 月度上限触顶时，结算账号下所有启用 Gemini API 的项目一起暂停，直到下个月 1 日。Google 结算文档里的对应问题是"预付余额大于 $0，为什么还是停了"，答案就是撞到了当前层级的月度上限。2026 年 4 月一位开发者在 Google AI 开发者论坛贴出的报错原文是 Your billing account has exceeded its monthly spending cap. Please go to AI Studio at https://ai.studio/billing to manage your billing，这是用户报告，措辞可能变化。

如果项目已经付费，429 消息里却写着免费层配额 limit: 0，这是另一类问题，按 Gemini API 已付费仍报 free_tier_requests limit 0 排查。图片模型的 429（IPM、每日图片数、花费上限）见 Gemini 图片生成 429 速率限制。

429 怎么重试：google-genai 的 generate_content 默认不重试

Google 的问题排查文档给的规则是：只重试临时错误（429、408、5xx），400、402、403 不重试；用指数退避（例如 1 秒、2 秒、4 秒、8 秒）加随机抖动，并设置最大重试次数。再结合上一节补一条：消息明确指向每日配额的 429，重试也恢复不了，应当停下。

同一份文档说 Python SDK 默认会自动重试临时错误最多 4 次。但用截至 2026 年 10 月 5 日的最新版 google-genai 2.28.0，对一个固定返回 429 RESOURCE_EXHAUSTED 的本地测试服务调用，结果是：

• client.models.generate_content 用默认的 genai.Client() 只发 1 次请求就抛出 APIError，没有重试；
• 显式传入 HttpRetryOptions 后共发出 5 次请求（4 次重试，约 17 秒），延迟从约 1 秒指数增长、封顶 60 秒，重试的状态码包括 408、429、500、502、503、504；
• 同版本的 client.interactions.create 默认会重试，共发出 4 次请求（约 3 秒）后抛出 RateLimitError。

JS、Go、Java SDK 没有做同样的测试。用 Python 调 generate_content 时，直接显式打开重试：

from google import genai
from google.genai import types

client = genai.Client(
    http_options=types.HttpOptions(
        # 默认 attempts=5：含首次请求共 5 次，延迟约 1 秒起、最长 60 秒
        retry_options=types.HttpRetryOptions()
    )
)

HttpRetryOptions 还可以设置 attempts、initial_delay、max_delay、exp_base、jitter、http_status_codes。打开之后 SDK 仍然抛出 429，说明它已经退避过一轮；这时在外面再套一层立即重试只会更快耗尽额度，该做的是降低并发：按项目和模型设一个并发上限（例如用队列或信号量），让多个工作进程不要在同一时刻一起醒来重试。

Batch 和 Priority：Batch 限额单独算，Priority 只有 0.3 倍

Batch API 的限额和普通调用分开计算，适合评测、标注、批量生成这类能等的任务，能把普通调用的 RPM 留给在线用户。截至 2026 年 10 月 5 日的速率限制文档：

• 同时进行的批量任务最多 100 个；
• 单个输入文件最大 2 GB，文件存储总量 20 GB；
• 每个模型有"排队 token 数"上限，即所有进行中的批量任务里等待处理的 token 总量，数值按层级列在速率限制文档的 Batch 表里。

按 Batch API 文档，Batch 价格是标准调用的 50%，目标在 24 小时内完成，多数任务会快得多。要注意创建批量任务不是幂等操作：保存好返回的任务名，创建请求超时后先查任务列表，不要直接重新提交，否则可能跑两遍、付两次钱。图片批量任务的成本取舍见 Nano Banana Pro Batch API 成本。

Priority（优先处理）不增加总额度。它有自己的限额，默认是同一模型、同一层级标准限额的 0.3 倍，并且用量仍然计入普通在线调用的总限额。它解决的是"这部分请求要优先处理"，不是"标准限额不够用"。

Gemini API 怎么提额：先削峰，再升层级或提交申请表

按代价从小到大，正规的提额路径是：

1. 先确认撞的是哪条。对照上面的报错表和速率限制页，确定是 RPM、TPM、RPD、花费上限还是月度上限，再动手。
2. 削峰和减量。请求排队、限制并发、缓存重复请求；TPM 不够时裁剪会话历史和检索内容；花费上限不够时减少高价请求。对 RPM 和 TPM，这一步往往就够了。
3. 能等的任务改走 Batch，把在线额度留给前台请求。
4. 升层级。满足条件后自动升级，通常 10 分钟内生效，限额随之提高。
5. 提交官方申请表。速率限制文档里的 "Request paid tier rate limit increase" 链接打开的是 Google 表单 "Gemini API Quota and Billing Cap Increase Request"，可以申请提高付费层的速率限制，也可以申请提高结算账号的月度上限。Google 写明不保证批准，只承诺尽量审核，没有给出处理时长。

不建议用多开项目、多开账号的办法分摊限额。同一项目里多建 Key 不增加任何额度；同一结算账号下的多个项目共用层级和月度上限。多开账号不在 Google 提供的提额途径里，换来的容量也没有任何保证。

如果瓶颈不是 Google 的限额本身，而是需要在 Google 项目之外另接一条付费通道（例如多模型统一调用、按量付费），laozhang.ai 这类 API 网关是另一份独立计费的服务，不会提高你 Google 项目的任何限额；接入前要按它的文档另行核对模型版本、价格、超时和数据处理方式。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

Firebase AI Logic 与 Vertex AI 的限额另算

"Gemini"这个名字同时出现在 Gemini 应用、Developer API、Firebase AI Logic 和 Vertex AI 里，各自的限额在不同地方查看，不能互相推断。Gemini 应用（网页和手机 App）的使用次数按订阅方案计算，和 API 限额无关。

Firebase AI Logic 在模型提供方限额之外，又加了一层每用户速率限制，默认每个用户 100 RPM，可以调整（需要 Owner 或 Editor 角色所含的权限）。按 Firebase 配额文档，Gemini API 这一侧的限额仍然生效并且优先。所以会出现两种情况：每个用户都没到 100 RPM，所有用户加起来却耗尽了项目限额；或者某一个客户端单独撞到了每用户限制，项目限额还很充足。调高每用户限制不会扩大项目限额。

Vertex AI 走 Google Cloud 自己的配额体系，和 AI Studio 显示的数值无关。它的 429 分按量付费和预配吞吐量（Provisioned Throughput）两种情况，处理方式包括使用全局端点、截断指数退避，以及注意流量突增时的加速限制，见 Google Cloud 的 429 错误文档。要不要从 Developer API 换到 Vertex AI，见 Gemini API 和 Vertex AI API 怎么选。

Gemini API 速率限制常见问题

Gemini API 免费层级的速率限制是多少？

以 AI Studio 速率限制页上你项目的数值为准。Google 不公布固定的分层数值表，免费层可用的模型和额度也变动过多次。哪些模型目前还能免费用、免费层的常见报错，见 Gemini API 免费层速率限制。

Gemini 的次数限制是按 API Key 算的吗？

不是。RPM、TPM、RPD 按项目计算，同一项目的所有 Key 共用一份额度。层级和月度花费上限则按结算账号计算，同一结算账号下的项目共用。

Gemini API 的 RPD 几点重置？

太平洋时间零点。换算成北京时间：夏令时期间（2026 年到 11 月 1 日为止）是下午 3 点，冬令时是下午 4 点。

Gemini API 配额、层级显示不可用怎么办？

先到 AI Studio 项目页看 Billing Tier 和 Status 两列：显示 "Set up billing" 是项目没有关联结算账号；"Set up Prepay" 是需要开通预付；"No credits" 是预付账户没设置好或余额用完。点击提示完成对应操作即可。如果结算都正常但层级迟迟不对，回到 Gemini API 计费层级详解逐项核对。

Gemini 限制怎么解除？

没有"解除"开关，只能按正规方式提高：削峰并缓存重复请求，离线任务改用 Batch，满足条件后升级层级，或提交 Google 的提额申请表（不保证批准）。RPD 用完只能等太平洋时间零点重置，月度上限用完要等下个月 1 日或申请提高上限。

已经开通结算，为什么还是 429？

开通结算只是进了 Tier 1。项目仍可能撞到 RPM、TPM、RPD、模型自己的限制，或 Tier 1 每 10 分钟 $10 的花费上限；预付余额用完时返回的是 402。按上面的报错表逐项对照，而不是反复解绑、重绑结算账号。