頻率限制會控管您在特定時間範圍內可向 Gemini API 發出的要求數量。這些限制有助於確保公平使用、防範濫用行為，並維持所有使用者的系統效能。
速率限制的運作方式
速率限制通常從三個面向衡量：
- 每分鐘要求數 (RPM)
- 每分鐘詞元數 (輸入) (TPM)
- 每日要求數 (RPD)
系統會根據各項限制評估您的用量，如果超出任何限制，就會觸發頻率限制錯誤。舉例來說，如果 RPM 上限為 20，即使您未超過 TPM 或其他限制，在一分鐘內提出 21 項要求仍會導致錯誤。
頻率限制是針對每個專案套用，而非每個 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 級 | 首次付款成功後，3 天內支付 $100 美元 | $2,000 美元 |
| 第 3 級 | 首次成功付款後 30 天內，支付 $1,000 美元以上 | $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 嵌入 | 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 嵌入 | 10,000,000 | |||
如何升級至下一個級別
如要從免費方案轉換至付費方案，請先在 AI Studio 設定帳單資訊。
專案符合指定條件後，系統就會自動升級至下一個級別。從免費方案升級至第 1 級通常會立即生效，後續升級則會在 10 分鐘內生效。前往 AI Studio 的「專案」頁面，即可查看層級。
要求提高頻率限制
每個模型變體都有相關聯的頻率限制 (每分鐘要求數，RPM)。如要進一步瞭解這些頻率限制，請參閱「AI Studio 頻率限制」頁面。
我們不保證一定會提高頻率限制，但會盡力審查您的要求。