新闻

用通俗的语言解释速率限制

速率限制向来以令人困惑著称,充满了例外和细则,往往出了问题之后才弄明白。我们的速率限制比这简单,值得在一个地方清楚地说明。

每个地址无需任何密钥,每天都可获得 2,500 次免费请求。这一配额并不是按单个地址计算的,而是在网络内共享:同一 /24 中的所有 IPv4 地址和同一 /48 中的所有 IPv6 地址共同使用一个配额池。如果您位于共享的办公网络连接或大型网络地址转换环境之后,这一点就很重要,因为您的免费配额与同一网段上的其他所有人共享,无论他们是否使用密钥。

每个密钥还拥有自己的每日免费配额,共 2,500 次请求,独立于网络已经提供的配额。密钥的配额不会因同一网络上的其他流量而减少,网络的配额也不会因已经用完某个密钥独立配额的流量而减少。这两种配额并存,而不是相互竞争。

当天超出这两项配额之后,请求要么按每次 €0.0001 从预付额度中扣除,要么由每月 €50 的 Unlimited 套餐覆盖,取决于账户设置的是哪一种。不存在悄悄放慢请求速度的限流,也不会毫无解释地突然拦截。每个响应都携带配额响应头:X-Quota-LimitX-Quota-UsedX-Quota-Free-RemainingX-Quota-Network-UsedX-Credits-RemainingX-Key-IPs-UsedX-Key-IPs-LimitX-Quota-Reset,因此在请求失败之前,就能清楚看到它的确切状态。

批量调用遵循同样的规则,但按单项而不是按调用计算。在一次调用中发送一百个地址,会从适用的配额中计为一百次请求,与分成一百次单独调用发送完全相同。

以上所有规则同样适用于每个端点以及全部十七个兼容主机。按 OpenCage 或 ipstack 格式构造的请求,与直接发往 /v1/forward/v1/ip 的请求遵循完全相同的速率限制规则,不会有更严格的单独限制藏在看起来熟悉的响应结构背后。

完整详情,包括每日重置的方式和每个响应头的含义,记录在 /docs/rate-limits/。如果您的集成中出现了速率限制方面的问题,答案几乎总能直接在触发该问题的响应头中看到。