请求限流(按 key)
每把 API key 都有一个每分钟请求数设置(默认 60)。同一限额适用于所有需要认证的/v1 端点,而不是给每条路径单独分配额度。超出限额会返回 HTTP 429,并带上 Retry-After 与 X-RateLimit-* 响应头:
账户月度上限
托管环境可按 USD 为账户设置月度上限。启用后,当月计量用量一达到上限,需要认证的/v1 请求就会返回 HTTP 429 insufficient_quota,直到下一个自然月,或支持人员上调上限:
客户端节流
同一 key 的合计请求速率应低于其配置的 RPM。流式调用在请求开始时计数。结构化记录应批量写入同一个POST /v1/data 请求(最多 500 条);文件上传后,在其文本就绪前不要密集轮询。
客户端退避
- 收到
429 rate_limit_exceeded,遵守Retry-After:切勿立即重试;连续两次后退避翻倍,上限 5 分钟。 - 收到
429 insufficient_quota,不要重试:配额按月重置或经支持调整;把它反馈给运维方。