API Key
如何发送 Key，如何为每个应用单独设置消费额度和可调用的模型，以及如何读取速率限制响应头。
在 API Key 页面创建和管理 Key。建议每个应用或环境各用一个 Key：这样可以单独限制它的消费、只允许它调用部分模型，或者直接吊销，不影响其他 Key。
发送 Key
所有端点都接受以下任一请求头传递 Key，所以 OpenAI 和 Anthropic 的 SDK 无需任何改动就能用：
-H "Authorization: Bearer $OHMYGPT_API_KEY" # OpenAI SDKs, curl
-H "x-api-key: $OHMYGPT_API_KEY" # Anthropic SDK, Claude CodeGemini 的 generateContent 端点还接受 x-goog-api-key，也就是 Google GenAI SDK 发送的请求头。Key 只放在其中一个请求头里。
Key 设置
每个 Key 都有独立的设置，每次请求都会检查：
| 设置 | 作用 | 生效后的响应 |
|---|---|---|
| 消费额度 | Key 的消费达到这个数额后停止工作 | 402 api_key_spend_limit_exceeded |
| 可调用的模型 | 只允许 Key 调用你列出的模型 | 403 model_not_allowed |
| 到期日期 | 过了这个日期 Key 停止工作 | 401 api_key_expired |
| 启用 | 关闭 Key 但不删除 | 401 api_key_disabled |
被 Key 设置拦下的请求不收费，错误信息会说明该改哪项设置：
{
"error": {
"param": "model",
"code": "model_not_allowed",
"message": "This API key cannot use the model `openai/gpt-5.4-nano`. Update the key's allowed models at https://www.ohmygpt.com/keys.",
"type": "permission_error"
}
}所有 Key 共用账户余额。余额用完后，调用会返回 402 insufficient_credits；到账单页面充值后即可恢复。
速率限制
你的账户有一个每分钟请求数上限，由账户下所有 Key 共享。累计充值越多，上限越高：
| 累计充值 | 每分钟请求数 |
|---|---|
| 不足 ¥20 | 60 |
| ¥20 及以上 | 1,000 |
| ¥300 及以上 | 10,000 |
GET /v1/me 返回你当前的上限，以及下一档的上限和门槛：
curl https://api.ohmygpt.com/v1/me -H "Authorization: Bearer $OHMYGPT_API_KEY"{
"rpm": 60,
"recharge_band": "normal",
"next_recharge_band": "vip",
"next_recharge_rpm": 1000,
"next_recharge_threshold_cny": 20
}模型端点会在每个响应里告诉你当前的用量情况：
X-RateLimit-Limit-Requests: 60
X-RateLimit-Remaining-Requests: 59
X-RateLimit-Reset-Requests: 1sX-RateLimit-Reset-Requests 是距离限额重置的时长，写法如 1s 或 500ms。超出上限时，调用会返回 429 rate_limit_exceeded，并带上以秒为单位的 Retry-After 头；等待相应时间后再重新发送。