錯誤長什麼樣
Gemini CLI 常見問題引用的提示是 "API error: 429 - Resource exhausted"。有時也會直接顯示 API 的完整回應。在 GitHub 上 Google 的 gemini-cli 儲存庫中，北京時間 5 月 7 日 18:15 提交的 issue 26633 裡，使用者 merolen 貼出了以個人 Google 帳號登入的 Gemini CLI 0.41.2 回傳的內容：{"error": {"code": 429, "message": "No capacity available for model on the server", "status": "RESOURCE_EXHAUSTED", "details": [{"reason": "MODEL_CAPACITY_EXHAUSTED"}]}}。這個 issue 已經關閉。
Google 文件怎麼解釋
Gemini CLI 常見問題表示，這個錯誤 "indicates that you have exceeded your API request limit"，並說 "the Gemini API has rate limits to prevent abuse and ensure fair usage."Gemini CLI 的額度頁面也寫到，請求依每位使用者每分鐘限制，並且 "are subject to the availability of the service in times of high demand."
Gemini API 的速率限制頁面說明了上限如何計算。上限通常以每分鐘請求數、每分鐘輸入 token 數和每天請求數來衡量，超過其中任何一項都會觸發速率限制錯誤。上限依專案計算，而非依 API 金鑰；每天請求數的額度在太平洋時間午夜重置；實驗版和預覽版模型的上限更嚴格。同一頁面也介紹了依支出計算的速率限制，以滾動 10 分鐘為視窗，Tier 1 為 10 美元、Tier 2 為 50 美元、Tier 3 為 200 美元，碰到時會回傳 429 RESOURCE_EXHAUSTED 錯誤。Google 也表示 "specified rate limits are not guaranteed and actual capacity may vary."
Vertex AI 方面，Google Cloud 的錯誤代碼 429 頁面（現在歸在文件的 Gemini Enterprise Agent Platform 欄目下）表示，"the number of your requests exceeds the capacity allocated to process requests" 時會回傳這個錯誤；隨用隨付時，提示是 "Resource exhausted, please try again later."
免費額度有多少
依北京時間 10 月 20 日 22:31 核對的 Gemini CLI 額度頁面，以 Google 帳號透過個人版 Gemini Code Assist 登入，每位使用者每天最多 1,000 次模型請求，請求由 Gemini CLI 決定分配到 Gemini 系列的各個模型。未付費的 Gemini API 金鑰每位使用者每天最多 250 次模型請求，而且只能使用 Flash 模型。Vertex AI 的 Express Mode 在需要啟用計費之前可使用 90 天，額度因帳號而異。同一頁面列出，Google AI Pro 和 Gemini Code Assist Standard 每天 1,500 次，Google AI Ultra、Gemini Code Assist Enterprise 和 Workspace AI Ultra 每天 2,000 次。至於 Gemini API 本身，Google 表示目前的上限顯示在 Google AI Studio，會隨專案等級和帳號狀態的變化自動更新。
可以嘗試的做法
Google 文件提供的第一步是稍等再重試。Gemini API 疑難排解指南建議遇到 429 RESOURCE_EXHAUSTED 時使用指數退避，第一次重試前先等一下，之後逐步拉長間隔；速率限制頁面也表示，碰到依支出計算的上限時，過一小段時間再重試。Gemini CLI 常見問題也建議，如果短時間內送出很多請求，可以把提示合併成一批，或在請求之間留出間隔。
第二步是確認自己的狀況。Gemini CLI 常見問題建議到 Google AI Studio 或 Google Cloud 專案的主控台查看用量；在 Gemini CLI 裡，/stats model 指令會顯示目前工作階段的 token 用量，以及你的額度對應的上限資訊。Gemini API 速率限制頁面表示，目前生效的上限可以在 AI Studio 查看。
Gemini CLI 也會自行換模型。模型路由文件表示，所選模型因額度或伺服器錯誤等原因失敗時，CLI 會啟動備援流程，預設會先詢問，再於當前這一輪或本次工作階段剩下的時間改用備援模型。核心文件補充，如果預設的 "pro" 模型被限速，CLI 會在本次工作階段切換到 "flash" 模型。
換一種登入方式也是文件寫到的做法。/auth 指令會開啟變更驗證方式的對話框。額度頁面表示，如果碰到每天的請求上限，或升級之後 Gemini Pro 額度仍然用完，改用 Gemini API 金鑰或 Vertex AI 隨用隨付是 "the recommended path for uninterrupted access"。Google 提醒，這種依次計費的方式在小型呼叫很多時可能更貴，但也說這是 "the only way to ensure your workflow isn't interrupted by reaching a limit on your quota."
最後是把上限本身提高。個人可以升級到 Google AI Pro 或 AI Ultra，組織可以使用 Workspace AI Ultra，或 Gemini Code Assist 的 Standard、Enterprise 訂閱；額度頁面表示，其他方案，包括 Google AI Plus、Workspace AI Standard 和 Plus、AI Expanded，都不支援。常見問題表示，Google AI Pro 和 Ultra 的較高上限由 Gemini CLI 和 Gemini Code Assist IDE 擴充功能裡的 agent 模式共用。常見問題和速率限制頁面都表示，如果經常碰到上限，可以向 Google 申請提高。在 Vertex AI 隨用隨付下，Google Cloud 的 429 頁面列出的做法有：盡量使用全域端點而非區域端點、以截斷指數退避重試、模型使用配額時提交配額提升申請、讓流量更平穩並避免大幅突增，以及訂閱 Provisioned Throughput。頁面也表示，專案用量突然大增時可能因加速限制（acceleration limits）出現 429，建議逐步增加流量。