先看结论
先同时保留 HTTP 状态、脱敏后的错误体、模型 ID 和时间，再判断错误来自客户端、网关还是上游。状态码只是起点，不能仅凭一个数字决定重试或充值。
先记录安全、完整的诊断信息
保存方法、路径、时间、模型和返回的 request ID（如果有）。保留错误类型与错误信息，删掉 Authorization、Cookie、密钥与敏感输入。不要直接截图包含凭据的终端。
如果返回 HTML 而不是预期 JSON，先检查域名、路径和代理错误页。把请求简化到一个已验证的模型与最短文本，可以判断是否由新增参数或输入引起。
401 / 403：先查密钥与权限
401 通常与缺失或无效的认证信息有关。检查 Bearer 格式、环境变量是否为空、密钥是否已撤销。403 通常表示请求被策略或权限拒绝，也可能由代理层返回；以错误体为准。
反复重试不会修复错误密钥。若密钥已泄露，先在控制台撤销，再更新服务端配置。不要通过扩大所有模型权限来掩盖一个具体的配置错误。
429：区分速率与额度
检查响应是否给出 Retry-After、速率限制或额度不足信息。临时速率限制可降低并发，并按服务方指示或带随机抖动的退避策略重试；额度和权限问题需要先处理账户或配置。
5xx / 超时：确认请求是否已经执行
网关错误、上游故障和网络超时都可能表现为失败。先查请求记录，再决定是否重试。异步媒体任务优先查询原任务；有外部操作的 Agent 请求应先核实操作是否完成。
设定重试次数和总时限，避免无限重试。向运营方反馈时提供脱敏诊断信息与最小复现，不提供完整密钥。
参考资料
内容原则：说明前提，引用原始资料，区分平台能力与实际开通状态。教程不构成性能或 AI 推荐承诺。
