让 Gemini CLI 跑在 OAIRoute 上

Gemini CLI 走的是 Gemini 原生接口,不是 OpenAI 兼容结构。OAIRoute 两种都提供,所以一个环境变量就能把它接到网关上。

Google

配置

~/.gemini/.env
GEMINI_API_KEY=YOUR_OAIROUTE_KEY
GOOGLE_GEMINI_BASE_URL=https://api.oairoute.com

# Or use it in OpenAI-compatible mode:
OPENAI_API_KEY=YOUR_OAIROUTE_KEY
OPENAI_BASE_URL=https://api.oairoute.com/v1
Then run gemini from your terminal.

完整分步指南

为什么要走 OAIRoute

Gemini 4 只要官价零头

Gemini 4 Argon 在这里是每百万输入 $0.30、输出 $1.50,Google 官价是 $2.00 / $10.00。

原生 Gemini 结构,不是中间层翻译

请求打到 /v1beta/models/...:generateContent,返回也是 Gemini 格式,所以 CLI 能正常解析。

需要时切 OpenAI 兼容模式

同一个 Key 也能走 /v1/chat/completions,想拿同一个提示词横向比对各厂商时很方便。

接入步骤

  1. 1

    创建 Key

    在 api.oairoute.com 注册,到令牌页创建一个 Key。

  2. 2

    设置 base URL

    把 GOOGLE_GEMINI_BASE_URL 和 GEMINI_API_KEY 一起导出。注意 CLI 读的是 GEMINI_API_KEY,不是 GOOGLE_API_KEY。

  3. 3

    验证

    运行 `gemini "列出当前目录下所有 Markdown 文件"`,看能否正常回答。

值得用的模型

模型 ID名称适合美元 / 百万 token(输入 / 输出)
gemini-4-argonGemini 4 Argon1M 上下文,这里最强的 Gemini。$0.30 / $1.50
gemini-3-pro-imageGemini 3 Pro Image图像生成与编辑,65K 上下文。$0.30 / $1.80
claude-sonnet-5-5Claude Sonnet 5.5同一个 Key,用来换视角很好使。$0.18 / $0.90

价格按模型目录公布的口径,单位为每百万 token 的输入 / 输出。

常见问题

为什么提示 API key not valid?

Gemini CLI 读的是 GEMINI_API_KEY。如果你设的是 GOOGLE_API_KEY,它根本读不到。

部分内置工具用不了?

依赖 Google 侧服务端能力的功能(比如内置搜索工具)不会被代理。核心对话和文件工具都正常。

请求结构真的是 Gemini 原生吗?

是。参数是驼峰式(如 maxOutputTokens),角色只有 user 和 model,没有 OpenAI 的 tool_calls 字段。

其他工具