限流与配额

为保障平台稳定性，开放接口按 API Key 维度实施三层限流。

默认限额

维度	默认值	说明
QPS	10	每秒最多请求数
并发	5	同时处理中的请求/连接数（含 WebSocket 会话）
日调用量	100,000	自然日累计调用次数，每日零点（北京时间）重置

• 创建密钥时可在默认值内自定义每个密钥的限额；
• 需要更高限额（如生产环境大流量接入），请完成企业认证后联系平台支持评估调整。

限流响应头

每次响应携带限流状态头，建议调用方据此做主动降速：

响应头	含义
X-RateLimit-Remaining	当前窗口剩余可用请求数
X-RateLimit-Reset	当前限流窗口重置时间
Retry-After	被限流（429）时建议等待的秒数

触发限流的错误码

错误码	触发条件
rate_limited	超过 QPS 限制
concurrency_limited	超过并发限制
daily_quota_exceeded	超过日调用量限制

三者均返回 HTTP 429 与统一错误结构（见「错误码」）。

调用方最佳实践

1. 指数退避重试：收到 429 后按 Retry-After 或 1s/2s/4s 退避重试，避免雪崩式重试放大流量。
2. 平滑发送：批量任务用固定速率的队列发送（如令牌桶），不要瞬时打满。
3. 拆分密钥：不同业务线使用不同密钥，互不挤占限额，也便于用量归因。
4. 监控余量：采集 X-RateLimit-Remaining 指标，在余量持续偏低时提前扩容限额。