在 Gemini CLI 中接入

Gemini CLI 走 Google 原生协议,本平台提供同款原生端点。

本文介绍如何把 Gemini CLI 接到本平台,用同一个令牌调用 Claude、GPT、Gemini 等模型。全程只需要三个值:接入地址、令牌、模型名。

开始之前请先在控制台创建一个令牌(sk- 开头),并确认账户里有余额。还没有令牌的话,先看 5 分钟发出第一个请求

配置

用环境变量把 Gemini CLI 的接入地址指到本平台,密钥换成本平台的令牌。

填哪里 填什么
接入地址 https://api.router.ai
API Key sk- 开头的令牌
模型 gemini-3.1-pro-preview
export GOOGLE_GEMINI_BASE_URL=https://api.router.ai
export GEMINI_API_KEY=sk-你的令牌

gemini -m gemini-3.1-pro-preview

验证

配置完先别急着跑复杂任务。让它回答一句「你好」,能正常回话就说明链路通了。想单独确认令牌本身有没有问题,可以在终端直接调一次接口:

curl https://api.router.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.1-pro-preview","messages":[{"role":"user","content":"你好"}]}'

返回 JSON 里有 choices 就是正常的。之后在控制台的计费流水里能看到这笔调用。

常见问题

本平台同时提供 Google 原生格式(/v1beta/models/{模型}:generateContent)和 OpenAI 兼容格式,Gemini CLI 用的是前者,所以地址不要加 /v1。模型名要用本平台目录里的名字,例如 gemini-3.1-pro-previewgemini-3.5-flash

报 401

令牌填错、多了空格,或者复制时漏了开头的 sk-。重新复制一次完整令牌。

报 404

九成是地址结尾对不上:OpenAI 兼容格式要 /v1 结尾,Anthropic 和 Gemini 原生格式则不要/v1。对照上面表格再核一次。

报 402 / 提示余额不足

账户余额不够。见 充值方式与到账时间

模型不存在

模型名必须和平台目录里完全一致(大小写、连字符都算)。在模型广场页可以直接复制准确的名字。

相关文章

博客