Gemini CLI

透過 Aiduct 使用 Gemini CLI。

Gemini CLI 與 @google/genai SDK 會把 Gemini generateContent 請求傳送到您設定的 base URL。Aiduct 在 /v1beta 上回應，使用與其他地方相同的 API 金鑰。

GEMINI CLI 環境變數

export GOOGLE_GEMINI_BASE_URL=https://api.aiduct.ai
export GEMINI_API_KEY=sk-aiduct-...

gemini --model gemini-3.7-flash

環境變數

GOOGLE_GEMINI_BASE_URL

協議

generateContent

端點

/v1beta

基礎 URL 是閘道根路徑

Gemini SDK 會自行加上 /v1beta 路徑，因此請設定不含版本路徑的根網址。

Gemini 模型為原生提供；其他模型會與 generateContent 雙向轉換，完整保留函式呼叫與思考。

常見問題

GOOGLE_GEMINI_BASE_URL 需要包含 /v1beta 嗎？+

不需要。請使用 https://api.aiduct.ai；Gemini SDK 會自行加上 /v1beta。

Gemini CLI 如何傳送 Aiduct 金鑰？+

透過 x-goog-api-key 標頭傳送，Aiduct 會像 Bearer 權杖一樣接受它。

Gemini 的 countTokens 可以用嗎？+

可以。原生提供的模型由其上游計數；其他情況為估算值，並以 x-aiduct-token-count: estimated 標頭標示。