429 与配额：限的是频率，不是并发
429 分两种：rate limit exceeded 是单 IP 频率超限（同出口 IP 共用额度），user rate limit exceeded 是账号级频率超限；令牌或令牌组配额触顶也会被拒，但按周期恢复。
更新于 2026-11-14 · SageLib 团队 · 标签：429、rate-limit、quota
结论要点
- 网关只有频率限制，没有并发数限制
- 同一出口 IP 下的多台机器共用 IP 额度
- 配额恢复时间：次日 / 周一 / 月初 1 号（按令牌组的周期设置）
两种 429
| 错误体 | 含义 | 处理 |
|---|---|---|
rate limit exceeded |
单 IP 频率超限 | 降频率、错峰、换出口 IP |
user rate limit exceeded |
账号级频率超限 | 降频率，或联系客服调整阈值 |
网关没有并发数限制，只有频率限制。这带来一个容易忽略的后果： 同一出口 IP 下的多台机器、多个容器共用同一份额度，看起来「机器越多越容易 429」。
配额触顶不是 429
令牌或令牌组可以设置限额（按 token / 按金额 / 按次数），触顶后请求会被拒绝， 但按周期自动恢复：次日、周一或月初 1 号 0 点，取决于令牌组的周期设置。
余额不足是 402
402 insufficient balance 与限流无关：余额不足时请求直接被拒，
充值后立即恢复，不需要等周期。
排查顺序
- 先看错误体是
rate limit exceeded还是user rate limit exceeded； - 再看令牌 / 令牌组配额是否已用满；
- 最后才怀疑上游——上游问题通常是 502 或流式中断，不是 429。
相关：限流与配额规则。
参考来源
常见问题
加机器后更容易 429 了？
大概率是同一出口 IP 共用额度导致的；给新增机器换出口，或联系客服调整阈值。
配额用完了要等到什么时候？
看令牌组的周期设置，常见是次日 0 点、周一 0 点或月初 1 号 0 点恢复。