限流
两级固定窗口限流、X-RateLimit 响应头与 429 处理。
两级固定窗口计数限流，任一超限即 429：
| 级别 | 默认额度 | 窗口 |
|---|---|---|
| 租户级 | 600 次/分钟 | 60s |
| API key 级 | 120 次/分钟 | 60s |
实际额度按账户配置，以响应头为准。
响应头
每个响应都携带：
| Header | 说明 |
|---|---|
X-RateLimit-Limit-Tenant / X-RateLimit-Remaining-Tenant | 租户级额度 / 剩余 |
X-RateLimit-Limit-Key / X-RateLimit-Remaining-Key | key 级额度 / 剩余 |
X-RateLimit-Reset | 距额度重置的秒数 |
429 处理
- 遵守 429 响应的
Retry-After头（秒），再携带相同的Idempotency-Key重试； - 突发并发是触发限流最常见的原因，客户端做好请求平滑；
- 需要提额：控制台联系我们或找对接的账户经理。