速率限制
速率限制保护API免受滥用，并确保所有客户的公平使用。限制因计划而异。
各计划限制
| 计划 | 请求/分钟 | 积分/月 |
|---|---|---|
| Free | 5 | 1,000 |
| Pay As You Go | 5 | 按购买量 |
| Project | 10 | 7,000 |
| Bootstrap | 10 | 28,000 |
| Startup | 10 | 85,000 |
| Growth | 10 | 200,000 |
速率限制响应头
每个API响应都在响应头中包含速率限制信息：
| 响应头 | 描述 |
|---|---|
X-RateLimit-Limit | 您的计划每分钟最大请求数 |
X-RateLimit-Remaining | 当前窗口内剩余请求数 |
X-RateLimit-Reset | 速率限制重置的Unix时间戳 |
处理429错误
当您超过速率限制时，API返回 429 Too Many Requests 响应。正确处理方法：
- 检查
X-RateLimit-Reset响应头以了解何时可以重试 - 在重试逻辑中实现指数退避
- 将请求排队以保持在每分钟限制内
- 如果持续达到限制，考虑升级您的计划
429 Too Many Requests
{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded. Retry after 30 seconds."
}
}建议
- 尽可能缓存结果以减少API调用
- 批量处理相关查询，而非发送许多小请求
- 在控制台中监控使用量，提前预判限制需求