Gemini CLI 接入

Gemini CLI 使用 Gemini v1beta 协议。Base URL 填写 QuotaAPI 根地址，CLI 会自动拼接 /v1beta 路径。

查看 Gemini CLI API 接入概览，了解兼容能力和适用场景。

macOS 和 Linux

export GOOGLE_GEMINI_BASE_URL="https://quotarouter.ai"
export GEMINI_API_KEY="YOUR_QUOTAAPI_KEY"
export GEMINI_MODEL="gemini-2.0-flash"

Windows Command Prompt

set GOOGLE_GEMINI_BASE_URL=https://quotarouter.ai
set GEMINI_API_KEY=YOUR_QUOTAAPI_KEY
set GEMINI_MODEL=gemini-2.0-flash

Windows PowerShell

$env:GOOGLE_GEMINI_BASE_URL="https://quotarouter.ai"
$env:GEMINI_API_KEY="YOUR_QUOTAAPI_KEY"
$env:GEMINI_MODEL="gemini-2.0-flash"

GEMINI_MODEL 只是示例。请以 Key 所属分组当前开放的 Gemini 模型为准。设置后完全退出并重启 Gemini CLI。

验证模型列表

curl "https://quotarouter.ai/v1beta/models?key=YOUR_QUOTAAPI_KEY"

模型列表可用后，再测试 generateContent：

curl "https://quotarouter.ai/v1beta/models/gemini-2.0-flash:generateContent?key=YOUR_QUOTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "Reply with a short Gemini CLI test message." }]
    }],
    "generationConfig": { "maxOutputTokens": 80 }
  }'

常见错误

• API key not valid：确认传入的是 QuotaAPI Key，且 Key 已启用。
• model not found：检查模型名称、Key 绑定分组和控制台模型列表。
• 404：Base URL 应为根地址，不要手工追加 /v1beta。
• 403：Key 绑定的分组不能访问目标 Gemini 模型。
• 修改后仍请求旧地址：重启终端与 Gemini CLI，确认新变量已经加载。