Skip to content

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。