# Gemini API 速率限制 2026：按项目计算，429 对应哪种限额、怎么提额 > Gemini API 的 RPM、TPM、RPD 按项目计算，多建 Key 不加额度，数值在 AI Studio 查看。429 分每分钟、每日和花费上限，402 是预付余额用完。 - URL: https://blog.laozhang.ai/zh/posts/gemini-api-rate-limits-guide - Published: 2026-02-02 - Updated: 2026-10-05 - Author: LaoZhang AI Team (https://blog.laozhang.ai/zh/about) - Topic: API 接入指南 - Tags: Gemini API, 速率限制, 429 错误, 使用层级, RESOURCE_EXHAUSTED, Google AI Studio --- Gemini Developer API（用 AI Studio 创建的 Key 调用）的速率限制按**项目**计算，不按 API Key：同一项目里多建几个 Key，额度不会增加。限额有三个基本维度，每分钟请求数（RPM）、每分钟输入 token 数（TPM）和每日请求数（RPD），图片模型另有每分钟图片数（IPM），部分模型还有每日 token 数（TPD）。各模型在你这个层级的具体数值，Google 只在 [AI Studio 的速率限制页](https://aistudio.google.com/rate-limit)显示，文档不印数值表，并且说明列出的限额不保证、实际容量可能不同。 除了这几项，付费项目还受两道和钱有关的上限约束：按使用层级设定的**滚动 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 的[速率限制文档](https://ai.google.dev/gemini-api/docs/rate-limits?hl=zh-cn)（2026 年 9 月 2 日更新）和[结算文档](https://ai.google.dev/gemini-api/docs/billing?hl=zh-cn)（2026 年 9 月 28 日更新）。 ## Gemini API 有哪些限额：每分钟、每日、10 分钟花费和月度上限 任何一个维度超限都会报错。Google 文档举的例子是：RPM 上限为 20 时，一分钟内发出第 21 个请求就会失败，即使 TPM 还远没用完。下面这张表把各类限额按"在哪一级计算"排开： | 限额 | 计算什么 | 在哪一级计算 | 什么时候恢复 | |---|---|---|---| | RPM | 每分钟请求数 | 项目，按模型分别计 | 下一分钟 | | TPM | 每分钟输入 token 数 | 项目，按模型分别计 | 下一分钟 | | RPD | 每日请求数 | 项目，按模型分别计 | 太平洋时间零点 | | IPM | 每分钟生成的图片数，只用于 Nano Banana 这类图片模型 | 项目，按模型分别计 | 下一分钟 | | TPD | 每日 token 数，只有部分模型有 | 项目，按模型分别计 | 按日计算 | | 10 分钟花费上限 | 滚动 10 分钟内的花费 | 由使用层级决定，层级跟着结算账号走 | 窗口滚过去之后 | | 月度花费上限 | 结算账号下所有启用 Gemini API 的项目当月合计花费 | 结算账号 | 下个月 1 日 | | Batch 排队 token | 所有进行中的批量任务里排队的 token | 项目，按模型分别计 | 任务完成后不再占用 | ![Gemini API 各类限额的计算窗口、归属与下一步对照图](https://blog.laozhang.ai/posts/zh/gemini-api-rate-limits-guide/img/limit-owner-matrix.webp) 有三点最容易误判： - **按项目共享**：同一项目下的所有 Key、所有服务、所有同事的调用共用同一份 RPM、TPM、RPD。"我今天只调了几次"不能说明额度还在，要看整个项目的用量。 - **失败的请求也占额度**：返回 400 或 500 的请求不收费，但仍计入限额。代码里没有上限的重试循环，会把额度消耗在失败请求上。 - **实验版和预览版模型的限额更紧**。同一个项目里，正式版模型还能用、预览版模型已经 429，属于正常现象。 ## 在哪看自己的限额：AI Studio 速率限制页和项目页 自己的实际限额去 AI Studio 看，入口有三个： 1. **[速率限制页](https://aistudio.google.com/rate-limit)**：选中报错的那个项目，查看各模型当前的 RPM、TPM、RPD 等数值和用量。层级或账号状态变化后，这里的数值会自动更新。 2. **[项目页](https://aistudio.google.com/projects)**：Billing Tier 一列显示项目当前的使用层级和结算方式。需要处理的结算状态也显示在这里：没有关联结算账号显示 "Set up billing"，需要开通预付显示 "Set up Prepay"，预付账户没设置好或余额用完显示 "No credits"，点击即可进入对应操作。 3. **Dashboard > Usage**：查看项目的历史用量，用来核对报错那段时间的请求量是否真的到顶。 Google 文档不公布各层级、各模型的 RPM 数值，所以写着"免费层几 RPM、Tier 3 几千 RPM"的分层数值表都不是 Google 公布的数据，不能拿来规划容量。规划时以速率限制页上自己项目的数值为准，并预留余量。 如果你还在用免费层，哪些模型免费、免费额度怎么变化，见 [Gemini API 免费层速率限制](https://blog.laozhang.ai/zh/posts/gemini-api-free-tier)。在 AI Studio 里直接试用模型不收费，只有关联了付费 Key 才开始计费。另外，Gemini API 和 AI Studio 的[支持地区列表](https://ai.google.dev/gemini-api/docs/available-regions?hl=zh-cn)里没有中国大陆和中国香港，在这些地区无法正常使用。 ## 使用层级怎么升：Tier 1 绑结算，Tier 2、Tier 3 看累计付款和天数 层级决定 RPM 等限额的大小，也决定两道花费上限。截至 2026 年 10 月 5 日，Google 公布的条件和上限如下： | 层级 | 升级条件 | 滚动 10 分钟花费上限 | 结算账号月度上限 | |---|---|---|---| | 免费 | 有效项目或免费试用 | 不适用 | 不适用 | | Tier 1 | 设置并关联有效的结算账号 | $10 | $250 | | Tier 2 | 累计付款 $100，且距首次成功付款满 3 天 | $50 | $2,000 | | Tier 3 | 累计付款 $1,000，且距首次成功付款满 30 天 | $200 | $20,000–$100,000+ | 这张表背后有几条规则： - **层级跟着结算账号走**。关联到同一个结算账号的所有项目继承同一个层级；把项目换到另一个结算账号，层级也随之改变；解除结算关联，项目回到免费层。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 计费层级详解](https://blog.laozhang.ai/zh/posts/google-gemini-billing-tier-policy-changes)。 **10 分钟花费上限换算成图片数量**：Nano Banana Pro 的 1K/2K 图片每张 $0.134，Tier 1 的 $10 ÷ $0.134 ≈ 74 张（向下取整），4K 每张 $0.24 则约 41 张。这只算图片输出，不含输入和思考 token，实际能生成的会更少。图片价格见 [Gemini 3 Pro Image API 定价](https://blog.laozhang.ai/zh/posts/gemini-3-pro-image-api-pricing)，图片项目怎么扩容见 [Nano Banana Pro API 提额](https://blog.laozhang.ai/zh/posts/increase-nano-banana-pro-api-quota)。 想把项目一路升到 Tier 3，具体步骤和等待期见 [Gemini API Key 申请与升级到 Tier 3](https://blog.laozhang.ai/zh/posts/gemini-t3-api-key-guide)。 ## 报 429 还是 402：按错误判断撞了哪条限额 429 说明撞到了某条限额，但不同限额的处理方式完全不同，先按下表对上号。Interactions API 会在错误里给出 `rate_limit_exceeded`、`quota_exceeded` 这样的错误类型；`generateContent` 则统一返回 `429 RESOURCE_EXHAUSTED`，要看错误消息里说的是每分钟、每日还是花费。 | 你看到的 | 撞到的限额 | 该怎么做 | |---|---|---| | 429，`rate_limit_exceeded`，或消息指向每分钟请求数、token 数 | RPM、TPM（图片模型还有 IPM） | 指数退避后重试，降低并发，缩短输入 | | 429，`quota_exceeded`，或消息指向每日配额 | RPD | 等太平洋时间零点重置，或申请提额；重试没有用 | | 429 `RESOURCE_EXHAUSTED`，出现在短时间大量高价请求之后 | 滚动 10 分钟花费上限 | 稍等再试，减少高价请求（缩短上下文、减少输出）；正常用量下也反复撞到就申请提额 | | 402 `payment_required` | 预付余额为 $0 | 充值；不要重试 | | 结算账号下所有项目同时停止服务，预付余额仍大于 $0 | 结算账号月度花费上限 | 等到下个月 1 日恢复，或申请提高上限 | | 503 `UNAVAILABLE` | 服务端暂时过载，不是你的限额 | 指数退避后重试 | 后两种情况影响面最大，值得单独说明： - **预付余额归零时**，该结算账号下所有项目的所有 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](https://blog.laozhang.ai/zh/posts/paid-tier-getting-free-tier-requests-limit-0) 排查。图片模型的 429（IPM、每日图片数、花费上限）见 [Gemini 图片生成 429 速率限制](https://blog.laozhang.ai/zh/posts/gemini-image-429-rate-limit)。 ## 429 怎么重试：google-genai 的 generate_content 默认不重试 Google 的[问题排查文档](https://ai.google.dev/gemini-api/docs/troubleshooting?hl=zh-cn)给的规则是：只重试临时错误（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` 时，直接显式打开重试： ```python 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 日的[速率限制文档](https://ai.google.dev/gemini-api/docs/rate-limits?hl=zh-cn)： - 同时进行的批量任务最多 100 个； - 单个输入文件最大 2 GB，文件存储总量 20 GB； - 每个模型有"排队 token 数"上限，即所有进行中的批量任务里等待处理的 token 总量，数值按层级列在速率限制文档的 Batch 表里。 按 [Batch API 文档](https://ai.google.dev/gemini-api/docs/batch-api?hl=zh-cn)，Batch 价格是标准调用的 50%，目标在 24 小时内完成，多数任务会快得多。要注意创建批量任务不是幂等操作：保存好返回的任务名，创建请求超时后先查任务列表，不要直接重新提交，否则可能跑两遍、付两次钱。图片批量任务的成本取舍见 [Nano Banana Pro Batch API 成本](https://blog.laozhang.ai/zh/posts/nano-banana-pro-batch-api-cost-optimization)。 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](https://forms.gle/ETzX94k8jf7iSotH9)"，可以申请提高付费层的速率限制，也可以申请提高结算账号的月度上限。Google 写明不保证批准，只承诺尽量审核，没有给出处理时长。 不建议用多开项目、多开账号的办法分摊限额。同一项目里多建 Key 不增加任何额度；同一结算账号下的多个项目共用层级和月度上限。多开账号不在 Google 提供的提额途径里，换来的容量也没有任何保证。 如果瓶颈不是 Google 的限额本身，而是需要在 Google 项目之外另接一条付费通道（例如多模型统一调用、按量付费），[laozhang.ai](https://docs.laozhang.ai/) 这类 API 网关是另一份独立计费的服务，不会提高你 Google 项目的任何限额；接入前要按它的文档另行核对模型版本、价格、超时和数据处理方式。 *说明：[laozhang.ai 是我们自己的服务](https://blog.laozhang.ai/zh/about#laozhang)，其价格是平台报价，不是独立比较的结论。* ## Firebase AI Logic 与 Vertex AI 的限额另算 "Gemini"这个名字同时出现在 Gemini 应用、Developer API、Firebase AI Logic 和 Vertex AI 里，各自的限额在不同地方查看，不能互相推断。Gemini 应用（网页和手机 App）的使用次数按订阅方案计算，和 API 限额无关。 ![Gemini 应用、Developer API、Firebase AI Logic 与 Vertex AI 的限额归属与查看位置](https://blog.laozhang.ai/posts/zh/gemini-api-rate-limits-guide/img/surface-owner-map.webp) **Firebase AI Logic** 在模型提供方限额之外，又加了一层每用户速率限制，默认每个用户 100 RPM，可以调整（需要 Owner 或 Editor 角色所含的权限）。按 [Firebase 配额文档](https://firebase.google.com/docs/ai-logic/quotas?hl=zh-cn)，Gemini API 这一侧的限额仍然生效并且优先。所以会出现两种情况：每个用户都没到 100 RPM，所有用户加起来却耗尽了项目限额；或者某一个客户端单独撞到了每用户限制，项目限额还很充足。调高每用户限制不会扩大项目限额。 **Vertex AI** 走 Google Cloud 自己的配额体系，和 AI Studio 显示的数值无关。它的 429 分按量付费和预配吞吐量（Provisioned Throughput）两种情况，处理方式包括使用全局端点、截断指数退避，以及注意流量突增时的加速限制，见 Google Cloud 的 [429 错误文档](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/deploy/error-code-429)。要不要从 Developer API 换到 Vertex AI，见 [Gemini API 和 Vertex AI API 怎么选](https://blog.laozhang.ai/zh/posts/gemini-api-vs-vertex-api)。 ## Gemini API 速率限制常见问题 ### Gemini API 免费层级的速率限制是多少？ 以 AI Studio 速率限制页上你项目的数值为准。Google 不公布固定的分层数值表，免费层可用的模型和额度也变动过多次。哪些模型目前还能免费用、免费层的常见报错，见 [Gemini API 免费层速率限制](https://blog.laozhang.ai/zh/posts/gemini-api-free-tier)。 ### 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 计费层级详解](https://blog.laozhang.ai/zh/posts/google-gemini-billing-tier-policy-changes)逐项核对。 ### Gemini 限制怎么解除？ 没有"解除"开关，只能按正规方式提高：削峰并缓存重复请求，离线任务改用 Batch，满足条件后升级层级，或提交 Google 的提额申请表（不保证批准）。RPD 用完只能等太平洋时间零点重置，月度上限用完要等下个月 1 日或申请提高上限。 ### 已经开通结算，为什么还是 429？ 开通结算只是进了 Tier 1。项目仍可能撞到 RPM、TPM、RPD、模型自己的限制，或 Tier 1 每 10 分钟 $10 的花费上限；预付余额用完时返回的是 402。按上面的报错表逐项对照，而不是反复解绑、重绑结算账号。 ## 参考来源 本文引用的外部页面，按正文出现顺序排列。最后更新于 2026-10-05。 - [AI Studio 的速率限制页](https://aistudio.google.com/rate-limit) (aistudio.google.com) - [速率限制文档](https://ai.google.dev/gemini-api/docs/rate-limits?hl=zh-cn) (ai.google.dev) - [结算文档](https://ai.google.dev/gemini-api/docs/billing?hl=zh-cn) (ai.google.dev) - [项目页](https://aistudio.google.com/projects) (aistudio.google.com) - [支持地区列表](https://ai.google.dev/gemini-api/docs/available-regions?hl=zh-cn) (ai.google.dev) - [问题排查文档](https://ai.google.dev/gemini-api/docs/troubleshooting?hl=zh-cn) (ai.google.dev) - [Batch API 文档](https://ai.google.dev/gemini-api/docs/batch-api?hl=zh-cn) (ai.google.dev) - [Gemini API Quota and Billing Cap Increase Request](https://forms.gle/ETzX94k8jf7iSotH9) (forms.gle) - [Firebase 配额文档](https://firebase.google.com/docs/ai-logic/quotas?hl=zh-cn) (firebase.google.com) - [429 错误文档](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/deploy/error-code-429) (docs.cloud.google.com)