頻率限制會控管您在特定時間範圍內可向 Gemini API 發出的要求數量。這些限制有助於維持公平使用原則、防範濫用行為，以及確保所有使用者的系統效能。
速率限制的運作方式
頻率限制通常會從三個面向進行測量：
- 每分鐘要求數 (RPM)
- 每分鐘權杖數 (輸入) (TPM)
- 每日要求數 (RPD)
系統會根據各項限制評估您的用量，如果超過任何限制，就會觸發速率限制錯誤。舉例來說，如果 RPM 上限為 20，即使您未超過 TPM 或其他限制，在一分鐘內提出 21 個要求仍會導致錯誤。
頻率限制適用於專案，而非 API 金鑰。每日要求數 (RPD)，配額會在太平洋時間午夜重設。
限制會因使用的模型而異，部分限制僅適用於特定模型。舉例來說，每分鐘圖像數 (IPM) 只會針對可生成圖像的模型 (Imagen 3) 計算，但概念上與 TPM 相似。其他模型可能設有每日符記限制 (TPD)。
實驗和預覽模型的速率限制較嚴格。
用量層級
頻率限制與專案的使用層級相關。隨著 API 用量和支出增加，您可以選擇升級至較高的層級，享有更高的頻率限制。
第 2 級和第 3 級的資格條件，是根據連結至專案的帳單帳戶，在 Google Cloud 服務 (包括但不限於 Gemini API) 的累計總支出而定。
| 級別 | 資格條件 |
|---|---|
| 免費 | 適用國家/地區的使用者 |
| 級別 1 | 已連結至專案的已付費帳單帳戶 |
| 級別 2 | 總支出：超過 $250 美元，且成功付款至少 30 天 |
| 階層 3 | 總支出：超過 $1,000 美元，且成功付款至少 30 天 |
要求升級時，系統會執行額外檢查，一般而言，只要符合上述資格條件，升級要求通常就會獲得核准。但少數情況下，我們可能會根據審查過程中發現的其他因素，拒絕升級要求。
這套系統有助於維護所有使用者的 Gemini API 平台安全和完整性。
Gemini API 頻率限制
速率限制取決於多種因素 (例如配額層級)，您可以在 Google AI Studio 中查看。隨著層級和帳戶狀態改變，費率限制會自動更新。
我們無法保證一定會達到指定的速率限制，實際容量可能有所不同。
批次 API 頻率限制
Batch API 要求有自己的速率限制，與非批次 API 呼叫不同。
- 並行批次要求：100 個
- 輸入檔案大小上限：2 GB
- 檔案儲存空間上限：20 GB
- 每個模型排入佇列的權杖數：「批次排入佇列的權杖數」表格會列出指定模型所有使用中批次作業可排入佇列的權杖數上限。
級別 1
| 型號 | 批次加入佇列的權杖 | |||
|---|---|---|---|---|
| 文字輸出模型 | ||||
| Gemini 3 Pro 預先發布版 | 50,000,000 | |||
| Gemini 2.5 Pro | 5,000,000 | |||
| Gemini 2.5 Flash | 3,000,000 | |||
| Gemini 2.5 Flash 預先發布版 | 3,000,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-Lite | 10,000,000 | |||
| 多模態生成模型 | ||||
| Gemini 3 Pro Image 預先發布版 🍌 | 2,000,000 | |||
級別 2
| 型號 | 批次加入佇列的權杖 | |||
|---|---|---|---|---|
| 文字輸出模型 | ||||
| Gemini 3 Pro 預先發布版 | 500,000,000 | |||
| Gemini 2.5 Pro | 500,000,000 | |||
| Gemini 2.5 Flash | 400,000,000 | |||
| Gemini 2.5 Flash 預先發布版 | 400,000,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-Lite | 1,000,000,000 | |||
| 多模態生成模型 | ||||
| Gemini 3 Pro Image 預先發布版 🍌 | 270,000,000 | |||
階層 3
| 型號 | 批次加入佇列的權杖 | |||
|---|---|---|---|---|
| 文字輸出模型 | ||||
| Gemini 3 Pro 預先發布版 | 1,000,000,000 | |||
| Gemini 2.5 Pro | 1,000,000,000 | |||
| Gemini 2.5 Flash | 1,000,000,000 | |||
| Gemini 2.5 Flash 預先發布版 | 1,000,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-Lite | 5,000,000,000 | |||
| 多模態生成模型 | ||||
| Gemini 3 Pro Image 預先發布版 🍌 | 1,000,000,000 | |||
如何升級至下一個級別
Gemini API 會使用 Cloud Billing 處理所有帳單服務。如要從免費方案轉換為付費方案，請先為 Google Cloud 專案啟用 Cloud Billing。
專案符合指定條件後，即可升級至下一個級別。如要申請升級，請按照下列步驟操作：
- 前往 AI Studio 的「API 金鑰」頁面。
- 找出要升級的專案，然後按一下「升級」。只有符合下一層級資格的專案，才會顯示「升級」選項。
通過快速驗證後，專案就會升級至下一個層級。
要求提高頻率限制
每個模型變體都有相關聯的速率限制 (每分鐘要求數，RPM)。 如要進一步瞭解這些頻率限制，請參閱「Gemini 模型」一文。
我們無法保證會提高速率限制，但會盡力審查您的要求。