建议在业务侧把鉴权、额度、上游可用性和参数错误分开处理，这样更容易定位问题。
| HTTP | 典型原因 | 建议处理 |
|---|---|---|
400 | 请求参数缺失或格式错误 | 检查模型名、请求体结构与必填字段 |
401 | API Key 无效或未携带 | 确认 Authorization 头是否为 Bearer YOUR_API_KEY |
403 | 账号权限、上游限制或策略拦截 | 检查账户状态、模型权限或上游可用性 |
429 | 请求频率过高或额度限制 | 在客户端增加重试退避与队列控制 |
500 / 502 | 网关或上游异常 | 建议记录 request id 并做短暂重试 |
把 401、429、500 类问题分别埋点，便于快速区分鉴权问题、限流问题和上游稳定性问题。
记录模型名、接口路径、request id 和关键参数，有助于排查偶发失败。
对 429、500、502 这类可恢复错误，建议采用短退避重试和熔断策略。
对计费型、异步型和上传型接口，不建议无上限自动重试。