API 报错排查：400、401、429、502 与超时
| 现象 | 先检查什么 |
|---|---|
| 400 参数错误 | 请求协议、图片格式、上下文长度、工具调用 ID 与结果配对。 |
| 401 鉴权失败 | Key 是否有效，认证头是否正确，是否复制了空格。 |
| 404 | 完整 URL、模型 ID 和分组可用目录。 |
| 429 | 账户并发、上游配额；减少并发并使用有上限的退避重试。 |
| 502 / 503 | 网关或上游暂时失败，记录请求 ID，检查服务状态。 |
| 连接重置或超时 | 客户端网络、代理、超时设置，以及长请求是否使用流式。 |
工具调用失败
工具定义必须符合接口格式。每个工具结果应对应已有调用 ID，不要重复提交或遗漏结果。浏览器工具自身超时需要结合客户端工具日志检查，不能只凭 API 状态归因。
重试与客服
不要无限重试；已输出部分内容的请求可能已产生用量。联系 TG 客服时提供时间、模型、端点和请求 ID。不要发送完整 Key、密码或含敏感资料的会话。