頻率限制會控管您在特定時間範圍內可向 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 級 | 支付 $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
- 每個模型排入佇列的權杖數：「批次排入佇列的權杖」表格會列出特定模型所有有效批次工作可排入佇列的權杖數上限，以供批次處理。
級別 1
| 模型 | 批次排隊權杖 | |||
|---|---|---|---|---|
| 文字輸出模型 | ||||
| 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 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 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 的「專案」頁面，即可查看層級。
要求提高速率限制
每個模型變體都有相關聯的頻率限制 (每分鐘要求數，RPM)。如要瞭解這些頻率限制的詳細資訊，請參閱「AI Studio 頻率限制」頁面。
我們無法保證會提高速率限制，但會盡力審查您的要求。