Gemini CLI 接入

Gemini CLI 是 Google 官方的命令行 AI 助手。Aivisx Link 提供了 Gemini 原生协议 兼容层，可以直接对接。

前置条件

• 已安装 Node.js 18+
• 一把可用的 API Key

安装 Gemini CLI

npm install -g @google/gemini-cli

验证：

gemini --version

配置接入

Gemini CLI 支持通过环境变量指定自定义 API 端点。

方式一：环境变量（推荐）

macOS / Linux

export GEMINI_API_KEY="sk-你的KEY"
export GOOGLE_GEMINI_BASE_URL="https://aivisx.link"
gemini

永久生效：

echo 'export GEMINI_API_KEY="sk-你的KEY"' >> ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://aivisx.link"' >> ~/.zshrc
source ~/.zshrc

Windows（PowerShell）

$env:GEMINI_API_KEY = "sk-你的KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://aivisx.link"
gemini

永久生效：

[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "sk-你的KEY", "User")
[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://aivisx.link", "User")

方式二：项目配置文件

在项目根目录创建 .gemini/settings.json：

{
  "apiKey": "sk-你的KEY",
  "baseUrl": "https://aivisx.link"
}

Gemini 原生接口说明

Aivisx Link 完整兼容 Gemini 的原生 REST 协议：

方法	路径	说明
GET	/v1beta/models	列出可用模型
GET	/v1beta/models/{model}	获取单个模型信息
POST	/v1beta/models/{model}:{action}	调用模型，如 :generateContent

例如直接调用：

curl https://aivisx.link/v1beta/models/gemini-2.5-pro:generateContent \
  -H "x-goog-api-key: sk-你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"用一句话解释什么是递归"}]}]}'

常见问题

Q：报 API key not valid 确认 GEMINI_API_KEY 填的是 Aivisx Link 的 sk- Key，而不是 Google 官方的 Key。

Q：提示要走 Google 登录 Gemini CLI 默认会尝试 OAuth 登录。确保 GEMINI_API_KEY 已设置，并且重新打开了终端。

Q：模型列表里没有我想要的模型 Gemini 模型由分组决定。查看站点的「模型广场」确认当前分组支持的模型，或咨询客服。

Q：可以只用 Gemini 协议调用其他模型吗？ 不可以。协议要和分组平台匹配，Gemini 原生接口对应 Google 平台的分组。

相关文档

• 模型选择
• Gemini 原生接口
• 疑难杂症