调用频率限制

全局限流

所有 API 请求均受全局限流保护，基于客户端 IP 地址进行限制：

限流窗口	限流值	限流维度
短期（突发）	5 秒 100 次	按 客户端 IP
长期	3 分钟 1000 次	按 客户端 IP

全局限流触发时，HTTP 状态码为 429 Too Many Requests。

限流响应头

每次请求响应中都会包含以下限流相关头部，方便客户端实现自适应调速：

响应头	说明
X-RateLimit-Limit	长期窗口的请求上限
X-RateLimit-Remaining	长期窗口内剩余可用次数
X-RateLimit-Reset	长期窗口重置时间（Unix 时间戳）
X-RateLimit-Limit-Burst	短期（突发）窗口的请求上限
X-RateLimit-Remaining-Burst	短期窗口内剩余可用次数

接口级限流

除全局限流外，以下接口还有额外的接口级限流规则：

限流分组	限流值	限流维度
DCV 相关接口	10 秒 1 次	默认按 账号；当路径包含 :id 时按 账号 + 资源 ID
工具相关接口	5 秒 10 次	按 账号 + 工具接口路径

限流响应

全局限流响应

触发全局限流时，HTTP 状态码为 429 Too Many Requests，响应体为纯文本：

rate limited.

接口级限流响应

触发接口级限流（DCV / 工具接口）时，HTTP 状态码为 400，响应体为 JSON：

{
  "code": "request_too_fast",
  "error": "请求太频繁，请稍后再试"
}