集成

Gemini CLI

用 Lovely Router API 密钥使用 Gemini CLI：用两个环境变量设置 base URL 和密钥，并选择 Gemini 模型。

Gemini CLI 是 Google 推出的开源终端 AI 智能体。它调用 Gemini API，Lovely Router 原生提供该 API，因此用两个环境变量就能把它指向 Lovely Router。开始前，你需要先有一个 API 密钥。

一键配置#

在 API 密钥页面，依次点击 接入客户端 → Gemini CLI。对话框会显示下面的配置，并已填入你的密钥；用 CC Switch 一键导入 会把 Lovely Router 作为供应商添加到 CC Switch 桌面应用中，模型已预先设好。需已安装 CC Switch。

刚创建密钥时，对话框中已经包含该密钥。对于已有的密钥，请把完整密钥粘贴到对话框中：Lovely Router 只保存哈希，无法再次显示密钥。

设置 base URL 和密钥#

设置 base URL 和密钥，并选择一个模型：

Shell

export GOOGLE_GEMINI_BASE_URL=https://lovelyrouter.com
export GEMINI_API_KEY=$LOVELY_API_KEY
gemini -m gemini-3.1-pro

选择模型#

-m 用于选择模型。GET /v1/models 中的任意 Gemini 模型 ID 都可以使用，例如 gemini-3.1-pro 或 gemini-3-flash。模型列表中有全部 ID。

通过 MCP 添加数据工具#

位于 https://lovelyrouter.com/mcp 的 MCP 服务器可以为 Gemini CLI 提供数据工具和浏览器智能体，费用从同一余额中扣除。它使用同一个密钥进行身份验证：

Shell

gemini mcp add --transport http lovely https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

这会把它添加到当前项目的 .gemini/settings.json 中。加上 --scope user 即可在所有项目中使用。运行 gemini mcp list 进行检查。完整的工具列表请参阅 MCP 服务器。

故障排查#

现象	解决方法
`401`，消息为 `Missing API key`	Gemini CLI 没有发送密钥。检查 `GEMINI_API_KEY` 是否已在启动 `gemini` 的 Shell 中 export。
`401`，消息为 `Invalid or revoked API key`	密钥输错、被截断或已吊销。重新粘贴，或创建一个新密钥。
`404`，消息为 `Model '...' is not available`	该模型 ID 不存在。从 `GET /v1/models` 或模型列表中复制 Gemini 模型 ID。
`404`，消息为 `Unknown endpoint /v1/v1beta/...`	`GOOGLE_GEMINI_BASE_URL` 以 `/v1` 结尾，而 Gemini CLI 会自行追加版本路径。请将其设为 `https://lovelyrouter.com`。
`402`	余额已用完，或密钥已达到消费上限。请参阅额度与计费。

其他所有状态码请参阅错误。