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