大模型 API 调用失败时，按原始报错、API Key、接口地址与模型 ID、服务端请求记录四步检查，缩小问题范围。
第一步：保留原始报错
记下发生时间、HTTP 状态码、响应中的错误信息和请求 ID。不要只记录客户端的“调用失败”提示；包装后的提示通常无法解释具体原因。
第二步：检查身份
遇到鉴权错误，检查密钥是否完整、是否停用，以及请求是否采用正确的认证方式。分享截图或日志前，隐藏密钥和其他敏感信息。
第三步：检查地址和模型
接口路径是否重复拼接？模型 ID 是否准确？模型与所选协议是否匹配？逐项修改，每次只改一个变量，方便判断哪一步起了作用。
第四步：查看服务端记录
如果服务端没有对应请求，先检查客户端实际发送的地址和网络情况。如果存在记录，结合状态、错误信息与请求 ID 继续定位。
状态码只是线索，最终以具体响应为准。限流、额度不足或上游异常，需要各自对应的处理方式。
