Gemini CLI 接入

Gemini CLI 使用 Gemini v1beta 协议。接入 QuotaAPI 时，Base URL 使用 https://quotarouter.ai，API Key 使用控制台创建的 QuotaAPI Key。

环境变量方式

不同 Gemini 客户端读取的变量名可能不同。优先按客户端文档配置 Base URL 和 Key，常见写法如下：

export GEMINI_BASE_URL="https://quotarouter.ai"
export GEMINI_API_KEY="YOUR_QUOTAAPI_KEY"

如果客户端要求完整接口前缀，可以填：

export GEMINI_BASE_URL="https://quotarouter.ai/v1beta"

两种写法取决于客户端会不会自动拼接 /v1beta。如果出现双重 /v1beta/v1beta，请改回 https://quotarouter.ai。

模型列表测试

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

返回模型列表后，再测试 generateContent：

curl "https://quotarouter.ai/v1beta/models/gemini-3.5-pro: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
    }
  }'

模型名称

常见 Gemini 模型命名示例：

模型	适合场景
gemini-3.5-pro	通用推理、写作、代码理解
gemini-3.1-pro-preview	预览能力测试，具体稳定性以控制台为准

如果你在线上新增了某个 Gemini 模型，但 CLI 仍然报错，优先检查：

1. 模型是否在 Gemini 类型分组中开放。
2. API Key 是否绑定了正确分组。
3. 客户端传出的模型名称是否和控制台完全一致。
4. Base URL 是否被客户端自动追加了错误路径。

排查

• API key not valid：确认使用的是 QuotaAPI Key，而不是其他平台 Key。
• model not found：检查模型名称、分组权限和控制台模型列表。
• 404：通常是 Base URL 拼接错误，检查是否重复添加 /v1beta。
• 403：当前 Key 没有 Gemini 类型分组权限。