速率限制

为了确保公平使用和系统稳定，我们的 API 实施了速率限制。不同的订阅套餐有不同的速率限制。

套餐额度

每月额度取决于你的套餐。这是所有产品共用的一份额度，每一次计量调用在其中计一次。

Free：每月 30,000 次请求，平均约每天 1,000 次，且没有每日上限。

付费套餐： Starter 每月 150,000 次，Pro 每月 500,000 次，Business 每月 2,000,000 次。Enterprise 不限量。

演示端点：无需密钥的演示端点对每个 IP 地址每天允许约 100 次请求，无需注册。

GET /v1/demo/{ip}

速率限制标头

所有 API 响应都包含可提供当前速率限制状态信息的标头：

X-RateLimit-Limit: 当前时间窗口内允许的最大请求数

X-RateLimit-Remaining: 当前时间窗口内剩余的请求数

X-RateLimit-Reset: 速率限制窗口重置的时间（Unix 时间戳）

超出速率限制

如果你超出速率限制，API 将返回 429 Too Many Requests 响应，正文如下：

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please try again later.",
  "retryAfter": 60
}

最佳实践

实施退避策略：当你收到速率限制错误时，请在重试前实施指数退避。

缓存响应：尽可能缓存 API 响应，以减少请求次数。