Gemini v1beta

Gemini v1beta 接口适合 Gemini CLI、Gemini SDK 和兼容 Gemini 协议的工具。

Base URL

https://quotarouter.ai

常用请求路径：

/v1beta/models
/v1beta/models/{model}:generateContent
/v1beta/models/{model}:streamGenerateContent

API Key

Gemini 协议常见写法是在查询参数中传入 Key：

?key=YOUR_QUOTAAPI_KEY

部分客户端也支持通过请求头传入。优先使用客户端推荐方式。

模型列表

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": "Explain QuotaAPI in one sentence." }
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 120
    }
  }'

streamGenerateContent

curl "https://quotarouter.ai/v1beta/models/gemini-3.5-pro:streamGenerateContent?key=YOUR_QUOTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "Stream a short QuotaAPI test response." }
        ]
      }
    ]
  }'

配置注意事项

项目	说明
Base URL	如果客户端会自动拼接 /v1beta，填 https://quotarouter.ai
完整前缀	如果客户端要求填完整 API 前缀，填 https://quotarouter.ai/v1beta
模型名	必须和控制台开放的 Gemini 模型一致
Key	使用 QuotaAPI 控制台创建的 API Key

排查

• 404：检查 Base URL 是否重复拼接 /v1beta。
• 401：Key 无效或未传入。
• 403：API Key 没有 Gemini 分组权限。
• model not found：模型名未开放、拼写错误或分组没有该模型。