限流规则

为防止滥用、保障平台稳定，开放 API 对请求频率做了限制。限流基于 Redis 固定窗口计数器实现，在服务的所有副本间保持一致。

触发限流时

超过频率上限的请求会返回 HTTP 429， 业务码为 100005：

{
  "code": 100005,
  "message": "请求过于频繁，请稍后再试",
  "trace_id": "..."
}

处理建议

• 收到 429 后按指数退避（如 1s、2s、4s…）重试，并加入随机抖动。
• 控制客户端并发数，避免瞬时把请求全部打出去。
• 把可缓存的结果（如模型列表）缓存在本地，减少重复请求。
• 生成任务用「提交 + 轮询」模式，不要高频轮询同一个任务。

额度与限流的区别

限流限制的是「单位时间内的请求次数」，额度限制的是「累计消耗的费用」。 两者相互独立：即使额度充足，请求过快仍会被限流；额度耗尽则无论频率高低都会 被拒绝。额度设置见 API Key 认证，全部错误码见 错误码说明。