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 响应头标明。