故障排查

先记录发生时间、客户端、模型、错误状态和请求标识，不要提供完整 API Key。

现象	优先检查
401 或密钥无效	是否复制完整、密钥是否停用或过期、认证字段是否正确
403 或无权限	分组、模型权限、账号状态和密钥限制
429 或限流	并发与速率限制；按响应提示退避，避免立即重复请求
余额不足	账户额度、订阅和密钥自身额度限制
404 或协议不匹配	Base URL 是否重复追加 /v1，以及该渠道是否支持请求协议
502、503 或没有可用渠道	查看可用渠道状态；未接入上游时等待配置
响应中途断开	查看超时、网络和网关错误；保存已有输出并核对用量

单次请求过长、并发过多、客户端超时或中间代理超时都可能导致断线。已收到部分输出不意味着服务器已停止计费；重试前核对使用记录，避免把失败重试当成免费请求。

有工具调用或其他副作用的任务，先确认已执行的步骤再重试。减小任务范围、控制输出长度和并发，能帮助定位问题。

商城查单失败时确认使用的是商城入口，订单号和查询信息与下单时一致；支付尚未接入时不会存在真实付款订单。