模型不可用时怎么排查

第一步：缩小请求

移除复杂 prompt、长上下文、图片和工具调用，只保留一句“回复 ok”。最小请求能通，问题通常位于请求体或客户端设置。

第二步：核对账号

• API Key 是否完整。
• 令牌是否已删除或达到额度限制。
• 账户余额是否足够。
• 模型名是否与控制台完全一致。

第三步：更换客户端

使用同一令牌、同一模型，在 PowerShell 或另一个客户端中测试。其他工具正常时，优先检查原客户端的 Base URL、接口模式和模型字段。

第四步：更换模型

同一令牌换另一个可见模型进行测试。其他模型正常时，目标模型可能暂不可用，或当前分组不支持该模型。

错误类型

状态或错误	常见原因
401	鉴权失败或令牌无效
403	权限或规则限制
429	频率、并发或额度限制
5xx	服务端暂时异常
upstream error	服务线路连接或返回异常

反馈信息

持续失败时保存请求时间、模型名、分组、错误全文和请求 ID。不要发送完整 API Key。