速率限制用于控制您在给定时间范围内可以向 Gemini API 发出的请求数量。这些限制有助于维护公平使用、防范滥用行为,并帮助所有用户保持系统性能。
速率限制的运作方式
速率限制通常从以下三个维度进行衡量:
- 每分钟请求数 (RPM)
- 每分钟 token 数(输入)(TPM)
- 每日请求数 (RPD)
系统会根据每个限制评估您的用量,超出其中任何一个限制都会触发速率限制错误。例如,如果您的 RPM 限额为 20,那么即使您未超出 TPM 或其他限额,在一分钟内发出 21 个请求也会导致错误。
速率限制是按项目(而非按 API 密钥)应用的。每日请求数 (RPD) 配额会在美国太平洋时间零点重置。
限制因所使用的具体模型而异,并且某些限制仅适用于特定模型。例如,每分钟图片数 (IPM) 仅针对能够生成图片的模型 (Nano Banana) 计算,但在概念上与 TPM 类似。其他模型可能有每日 token 数量限制 (TPD)。 内置工具也有特定的速率限制。例如,在 Gemini 3 及更新的模型上,依托 Google 搜索进行接地功能在 Gemini Developer API 上每个项目每天默认最多可发出 1,500 个请求 (RPD)(请参阅依托 Google 搜索进行接地)。
实验性模型和预览版模型的速率限制更为严格。
基于支出的速率限制
除了每分钟请求数 (RPM) 和每分钟 token 数 (TPM) 限制之外,Gemini API 还会强制执行基于支出的速率限制,以防止产生意外费用。这些限额是否适用于您的账号取决于您的结算历史记录和用量层级。
下表显示了每个用量层级基于支出的速率限制。这些限制在 10 分钟的滚动窗口中进行评估。这些限制是否适用于您的账号取决于您的账单历史记录和账号信誉。
| 使用层 | 支出速率限制(每 10 分钟) |
|---|---|
| 免费 | 不适用 |
| 第 1 层级 | $10 |
| 第 2 层级 | $50 |
| 第 3 层级 | $200 |
如果您达到基于支出的速率限制,API 会返回 429 RESOURCE_EXHAUSTED 错误。如需解决此问题,请执行以下操作:
- 等待片刻,然后重试。
- 降低高成本请求的速率,例如使用较小的上下文窗口或较短的输出。
- 如果您在正常使用期间始终达到此限制,请申请提高速率限制。
使用层级
速率限制与项目的用量层级相关。随着 API 用量和支出的增加,您将自动升级到具有更高速率限制的更高层级。
第 2 层级和第 3 层级的资格条件取决于与您的项目关联的结算账号在 Google Cloud 服务(包括但不限于 Gemini API)上的累计总支出。
| 使用层 | 资格赛 | 结算层级上限 |
|---|---|---|
| 免费 | 活跃项目或免费试用 | 不适用 |
| 第 1 层级 | 设置并关联有效的结算账号 | $250 |
| 第 2 层级 | 已支付 100 美元 + 自首次成功付款时起已满 3 天 | $2,000 |
| 第 3 层级 | 已支付 1,000 美元 + 自首次成功付款时起已满 30 天 | 20,000 - 100,000+ 美元 |
虽然满足所述资格条件通常足以获得批准,但在极少数情况下,升级请求可能会因审核过程中发现的其他因素而被拒绝。
此系统有助于维护 Gemini API 平台的安全性和完整性,让所有用户都能安心使用。
Gemini API 速率限制
速率限制取决于多种因素(例如您的用量层级),您可以在 Google AI Studio 中查看。随着您的层级和账号状态随时间发生变化,您的速率限制也会自动更新。
指定的速率限制无法保证,实际容量可能会有所不同。
优先级推理速率限制
优先级消耗有自己的速率限制,即使消耗会计入总体交互式流量速率限制。默认速率限制为:每个模型和层级的标准速率限制的 0.3 倍
Batch API 速率限制
Batch API 请求受其自身的速率限制约束,与非批量 API 调用分开。
- 并发批量请求数:100
- 输入文件大小上限:2GB
- 文件存储空间上限:20GB
- 每个模型已加入队列的 token 数:已加入队列的批量 token 数表列出了给定模型的所有活跃批量作业中可加入队列进行批量处理的最大 token 数。
第 1 层级
| 模型 | 批量加入队列的 token 数 | |||
|---|---|---|---|---|
| 文本输出模型 | ||||
| Gemini 4 Argon | 5000000 | |||
| Gemini 3 Pro 预览版 | 5000000 | |||
| Gemini 3.5 Flash-Lite | 1000 万 | |||
| Gemini 3.8 Flash | 3,000,000 | |||
| Gemini 3.1 Flash Lite | 1000 万 | |||
| Gemini 3.1 Flash Lite 预览版 | 1000 万 | |||
| Gemini 3.6 Flash | 3,000,000 | |||
| Gemini 2.5 Pro | 5000000 | |||
| Gemini 2.5 Pro TTS | 25000 | |||
| Gemini 2.5 Flash | 3,000,000 | |||
| Gemini 2.5 Flash 预览版 | 3,000,000 | |||
| Gemini 2.5 Flash Image 预览版 | 3,000,000 | |||
| Gemini 2.5 Flash TTS | 100000 | |||
| Gemini 2.5 Flash-Lite | 1000 万 | |||
| Gemini 2.5 Flash Lite 预览版 | 1000 万 | |||
| Gemini 2.0 Flash | 1000 万 | |||
| Gemini 2.0 Flash 图片 | 3,000,000 | |||
| Gemini 2.0 Flash Lite | 1000 万 | |||
| 多模态生成模型 | ||||
| Gemini 3.1 Flash Image 预览版 🍌 | 100 万 | |||
| Gemini 3.1 Flash Lite Image 🍌 | 200 万 | |||
| Gemini 3 Pro Image 预览版 🍌 | 200 万 | |||
| 嵌入模型 | ||||
| Gemini Embedding | 50 万 | |||
第 2 层级
| 模型 | 批量加入队列的 token 数 | |||
|---|---|---|---|---|
| 文本输出模型 | ||||
| Gemini 4 Argon | 500,000,000 | |||
| Gemini 3 Pro 预览版 | 500,000,000 | |||
| Gemini 3.5 Flash-Lite | 500,000,000 | |||
| Gemini 3.1 Flash Lite | 500,000,000 | |||
| Gemini 3.1 Flash Lite 预览版 | 500,000,000 | |||
| Gemini 3.8 Flash | 400,000,000 | |||
| Gemini 3.6 Flash | 400,000,000 | |||
| Gemini 2.5 Pro | 500,000,000 | |||
| Gemini 2.5 Pro TTS | 100000 | |||
| Gemini 2.5 Flash | 400,000,000 | |||
| Gemini 2.5 Flash 预览版 | 400,000,000 | |||
| Gemini 2.5 Flash Image 预览版 | 400,000,000 | |||
| Gemini 2.5 Flash TTS | 100000 | |||
| Gemini 2.5 Flash-Lite | 500,000,000 | |||
| Gemini 2.5 Flash Lite 预览版 | 500,000,000 | |||
| Gemini 2.0 Flash | 10 亿 | |||
| Gemini 2.0 Flash 图片 | 400,000,000 | |||
| Gemini 2.0 Flash Lite | 10 亿 | |||
| 多模态生成模型 | ||||
| Gemini 3.1 Flash Image 预览版 🍌 | 250,000,000 | |||
| Gemini 3.1 Flash Lite Image 🍌 | 270,000,000 | |||
| Gemini 3 Pro Image 预览版 🍌 | 270,000,000 | |||
| 嵌入模型 | ||||
| Gemini Embedding | 5000000 | |||
第 3 级
| 模型 | 批量加入队列的 token 数 | |||
|---|---|---|---|---|
| 文本输出模型 | ||||
| Gemini 4 Argon | 10 亿 | |||
| Gemini 3 Pro 预览版 | 10 亿 | |||
| Gemini 3.5 Flash-Lite | 10 亿 | |||
| Gemini 3.1 Flash Lite | 10 亿 | |||
| Gemini 3.1 Flash Lite 预览版 | 10 亿 | |||
| Gemini 3.8 Flash | 10 亿 | |||
| Gemini 3.6 Flash | 10 亿 | |||
| Gemini 2.5 Pro | 10 亿 | |||
| Gemini 2.5 Pro TTS | 100 万 | |||
| Gemini 2.5 Flash | 10 亿 | |||
| Gemini 2.5 Flash 预览版 | 10 亿 | |||
| Gemini 2.5 Flash Image 预览版 | 10 亿 | |||
| Gemini 2.5 Flash TTS | 4,000,000 | |||
| Gemini 2.5 Flash-Lite | 10 亿 | |||
| Gemini 2.5 Flash Lite 预览版 | 10 亿 | |||
| Gemini 2.0 Flash | 5,000,000,000 | |||
| Gemini 2.0 Flash 图片 | 10 亿 | |||
| Gemini 2.0 Flash Lite | 5,000,000,000 | |||
| 多模态生成模型 | ||||
| Gemini 3.1 Flash Image 预览版 🍌 | 750,000,000 | |||
| Gemini 3.1 Flash Lite Image 🍌 | 10 亿 | |||
| Gemini 3 Pro Image 预览版 🍌 | 10 亿 | |||
| 嵌入模型 | ||||
| Gemini Embedding | 1000 万 | |||
如何升级到更高层级
如需从免费层级过渡到付费层级,您必须先在 AI Studio 中设置结算信息。
当您的项目满足指定条件后,系统会自动将其升级到下一层级。从免费层级升级到第 1 层级通常会立即生效,后续层级升级将在 10 分钟内生效。前往 AI Studio 中的“项目”页面,查看您的层级。
申请提高速率限制
每个模型变体都有一个关联的速率限制(每分钟请求数,RPM)。 如需详细了解这些速率限制,请参阅 AI Studio 速率限制页面。
我们不保证一定会提高您的速率限制,但会尽力审核您的请求。