限流与配额 - Mirobody

两道相互独立的控制,保护平台与你的花费。二者都返回 OpenAI 兼容的错误信封,标准 SDK 能直接识别。

请求限流(按 key)

每把 API key 限制每分钟请求数(默认 60)。超额返回 HTTP 429,带 Retry-After 与 X-RateLimit-* 头:

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{"error": {"message": "Rate limit exceeded: this API key allows 60 requests per minute. Retry after 12s.",
           "type": "rate_limit_error", "code": "rate_limit_exceeded"}}

窗口按服务副本计数,故公布的 per-key 数值是下限而非精确全局上限。需要提高某 key 的限额,联系 Mirobody Support。

用量配额(按账户,月度)

每个账户有月度用量上限(以 billed 模型用量的 USD 计)。当当月用量达到上限时,/v1 请求被拒,返回 HTTP 429 insufficient_quota,次月自动重置:

{"error": {"message": "You have reached your $5 monthly API usage limit (billed $5.00 this month). It resets next month; contact support to raise it.",
           "type": "insufficient_quota", "code": "insufficient_quota"}}

该上限覆盖账户名下所有 key 的合计。成本按 provider-true(billed)token 乘档位单价计量,命中提示词缓存的部分按更低的缓存价计(每次响应的 usage.billed_tokens 可见)。提高或解除上限,联系 Mirobody Support。

客户端节流

路径	建议 RPM	说明
`POST /v1/chat/completions`	≤ 60	流式调用同样计数
`POST /v1/responses`	≤ 60	支持并发流式
`POST /v1/files`	≤ 30	单文件上限 100 MB;OCR 计算开销大
`POST /v1/data`	≤ 120	批量合并到一次请求(每批 ≤ 500 条)
`GET` 读取	≤ 120	—

客户端退避

收到 429 rate_limit_exceeded,遵守 Retry-After——切勿立即重试;连续两次后退避翻倍,上限 5 分钟。
收到 429 insufficient_quota,不要重试——配额按月重置或经支持调整;把它反馈给操作方。

​请求限流(按 key)

​用量配额(按账户,月度)

​客户端节流

​客户端退避

请求限流(按 key)

用量配额(按账户,月度)

客户端节流

客户端退避