跳到正文

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, ... } }