接入 Gemini CL

将 Gemini CLI 接入 PilotAIHub，通过自定义端点统一调用模型。

简介

Gemini CL（Gemini CLI）是 Google 的终端 Agent。除了官方 Gemini 端点，它也支持通过环境变量覆盖为 OpenAI 兼容端点。将其指向 PilotAIHub 网关后，可在 Gemini CLI 中调用 PilotAIHub 托管的模型，并保留 Key 治理与成本归因。

前置条件

已注册 PilotAIHub 账号并创建虚拟 Key；已安装 Node.js 18+。

安装 Gemini CL

全局安装

npm install -g @google/gemini-cli

配置 base_url

将 Gemini CL 的 OpenAI 兼容接口地址指向 PilotAIHub 网关：

配置位置

通过环境变量配置（见下方）。Gemini CL 支持将 API 端点覆盖为 OpenAI 兼容地址，写入 shell 配置文件持久化。

环境变量 OPENAI_BASE_URL

OPENAI_BASE_URL=https://api.pilotaihub.com

配置 API Key

在 PilotAIHub 控制台创建虚拟 API Key（以 pk- 开头），填入 Gemini CL 的 API Key / Secret 字段：

环境变量 OPENAI_API_KEY

OPENAI_API_KEY=sk-p-xxxxxxxxxxxxxxxx

Key 安全

API Key 是账户凭证，请勿提交到代码仓库或公开分享。Gemini CL 的配置仅保存在本地，不会上传 PilotAIHub 之外。

选择模型

在 Gemini CL 的模型选择处填写 PilotAIHub 支持的 model_code，例如 gpt-4o。完整模型列表见控制台「模型」页或模型市场。

验证调用

配置完成后，用以下请求验证连通性。成功时应返回模型回复：

curl 验证

curl https://api.pilotaihub.com/chat/completions \
  -H "Authorization: Bearer sk-p-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己"}
    ]
  }'

期望响应

HTTP 200 + 一条 assistant 角色的回复。若返回 401 请检查 Key 是否正确；若返回 429 请降低请求频率或联系管理员提升限额。

进阶用法

切换 model 即可在 PilotAIHub 上使用不同模型，无需改 Key。
如需使用 Gemini 原生端点与 PilotAIHub 混用，建议用不同 profile/环境隔离。

常见问题

端点覆盖

Gemini CL 默认连 Google 官方端点。接入 PilotAIHub 需确保 OPENAI_BASE_URL 已正确 export 并被 Gemini CL 读取；若仍连官方，请检查该版本是否支持 OpenAI 兼容覆盖。