星桥 API
模型 API 突然回了 429，手一快就把“自动重试 10 次”打开？先稳一下。同样是 429，可能是请求太密，也可能是余额、消费上限或使用上限触发。 前者该减速、等一等；后者通常得先处理额度，猛点重试跟冲着没电的门铃使劲按差不多。
这是 OpenAI 官方错误说明中的分类。若你调用的是星桥或其他网关，最终含义还要以实际返回的错误正文、响应头和该服务的文档为准，不能只看一个数字就给上游定责。
图：AI 生成的情境图，用来区分两类处理方向，不是实际报错截图。
先留三样证据，别先补十次请求
找到失败请求，记下 HTTP 状态码、错误正文里的 error.code / error.type、响应头里的 Retry-After。再记请求时间、模型和请求 ID（若有）。给人排查时把 API Key 和私人内容遮住。客户端只弹“429”的话，去看它的详细日志或原始响应；看不到错误正文，就先别推断一定是限速。
在星桥接入时，还可以对照钱包余额、密钥额度、当前分组和使用日志。账户有余额，不代表某把密钥仍有额度；使用日志没记录，也不能证明请求没到网关，它可能在鉴权或网络阶段就失败了。
图：先读返回信息，再按错误原因行动。图中错误码取自 OpenAI 官方说明；其他服务的字段可能不同。
路线一：临时限速，给请求减速
如果错误正文明确指向请求速率过高，或出现 rate_limit_error、slow_down 这类限速信息，先减少并发与发送频率。响应里有有效的 Retry-After，至少等它指定的时间；没有时，采用有次数和总时长上限的退避重试，并加一点随机等待，避免多个客户端同时再冲一波。
检查客户端或 SDK 是否已经自动重试。外面又套一层重试，原本一次失败可能变成一串请求。OpenAI 官方文档还提醒：失败请求也可能计入每分钟限额，持续重发会让问题更难缓解。
路线二：额度或账单限制，先处理限制
若错误正文指向 credit_balance_exhausted、组织或项目的消费上限、使用上限，暂停重试，查看对应账户的余额和限额设置。OpenAI 官方文档明确说，这类问题不会因为等待几秒或指数退避就恢复。
在星桥还要区分账户钱包余额与密钥额度：两层都检查，再核对密钥状态、分组和请求模型。星桥站点文档没有承诺把每种上游错误都原样返回，所以遇到不明 429，不要照搬 OpenAI 的错误码表当结论。
收工前再核对一次：同一模型、同一密钥发一个小请求，看错误是否消失；若仍失败，保留脱敏后的错误正文、时间和请求 ID，按服务商文档或支持入口继续查。别把完整 API Key 发进群聊或截图。
星桥 API 网关由我们运营。若你正接入星桥，公众号菜单「接入文档」里有钱包、密钥额度、分组与使用日志的检查入口；使用其他服务时，请以其自己的错误说明为准。
资料：OpenAI 官方《Error codes》《Rate limits》；星桥《使用文档》。核对于 2026-10-28。本文是文档排查法，不是对读者账户或某次 429 的实测诊断。