错误码说明

不同客户端展示的报错文案可能不一致，但大多数问题都可以按下面顺序排查。

401 Unauthorized

• API Key 填错。
• Key 已禁用，或余额、额度已耗尽。
• 请求头没有使用 Authorization: Bearer sk-... 格式。

404 Not Found

• Base URL 漏了 /v1。
• 接口路径写错，例如把 /chat/completions 拼错。
• 客户端把地址拼成了错误路径。

模型不存在

• 模型名称拼写错误。
• 当前账号没有该模型权限。
• 控制台渠道暂未启用该模型。

请求超时

• 网络连接不稳定。
• 当前模型响应较慢。
• 客户端超时时间设置过短。

排查建议

1. 先用 curl 调用 /v1/chat/completions 验证地址和 Key。
2. 再用同一个 Key 配置客户端。
3. 到控制台日志查看请求是否已经到达。
4. 如果日志里没有请求，优先检查客户端地址、代理和本地网络。