Gemini CLI 接入 211API
兩個環境變數完成接入:Gemini CLI 的請求經 211API 中繼,適合高頻、低延遲的輕量呼叫場景。
準備工作
- 一個 211API 帳號,並在控制台建立好 API Key(
sk-開頭)。 - 本地已安裝 Node.js 18 或更高版本。
第一步 · 安裝 Gemini CLI
bash
npm install -g @google/gemini-cli第二步 · 設定環境變數
把 API Key 與接口位址指向 211API。macOS / Linux(bash / zsh):
bash
# 寫入 ~/.zshrc 或 ~/.bashrc 可長期生效
export GEMINI_API_KEY="sk-你的-211API-Key"
export GOOGLE_GEMINI_BASE_URL="https://www.211api.com/v1"Windows(PowerShell):
powershell
$env:GEMINI_API_KEY = "sk-你的-211API-Key"
$env:GOOGLE_GEMINI_BASE_URL = "https://www.211api.com/v1"
# 長期生效(使用者層級):
# setx GEMINI_API_KEY "sk-你的-211API-Key"提示
可用模型與具體型號名以 211API 控制台「模型列表」為準;如果工具內支援指定模型,按列表中的名稱填寫即可。
第三步 · 啟動並驗證
在專案目錄中啟動 Gemini CLI,提出一個簡單問題確認連線正常:
bash
cd 你的專案目錄
gemini
# 工作階段內輸入:
用一句話介紹這個專案的結構返回正常即完成接入。呼叫記錄、Token 消耗與倍率明細可在 211API 控制台即時查看。
常見問題
仍走官方接口 — 確認 GOOGLE_GEMINI_BASE_URL 已在目前終端機工作階段生效(setx 寫入後需重開終端機),並檢查沒有被其他設定檔覆蓋。
401 驗證失敗 — 確認 GEMINI_API_KEY 使用的是 211API 控制台建立的 Key,而非 Google AI Studio 的 Key。