速率限制 & 额度

哪些有上限

你的套餐限制四样东西,都可在 GET /v1/account 中看到:监控目标数、关键词数、并发 WebSocket 连接数和每分钟请求数。前两项超限返回 402 plan_limit 并附 details.resource,第三项以 4002 关闭连接,第四项返回 429 rate_limited 并附 Retry-After 头部。

头部

每个经过认证的响应都会告诉你当前的用量位置,客户端可以在被拒绝之前主动退避:

头部含义
X-RateLimit-Limit此密钥每分钟允许的请求数
X-RateLimit-Remaining当前这一分钟内还剩多少
X-RateLimit-Reset窗口重置的 Unix 时间
X-Credits-Used-Today自 00:00 UTC 起按需读取消耗的额度
X-Request-Id报给我们,我们就能在日志中找到这次请求
X-Response-Time我们的处理耗时,毫秒
ETagJSON 响应的弱校验值;作为 If-None-Match 发回
Idempotent-Replay当响应是对同一 Idempotency-Key 早先请求的重放时为 true
Retry-After需要等待的秒数,每个 429 都带
Location已创建或已排队资源的位置,出现在 201 和 202 上

额度

流式传输不计量——空闲连接和繁忙连接成本相同,连接上的帧也不计入请求预算。读取一节下的按需 REST 读取会消耗额度,每次调用 1 或 2 点,各端点处有标注;GET /v1/account/usage 显示你的每日总量。