API 中转错误排查：401、404、429、超时与账单

按地址、认证、模型、限流和响应类型排查 API 请求，避免无效重试。

先保留一条可复现记录

记录北京时间、客户端版本、模型 ID、接口路径、状态码及请求标识。截图隐藏完整 Key、账号凭据和业务内容。控制台余额、Key 额度、分组权限与客户端配置需要分别检查。

现象	先检查	下一步
401 / 403	Key、有效期、分组和权限	确认当前客户端实际使用的凭据；不要继续提交相同错误请求。
404 / 路径错误	Base URL、重复 /v1、协议类型	按客户端要求填写基础地址；Responses 和 Messages 不能混填。
模型不存在 / 不支持	请求 model 与该分组模型列表	使用控制台实际允许的完整 ID，不拿分组名称当模型名。
429	错误内容、额度、频率和并发	降低并发；若有 Retry-After 按提示等待，设置有限重试。
5xx / 暂时不可用	发生时间、响应错误和站内通知	保留请求标识；短暂等待后有限重试，持续失败时反馈。
超时 / 断流	网络、代理、超时和流式支持	先查用量与任务是否仍在执行，避免重试造成重复请求和费用。

HTTP 成功不等于返回格式、工具调用或图像能力满足客户端要求。核对接口协议、模型、stream 参数及客户端兼容性；提供脱敏的最小请求和响应，不要只看状态码。

一次任务可能包含历史对话、工具结果、多个模型调用和缓存项。到计费指南对照请求明细，不按输出字数推断整次任务费用。未在客户端看到完整回答也不能直接判断未计费。

提供请求时间、状态码、请求标识和客户端配置中不含 Key 的部分。支持入口以控制台公开信息为准。我们不需要你在公开群聊发送完整密钥。