错误码说明

不同客户端展示的错误文案可能不同，但通常可以按下面顺序排查。

401 Unauthorized

常见原因：

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

404 Not Found

常见原因：

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

模型不存在

常见原因：

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

请求超时

常见原因：

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

排查建议

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