AI API 返回 429 怎么办

适用条件

适用于供应商明确返回 HTTP 429 的调用。需要区分消费额度与请求速度的限制。

操作步骤

1. 读取错误类型和响应头

如果错误类型指向额度、余额或预算，先检查计费控制台。若指向请求或 Token 速率，记录限制窗口与 Retry-After（如果提供）。

2. 降低速率并限制并发

将调用加入队列，设置重试上限。速率超限且没有等待建议时，使用带随机抖动的指数退避，避免多个工作进程同时重试。

3. 核对项目级用量

检查是否有多个服务共用项目或密钥。额度类错误处理完成后用一个小请求验证，再逐步恢复队列。

常见问题

可以收到 429 就立刻重试吗？

频繁重试可能加重限流。先读错误类型和 Retry-After，再选择等待、降并发或检查计费。