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