限流与重试

QPS 限制与退避策略

限流规则

  • 调用频率上限由套餐决定（按分钟 / 按日）
  • 超出限流返回错误码 30005
  • 限流维度：API Key + 接口

重试建议

  1. 遇到网络错误、5xx 或请求超时等情况可重试，业务错误码不建议重试
  2. 采用指数退避：1s → 2s → 4s，最多重试 3 次
  3. 避免在重试时放大流量，建议加随机抖动
请勿在循环中无退避重试，否则会触发风控并临时封禁 API Key。