Skip to content

Gemini CLI 接入自定义 API ​

Gemini CLI 通过环境变量 GOOGLE_GEMINI_BASE_URL 指定接口地址、GEMINI_API_KEY 指定密钥。把前者设为 https://api.niceai.dev、后者设为 NiceAI 密钥即可。

环境变量填写内容
GOOGLE_GEMINI_BASE_URLhttps://api.niceai.dev(不加 /v1beta,SDK 会自动拼接)
GEMINI_API_KEY你的 NiceAI 密钥(Gemini 分组)

已经安装 CC Switch 的话,也可以用 CC Switch 一键导入。

准备工作 ​

  1. 安装 Gemini CLI(参考其官方仓库说明)。
  2. 在 NiceAI 控制台「API 密钥」页面创建密钥,分组选择 Gemini。

配置环境变量 ​

macOS / Linux ​

bash
export GOOGLE_GEMINI_BASE_URL="https://api.niceai.dev"
export GEMINI_API_KEY="你的密钥"
gemini

长期生效:把两行 export 追加到 ~/.zshrc 或 ~/.bashrc。

Windows PowerShell ​

powershell
$env:GOOGLE_GEMINI_BASE_URL = "https://api.niceai.dev"
$env:GEMINI_API_KEY = "你的密钥"
gemini

长期生效:

powershell
[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.niceai.dev", "User")
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的密钥", "User")

没设 Base URL 时请求会发往 Google

如果启动 Gemini CLI 的终端里没有 GOOGLE_GEMINI_BASE_URL,请求会直接发到 Google 官方接口。改完环境变量后记得重新打开终端。

在 Gemini SDK 中使用 ​

直接调用 Gemini 接口时,地址是 https://api.niceai.dev/v1beta。使用 Google 的 google-genai Python SDK 时,把 base_url 设为根地址即可:

python
from google import genai

client = genai.Client(
    api_key="你的密钥",
    http_options={"base_url": "https://api.niceai.dev"},
)
resp = client.models.generate_content(model="<模型名,见模型广场>", contents="你好")
print(resp.text)

常见问题 ​

报 401 或 403? ​

确认密钥分组是 Gemini,且 GEMINI_API_KEY 在当前终端已生效。

404? ​

GOOGLE_GEMINI_BASE_URL 不要加 /v1beta。直接用 curl 请求时才需要带 /v1beta。详见 接口地址要不要加 /v1。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站