在 Gemini CLI 中接入

Gemini CLI 走 Google 原生協議,本平臺提供同款原生端點。

本文介紹如何把 Gemini CLI 接到本平臺,用同一個令牌呼叫 Claude、GPT、Gemini 等模型。全程只需要三個值:接入地址、令牌、模型名。

開始之前請先在控制台建立一個令牌(sk- 開頭),並確認帳戶裡有餘額。還沒有令牌的話,先看 5 分鐘發出第一個請求

配置

用環境變數把 Gemini CLI 的接入地址指到本平臺,金鑰換成本平臺的令牌。

填哪裡 填什麼
接入地址 https://api.router.ai
API Key sk- 開頭的令牌
模型 gemini-3.1-pro-preview
export GOOGLE_GEMINI_BASE_URL=https://api.router.ai
export GEMINI_API_KEY=sk-你的令牌

gemini -m gemini-3.1-pro-preview

驗證

配置完先別急著跑複雜任務。讓它回答一句「你好」,能正常回話就說明鏈路通了。想單獨確認令牌本身有沒有問題,可以在終端直接調一次介面:

curl https://api.router.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.1-pro-preview","messages":[{"role":"user","content":"你好"}]}'

返回 JSON 裡有 choices 就是正常的。之後在控制台的計費流水裡能看到這筆呼叫。

常見問題

本平臺同時提供 Google 原生格式(/v1beta/models/{模型}:generateContent)和 OpenAI 相容格式,Gemini CLI 用的是前者,所以地址不要加 /v1。模型名要用本平臺目錄裡的名字,例如 gemini-3.1-pro-previewgemini-3.5-flash

報 401

令牌填錯、多了空格,或者複製時漏了開頭的 sk-。重新複製一次完整令牌。

報 404

九成是地址結尾對不上:OpenAI 相容格式要 /v1 結尾,Anthropic 和 Gemini 原生格式則不要/v1。對照上面表格再核一次。

報 402 / 提示餘額不足

帳戶餘額不夠。見 充值方式與到帳時間

模型不存在

模型名必須和平臺目錄裡完全一致(大小寫、連字元都算)。在模型廣場頁可以直接複製準確的名字。

相關文章

部落格