AI API 返回 429 是什么原因？限流与额度处理方法

429 不一定是余额不足

429 表示当前请求超过某种限制。限制可能按每分钟请求数、每分钟 Token、同时请求数、账户额度或上游容量计算。部分平台也会用 429 表示余额和套餐配额用完，必须阅读错误正文。

先判断是哪一类

偶尔一条短请求也立即失败，先检查余额、套餐和密钥额度；手动聊天正常、批量程序失败，多半是并发或频率过高；晚间集中出现、过一会恢复，可能是线路拥堵或上游限流。

查看控制台的限制说明和用量记录，比不断重试更有效。

正确的重试方式

遇到 429 后暂停，等待时间逐步增加，例如第一次等几秒，随后更长，并加入少量随机间隔。设置最大重试次数，超过后提示人工处理或切换备用线路。

固定每秒连续重试会进一步触发限制，也可能在服务恢复瞬间形成新的拥堵。

降低请求压力

减少同时运行的任务，把多个小请求合并为合理批次，缩短不必要的上下文，并限制最大输出。对非紧急任务使用队列逐个处理，而不是一次全部发送。

是否应该升级额度

先确认程序没有死循环和重复提交，再根据正常峰值申请更高限制。错误代码来自上游容量时，即使账户升级也未必解决，需要更换线路、模型或时段。

给客服的信息

提供发生时间、模型、每分钟大致请求数、并发量、错误全文和请求编号。不要发送完整密钥。若平台无法说明任何限制规则，关键自动化任务应准备独立备用服务。

429 的处理重点是“减速并找出限制维度”，而不是立刻充值或无限重试。