快速开始

本页帮你从控制台创建 API Key，并完成一次可验证的请求。整个流程不依赖特定客户端，适合先确认账号、余额、分组和模型是否可用。

1. 登录控制台

打开 QuotaAPI 控制台，使用你的账号登录。进入控制台后先确认两件事：

1. 账号有可用余额。
2. 需要使用的模型分组已经对你的账号开放。

如果你不知道应该选择哪个分组，可以先根据客户端判断：Claude Code 使用 Claude 类型分组，Codex CLI 或 OpenAI SDK 使用 GPT / OpenAI 类型分组，Gemini CLI 使用 Gemini 类型分组。

2. 创建 API Key

进入 API Key 管理页面，创建一个新的 API Key。建议按用途命名，例如：

用途	建议名称
本机 Claude Code	local-claude-code
Codex CLI	local-codex-cli
服务端 OpenAI SDK	server-openai-sdk
Gemini CLI	local-gemini-cli

创建后只在安全位置保存一次。后续如果怀疑泄露，请直接禁用旧 Key 并创建新 Key。

3. 选择 Base URL

不同协议的 Base URL 不同：

协议或客户端	Base URL
OpenAI 兼容接口、Codex CLI	https://quotarouter.ai/v1
Anthropic Messages、Claude Code	https://quotarouter.ai
Gemini v1beta、Gemini CLI	https://quotarouter.ai

4. 发送测试请求

OpenAI 兼容接口可以用下面的请求验证：

curl https://quotarouter.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "Say hello from QuotaAPI." }
    ],
    "max_tokens": 64
  }'

Claude / Anthropic Messages 可以用下面的请求验证：

curl https://quotarouter.ai/v1/messages \
  -H "x-api-key: YOUR_QUOTAAPI_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.8",
    "max_tokens": 64,
    "messages": [
      { "role": "user", "content": "Say hello from QuotaAPI." }
    ]
  }'

Gemini v1beta 可以先拉取模型列表：

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

如果你的 OpenAI / GPT 类型分组已开启图片生成，也可以测试图片接口：

curl https://quotarouter.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A small futuristic API gateway console.",
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

5. 查看用量记录

测试成功后回到控制台，查看请求记录和余额变动。一次完整调用通常会留下：

1. 请求时间和模型名称。
2. 消耗 token 或计费数量。
3. 扣费金额或倍率结果。
4. 成功状态，或上游返回的错误信息。

常见检查点

• 401：API Key 不存在、已禁用、复制时多了空格，或客户端没有按要求传入认证头。
• 403：当前 Key 没有目标分组或模型权限。
• 402 或余额不足提示：账号余额不足，需要先充值。
• 429：请求频率或并发超过限制，降低并发后重试。
• 400：请求体格式、模型名称或参数不符合目标协议。

WARNING

请不要把真实 API Key 写入公开仓库、工单截图、聊天记录或前端代码。服务端调用建议通过环境变量注入。