API 文档 · 可靠性
限流
RPM、并发与限流响应头。
RPM 按 Key 计算,固定 60 秒窗口;上限取 Key 的 RPM 与账号 RPM 中较小的一个,同一账号的多个 Key 各自计数。超过时返回 429 rate_limited。通过鉴权的请求都带以下响应头:
| 响应头 | 含义 |
|---|---|
X-RateLimit-Limit | 当前窗口允许的请求数 |
X-RateLimit-Remaining | 当前窗口剩余请求数 |
X-RateLimit-Reset | 窗口重置时间(unix 秒) |
Retry-After | 仅 429 时返回,建议等待的秒数(并发超限时为 10) |
同时进行中的任务数受 Key 的并发上限与账号并发上限约束。可以在控制台为每个 Key 单独设置 RPM 与并发上限;需要更高的账号上限请联系运营。
429 响应
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1730259012
{ "error": { "code": "rate_limited", "retryable": true, ... } }