让 Gemini CLI 跑在 OAIRoute 上
Gemini CLI 走的是 Gemini 原生接口,不是 OpenAI 兼容结构。OAIRoute 两种都提供,所以一个环境变量就能把它接到网关上。
配置
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/v1Then 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
创建 Key
在 api.oairoute.com 注册,到令牌页创建一个 Key。
- 2
设置 base URL
把 GOOGLE_GEMINI_BASE_URL 和 GEMINI_API_KEY 一起导出。注意 CLI 读的是 GEMINI_API_KEY,不是 GOOGLE_API_KEY。
- 3
验证
运行 `gemini "列出当前目录下所有 Markdown 文件"`,看能否正常回答。
值得用的模型
| 模型 ID | 名称 | 适合 | 美元 / 百万 token(输入 / 输出) |
|---|---|---|---|
gemini-4-argon | Gemini 4 Argon | 1M 上下文,这里最强的 Gemini。 | $0.30 / $1.50 |
gemini-3-pro-image | Gemini 3 Pro Image | 图像生成与编辑,65K 上下文。 | $0.30 / $1.80 |
claude-sonnet-5-5 | Claude 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 字段。