搜尋文件...

開始輸入以搜尋文件

Gemini
Gemini CLI

Gemini CLI 整合

搭配 Gemini CLI 或任何 Google GenAI 相容用戶端使用 UnoRouter。與 Claude、GPT 並行存取 Gemini 模型。

概覽

Gemini CLI 是 Google 的開源編碼代理,可直接在終端機中編輯檔案並執行指令。將 UnoRouter 設為它的基礎 URL,你便能用一個 OpenAI 相容金鑰存取 Gemini、Claude、GPT 以及其他所有模型,而無需僅限 Google 的帳號。

快速設定

將這些值填入用戶端。登入後會自動填入你的金鑰。

text
基礎 URL: https://api.unorouter.com
API 金鑰: YOUR_API_KEY

登入以自動填入 API 金鑰

相容性

Chat Completions串流工具呼叫影像輸入

逐步設定

  1. 1
    安裝 Gemini CLI

    使用 npm 全域安裝 Gemini CLI。在 Windows 上,請在 WSL 內執行。

    bash
    npm install -g @google/gemini-cli

    登入以自動填入 API 金鑰

  2. 2
    設定環境變數

    建立包含 UnoRouter API 金鑰的 `~/.gemini/.env`,並將 `GOOGLE_GEMINI_BASE_URL` 設定為 UnoRouter 的裸基礎 URL。Gemini SDK 會附加自己的路徑,因此不要加入 `/v1`。

    bash
    # ~/.gemini/.env
    GEMINI_API_KEY=YOUR_API_KEY
    GOOGLE_GEMINI_BASE_URL=https://api.unorouter.com

    登入以自動填入 API 金鑰

  3. 3
    啟動 Gemini

    在專案目錄中執行 `gemini` 以開始工作階段。

powershell
$env:GEMINI_API_KEY="YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL="https://api.unorouter.com"

gemini

登入以自動填入 API 金鑰

推薦模型

在這裡表現良好的免費模型。把任意模型 ID 貼到用戶端即可。

magistral-medium-latestqwen3guard-gen-0.6bmistral-medium-2508allam-2-7bcodestral-latest

注意事項

  • 如果請求回傳 404,表示你在基礎 URL 中加入了路徑。`GOOGLE_GEMINI_BASE_URL` 必須是不帶 `/v1` 後綴的裸主機,其餘部分由 SDK 附加。
  • 如果認證失敗,請確認 `~/.gemini/.env` 中的 `GEMINI_API_KEY` 是你的 UnoRouter 金鑰,且該檔案被你的 shell 工作階段讀取。
產生 API 金鑰模型