連接 Gemini CLI

透過 API 金鑰將 Gemini CLI 路由至 AnyInt 的 Gemini 相容閘道。

Gemini CLI 在使用 API 金鑰驗證時，支援自訂的 Gemini API 來源。AnyInt 在 /gemini 閘道根目錄下公開 Gemini 開發人員 API。

開始之前

  1. 從官方 Gemini CLI 儲存庫安裝或更新 Gemini CLI。
  2. 建立 AnyInt API 金鑰。
  3. 從模型目錄中選擇一個 Gemini 相容的模型 ID。

設定閘道

Gemini CLI 會讀取 GEMINI_API_KEY 以進行 API 金鑰驗證，並讀取下方的 base-URL 變數以進行 API 來源設定。

bash
export ANYINT_API_KEY="your_api_key"
export GEMINI_API_KEY="$ANYINT_API_KEY"
export GOOGLE_GEMINI_\
BASE_URL="https://api.anyint.ai/gemini"
export GEMINI_MODEL="YOUR_MODEL_ID"

啟動 CLI 並在提示時選擇「使用 Gemini API 金鑰」：

bash
gemini

驗證與疑難排解

  • 401 回應表示未提供 AnyInt 金鑰或該金鑰無效。
  • 模型錯誤表示 GEMINI_MODEL 並未命名一個金鑰可用的 Gemini 相容模型。
  • 在隔離 API 金鑰設定問題時，請移除衝突的 Google Cloud 驗證變數。
  • 請勿將包含金鑰的 .env 檔案納入原始碼控制。Gemini CLI 也支援使用者層級的 .gemini/.env 檔案，以便進行持續的本機設定。

請參閱 Gemini CLI 官方的設定與驗證文件，以了解目前的變數行為。