速率限制

千木（SilvaMux）API 使用 Key 级别的滑动窗口限流，确保服务稳定性和公平使用。

各套餐限额

套餐	RPM	TPM	价格
Free	3	40,000	免费
Basic	30	200,000	¥99/月
Pro	120	1,000,000	¥299/月

RPM = 每分钟请求数，TPM = 每分钟 Token 数。限额按 API Key 粒度计算。

工作原理

1.滑动窗口：使用 Redis 有序集合实现 1 分钟滑动窗口，精确控制请求频率。
2.Key 级别：限流按 API Key 粒度执行，不同 Key 互不影响。JWT 认证按 User 粒度限流。
3.套餐联动：未订阅套餐的用户按 Free 套餐限额执行，订阅后自动升级。

超限响应

当请求超过限额时，API 返回 429 Too Many Requests：

{
  "error": {
    "type": "rate_limit_exceeded",
    "code": 42910,
    "message": "请求频率超限",
    "detail": "RPM limit reached (3 requests/min)"
  }
}

建议在客户端实现指数退避重试策略。返回 429 后，等待 Retry-After 秒后再重试。