报错排查

按状态码定位问题。

先记下 HTTP 状态码、错误信息、请求时间和响应里的 request_id，比一张截图更有用。

按状态码排查

状态码	含义	怎么处理
`401`	认证失败	检查密钥是否完整、无多余空格或引号，是否已停用、删除或过期；确认用的是 sk- 开头的 API 密钥。
`402`	余额不足	到「账单与充值」充值后重试。
`403`	无权限	密钥分组不支持该模型或接口，例如用 Claude 分组的密钥去配 Codex。
`404`	接口或模型不存在	检查 Base URL 是否重复拼了 /v1，接口路径和协议是否匹配，模型名是否在 /v1/models 列表里。
`429`	请求太多	降低并发，用带随机等待的指数退避重试，不要立即无限重试。
`5xx`	服务暂时异常	稍后重试；持续出现请把 request_id 和模型名通过「反馈」提交给我们。

检查反向代理、CDN 和客户端是否缓冲了响应。Nginx 需对流式接口关闭 proxy_buffering，并把读取超时设得足够长。

提交前请把密钥、Authorization 请求头和敏感内容打码，不要发送完整密钥。