速率限制
Annie Insights API 强制执行速率限制，以确保公平使用和系统稳定性。
按密钥类型限制
| 钥匙类型 | 速率限制 | 爆裂 | 每日上限 |
|---|---|---|---|
| 沙盒 | 10 请求/分钟 | 5并发 | 500/天 |
| 生产 | 风俗 | 风俗 | 风俗 |
速率限制标头
每个 API 响应在标头中都包含速率限制信息：
| 标头 | 描述 |
|---|---|
X-RateLimit-Limit | 当前窗口允许的最大请求数 |
X-RateLimit-Remaining | 当前窗口中剩余的请求 |
X-RateLimit-Reset | 窗口重置时的 Unix 时间戳 |
Retry-After | 重试前等待的秒数（仅适用于 429） |
处理速率限制
当您超过速率限制时，API 将返回 HTTP 429：
{
"error": "Too Many Requests",
"message": "Rate limit exceeded. Retry after 60 seconds.",
"statusCode": 429
}
最佳实践
- 监控标头 — 在发送请求之前检查“X-RateLimit-Remaining”
- 队列请求 — 实现具有受控吞吐量的请求队列
- 指数退避 — 在 429 上，重试前等待“2^attempt”秒
- 联系销售人员 — 如需更高限制，请联系 api-support@hcds.ai