Gemini CLI
Gemini CLI 整合
把 UnoRouter 用在 Gemini CLI 以及任何 Google GenAI 相容用戶端上。
概覽
Gemini CLI 是 Google 的開源編碼代理程式,可在終端機中編輯檔案並執行指令。把 UnoRouter 設為它的基礎網址,就能用一把 OpenAI 相容金鑰使用全部模型,而不必依賴僅限 Google 的帳號。
快速設定
把這些貼進用戶端。已登入時會自動填入你的金鑰。
text
基礎 URL: https://api.unorouter.com
API 金鑰: YOUR_API_KEY相容性
Chat Completions串流工具呼叫影像輸入
逐步設定
- 1安裝 Gemini CLI
使用 npm 全域安裝 Gemini CLI。在 Windows 上,請在 WSL 內執行。
bashnpm install -g @google/gemini-cli - 2設定環境變數
建立 `~/.gemini/.env` 並寫入 UnoRouter 的 API 金鑰。把 `GOOGLE_GEMINI_BASE_URL` 設為不帶路徑的基礎網址。Gemini SDK 會自行補上路徑,所以不要加 `/v1`。
bash# ~/.gemini/.env GEMINI_API_KEY=YOUR_API_KEY GOOGLE_GEMINI_BASE_URL=https://api.unorouter.com - 3啟動 Gemini
在專案目錄中執行 `gemini`。
bashgemini
powershell
$env:GEMINI_API_KEY="YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL="https://api.unorouter.com"
gemini推薦模型
在這裡可用的免費模型。把任意模型 id 貼進用戶端即可。
glm-5.3-search:freeglm-5.3-think-search:freeglm-5.3-thinking:freeglm-5.3:freeqwen-3.8-27b:free
注意事項
- 404 表示基礎網址上帶了路徑。`GOOGLE_GEMINI_BASE_URL` 必須是不含 `/v1` 後綴的主機名稱,其餘由 SDK 補上。
- 驗證失敗時,請確認 `~/.gemini/.env` 裡的 `GEMINI_API_KEY` 是你的 UnoRouter 金鑰,並確認 shell 會讀取該檔案。