用量如何計算
Google 以模型請求數而非提示數來計算 Gemini CLI 的用量。Gemini Code Assist 額度頁面表示,在 Gemini CLI 或 Code Assist 的 agent 模式裡,一則提示可能產生多次模型請求,兩者共用同一份額度。請求依每位使用者每天和每分鐘限制,而且 "are subject to the availability of the service in times of high demand."。每天的上限會把 Gemini CLI 和 agent 模式用到的所有模型版本與系列(例如 Pro 和 Flash)合併計算,一旦用滿,在額度重置之前,這些入口對任何模型都無法送出請求。
各種登入方式的上限
以個人 Google 帳號登入免費的個人版 Gemini Code Assist,每位使用者每天最多 1,000 次模型請求,由 Gemini CLI 決定分配到 Gemini 系列的各個模型。Google AI Pro 提高到每天 1,500 次,Google AI Ultra 是 2,000 次。Gemini CLI 常見問題表示,Pro 和 Ultra 的較高上限針對的是 Gemini 2.5,包括 Gemini 2.5 Pro 和 Flash,由 Gemini CLI 和 Gemini Code Assist IDE 擴充功能裡的 agent 模式共用。額度頁面表示,其他個人方案,包括 Google AI Plus,都不支援。
組織帳號也是相同的結構。Gemini Code Assist Standard 授權每位使用者每天 1,500 次,Gemini Code Assist Enterprise 和 Workspace AI Ultra 是 2,000 次。Workspace AI Standard、Workspace AI Plus 和 AI Expanded 不支援;Google 也表示,Gemini for Workspace 方案只適用於 Gemini 網頁應用程式等網頁產品,不適用於支撐 Gemini CLI 的 API 用量。
免費的 Gemini API 金鑰每位使用者每天最多 250 次模型請求,而且只能使用 Flash 模型。付費金鑰的額度依價格等級而定。Gemini API 速率限制頁面補充,API 上限依專案而非依金鑰計算,每天的請求額度在太平洋時間午夜重置,目前的上限可以在 Google AI Studio 查看。
Vertex AI 的方式不同。Express Mode 在需要啟用計費之前可使用 90 天,額度因帳號而異。一般模式下,用量由動態共用配額或預先購買的 Provisioned Throughput 管理,費用取決於模型和 token 用量。
碰到上限時會怎樣
Gemini CLI 會盡量讓你繼續工作。模型路由文件表示,所選模型因額度或伺服器錯誤等原因失敗時,CLI 會啟動備援流程,預設會先詢問,再於當前這一輪或本次工作階段剩下的時間改用備援模型。核心文件補充,如果預設的 "pro" 模型被限速,CLI 會在本次工作階段切換到 "flash" 模型。如果請求仍被拒絕,Gemini CLI 會顯示 429 錯誤,我們關於 Gemini CLI 429 RESOURCE_EXHAUSTED 錯誤的說明文章有詳細介紹。
想知道自己用到哪裡,/stats model 指令會顯示目前工作階段的 token 用量,以及支援模型的整體額度與用量;工作階段結束時,Gemini CLI 也會顯示一份模型用量摘要。
怎麼取得更多額度
Google 提供三條路。第一條是升級方案:個人帳號升級到 Google AI Pro 或 Ultra,組織則使用 Workspace AI Ultra,或 Gemini Code Assist 的 Standard、Enterprise 訂閱。第二條是隨用隨付。額度頁面表示,如果碰到每天的請求上限,或升級之後 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."。登入方式可以用 /auth 指令開啟的對話框變更。
第三條是提高配額。Gemini Code Assist 額度頁面表示,大多數配額可以在 Google Cloud 主控台調整。在 Gemini API 上,Google 表示專案會隨支出增加自動升級用量等級:連結有效的帳單帳戶後是 Tier 1,累計支付 100 美元且距首次成功付款滿 3 天後是 Tier 2,支付 1,000 美元且滿 30 天後是 Tier 3。
