限流与并发

当前默认限制为 IP 每分钟 180 次、Key 每分钟 60 次、账户每分钟 90 次。IP 限制也覆盖已鉴权请求；同一账户的多把 Key 共用账户速率限制。账户最多同时执行 5 个数据请求，单 Key 还受创建时的 max_concurrent_requests 限制。请求体最多 256 KB，每页最多 50 条。

每日额度限制一天内成功的 REST 数据调用总数；速率限制一分钟内的请求次数；并发限制尚未完成的请求数量。一次校验不消耗每日数据额度，但仍受速率限制。降低 limit 或新建 Key 不能绕过账户每日额度；串行调用能降低并发，却不能增加每日额度。

达到 10 次 REST 数据调用后返回 HTTP 429 和 API_DAILY_LIMIT_REACHED。请等到 Asia/Shanghai 时区次日 00:00；创建或轮换 Key 不会重置账户额度。

遇到 RATE_LIMITED 时遵循 Retry-After 并退避重试。有效 Key、权限范围、速率、并发和账户状态限制继续生效。

根据 error.code 选择处理方式，而不是仅判断 HTTP 429。RateLimit-Limit、RateLimit-Remaining 和 RateLimit-Reset 描述短时速率窗口；Reset 为 Unix 秒时间戳，不是每日额度重置时间。超过速率窗口时会返回 Retry-After 秒数；并发或每日额度触发的 429 不保证有该 Header。每日用量查看 daily_usage，日额度错误查看 error.details.daily_usage。

每次成功的 REST 数据请求计 1 次，包括空结果和服务器缓存命中。相同 Idempotency-Key 与相同参数重试会复用原结果，不重复占用每日次数。失败请求和 304 响应不消耗每日额度。

遇到 RATE_LIMITED 时遵循 Retry-After 并退避重试。有效 Key、权限范围、速率、并发和账户状态限制继续生效。

RATE_LIMITED 时优先等 Retry-After；未返回时降低并发，以指数退避加少量随机延迟重试，并设最大次数。例如依次等 1、2、4 秒后停止并记录请求 ID。API_DAILY_LIMIT_REACHED 不适合每秒重试，应等到日额度重置；401、403 和参数错误应先修正原因。

重试同一次 REST 数据操作时保持 Idempotency-Key 和参数一致。新建逻辑操作才生成新 Key；参数改变却复用 Key 会触发 IDEMPOTENCY_CONFLICT。不要把不同分页请求合并为同一操作；可重试的 5xx 同样要限次退避。

账户的两把 Key 各成功读取 5 次数据后，REST 每日 10 次额度即已耗尽，即使最后一分钟没有发请求也不能继续读取。网站独立的 10 次搜索不受这组次数影响。MCP 不占这两种每日额度，但同时发起过多 MCP 请求仍可能触发 RATE_LIMITED。