Gemini CLI

Gemini CLI 是 Google 推出的開源終端機 agent。設定兩個環境變數把它指向 Synthorai，它就會用你的 Synthorai 金鑰呼叫閘道的 Gemini 原生端點。

開始之前

在控制台的 API 金鑰頁面建立一把金鑰，並立即複製：它只會顯示一次。

第 1 步 — 設定環境變數

export GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
export GEMINI_API_KEY="sk-..."
gemini -m gemini-3-pro

Gemini CLI 詢問驗證方式時，請選擇 Use Gemini API key。金鑰會放在 x-goog-api-key 標頭中送出，閘道在 Gemini 原生端點上接受這個標頭：/v1beta/models/{model}:generateContent 與 :streamGenerateContent。

第 2 步 — 選擇模型

用 -m 指定一個你的金鑰可以呼叫的 Gemini 模型，可用的模型請見模型頁面。

這條路徑只提供 generateContent 與 streamGenerateContent。其他方法（例如 countTokens、embedContent）會回傳 404，且不會計費。

把設定寫進檔案

如果不想在每個 shell 都 export 一次，可以把這兩個變數寫進 ~/.gemini/.env：

# ~/.gemini/.env
GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
GEMINI_API_KEY="sk-..."

疑難排解

401 金鑰錯誤，或執行 gemini 的那個 shell 沒有設定它。

某個模型回傳 404 這個模型沒有對你的金鑰開放，請改用金鑰可以呼叫的模型。

URL 中出現 /v1/v1beta 把 GOOGLE_GEMINI_BASE_URL 中的 /v1 拿掉。

想比較各 Gemini 模型的價格，請見模型價格比較。