頻率限制會規範您在特定時間範圍內，可向 Gemini API 發出的要求數量。這些限制有助於確保公平使用、防範濫用行為，並維持所有使用者的系統效能。
頻率限制的運作方式
頻率限制通常會從三個面向衡量：
- 每分鐘要求數 (RPM)
- 每分鐘詞元數 (輸入) (TPM)
- 每日要求數 (RPD)
系統會根據各項限制評估您的用量，只要超過任何一項限制，就會觸發頻率限制錯誤。舉例來說，如果 RPM 限制為 20，在一分鐘內提出 21 項要求就會發生錯誤，即使未超過 TPM 或其他限制也一樣。
頻率限制是依專案套用，而非依 API 金鑰。每日要求數 (RPD) 配額會在太平洋時間午夜重設。
限制會因使用的特定模型而異，部分限制僅適用於特定模型。舉例來說，每分鐘圖像數 (IPM) 僅適用於可生成圖像的模型 (Nano Banana)，但概念與 TPM 類似。其他模型可能會有每日詞元數量限制 (TPD)。
實驗和預先發布版模型的用量限制較嚴格。
依支出計算的頻率限制
除了每分鐘要求數 (RPM) 和每分鐘權杖數 (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
- 輸入檔案大小上限：2 GB
- 檔案儲存空間上限：20 GB
- 每個模型排入佇列的權杖數：「Batch enqueued tokens」(批次排入佇列的權杖) 表格列出特定模型的所有有效批次工作中，可排入佇列進行批次處理的權杖數量上限。
級別 1
| 模型 | 批次排入佇列的權杖 | |||
|---|---|---|---|---|
| 文字輸出模型 | ||||
| Gemini 4 Argon | 5,000,000 | |||
| Gemini 3.1 Pro 預先發布版 | 5,000,000 | |||
| Gemini 3.5 Flash-Lite | 10,000,000 | |||
| Gemini 3.8 Flash | 3,000,000 | |||
| Gemini 3.1 Flash Lite | 10,000,000 | |||
| Gemini 3.1 Flash Lite 預先發布版 | 10,000,000 | |||
| Gemini 3.6 Flash | 3,000,000 | |||
| Gemini 2.5 Pro | 5,000,000 | |||
| Gemini 2.5 Pro TTS | 25,000 | |||
| 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 | 100,000 | |||
| Gemini 2.5 Flash Lite | 10,000,000 | |||
| Gemini 2.5 Flash Lite 預先發布版 | 10,000,000 | |||
| Gemini 2.0 Flash | 10,000,000 | |||
| Gemini 2.0 Flash Image | 3,000,000 | |||
| Gemini 2.0 Flash Lite | 10,000,000 | |||
| 多模態生成模型 | ||||
| Gemini 3.1 Flash Image 預先發布版 🍌 | 1,000,000 | |||
| Gemini 3.1 Flash Lite Image 🍌 | 2,000,000 | |||
| Gemini 3 Pro Image 預先發布版 🍌 | 2,000,000 | |||
| 嵌入模型 | ||||
| Gemini Embedding | 500,000 | |||
級別 2
| 模型 | 批次排入佇列的權杖 | |||
|---|---|---|---|---|
| 文字輸出模型 | ||||
| Gemini 4 Argon | 500,000,000 | |||
| Gemini 3.1 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 | 100,000 | |||
| 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 | 100,000 | |||
| Gemini 2.5 Flash Lite | 500,000,000 | |||
| Gemini 2.5 Flash Lite 預先發布版 | 500,000,000 | |||
| Gemini 2.0 Flash | 1,000,000,000 | |||
| Gemini 2.0 Flash Image | 400,000,000 | |||
| Gemini 2.0 Flash Lite | 1,000,000,000 | |||
| 多模態生成模型 | ||||
| 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 | 5,000,000 | |||
階層 3
| 模型 | 批次排入佇列的權杖 | |||
|---|---|---|---|---|
| 文字輸出模型 | ||||
| Gemini 4 Argon | 1,000,000,000 | |||
| Gemini 3.1 Pro 預先發布版 | 1,000,000,000 | |||
| Gemini 3.5 Flash-Lite | 1,000,000,000 | |||
| Gemini 3.1 Flash Lite | 1,000,000,000 | |||
| Gemini 3.1 Flash Lite 預先發布版 | 1,000,000,000 | |||
| Gemini 3.8 Flash | 1,000,000,000 | |||
| Gemini 3.6 Flash | 1,000,000,000 | |||
| Gemini 2.5 Pro | 1,000,000,000 | |||
| Gemini 2.5 Pro TTS | 1,000,000 | |||
| Gemini 2.5 Flash | 1,000,000,000 | |||
| Gemini 2.5 Flash 預先發布版 | 1,000,000,000 | |||
| Gemini 2.5 Flash Image 預先發布版 | 1,000,000,000 | |||
| Gemini 2.5 Flash TTS | 4,000,000 | |||
| Gemini 2.5 Flash Lite | 1,000,000,000 | |||
| Gemini 2.5 Flash Lite 預先發布版 | 1,000,000,000 | |||
| Gemini 2.0 Flash | 5,000,000,000 | |||
| Gemini 2.0 Flash Image | 1,000,000,000 | |||
| Gemini 2.0 Flash Lite | 5,000,000,000 | |||
| 多模態生成模型 | ||||
| Gemini 3.1 Flash Image 預先發布版 🍌 | 750,000,000 | |||
| Gemini 3.1 Flash Lite Image 🍌 | 1,000,000,000 | |||
| Gemini 3 Pro Image 預先發布版 🍌 | 1,000,000,000 | |||
| 嵌入模型 | ||||
| Gemini Embedding | 10,000,000 | |||
如何升級至下一個級別
如要從免費方案轉換至付費方案，請先在 AI Studio 設定帳單資訊。
專案符合指定條件後，就會自動升級至下一個級別。從免費方案升級至第 1 級通常會立即生效，後續升級則會在 10 分鐘內生效。前往 AI Studio 的「Projects」(專案) 頁面，查看您的級別。
要求提高頻率限制
每個模型變化版本都有相關聯的頻率限制 (每分鐘要求數，RPM)。如要進一步瞭解這些頻率限制，請參閱「AI Studio 頻率限制」頁面。
我們不保證會提高頻率限制，但會盡力審查您的要求。