API 返回 401、403、429：按顺序定位问题

先保存可复现的信息

记录请求时间、接口、模型 ID、HTTP 状态码和响应中的 request_id。不要把完整 API Key、提示词或个人信息放进工单和公开日志。

401 与 403 的区别

401 优先检查 Authorization: Bearer 请求头、密钥是否正确以及是否被撤销。403 表示已识别请求但当前账户或 Key 无权使用目标模型；检查认证级别、模型授权和企业 Key 归属。不要用不断重试来解决权限问题。

429 应如何重试

429 表示触发限流。响应有 Retry-After 时按该值等待；没有时使用带随机抖动的指数退避，设定最大重试次数。并发请求还应限制客户端排队长度，避免重试风暴。额度以控制台、响应头或合同约定为准。