OpenAI API 报 401,为什么 Key 明明填了却不能用?
401 首先表示当前请求没有通过鉴权,不等于模型不可用,也不等于余额耗尽。排查时先确定请求送到了哪个服务,再看这把 Key 是否属于该服务。
按这个顺序检查
- 确认客户端实际请求的 Base URL。OpenAI 官方 Key 不能直接当作本站 Key;本站生成的 Key 也不能直接用于 OpenAI 官方地址。
- 检查请求头是否为
Authorization: Bearer <KEY>,Bearer 后有一个空格;不要把引号、换行或占位符一起提交。 - 确认 Key 没被删除、停用或复制不完整;再核对它所属的项目或本站计费分组。
- 用同一 Key 做一个最小的模型列表请求。如果仍报 401,先解决鉴权,不要通过更换模型掩盖问题。
curl -i https://sub.tidba.com/v1/models \
-H "Authorization: Bearer $TIDBA_API_KEY"
不要把真实 Key、完整请求头或含 Key 的终端截图发到公开渠道。需要平台协助时提供时间、状态码和 Request ID 即可。
401 与其他错误有什么区别?
401 优先排查凭据;403 往往涉及权限或地区限制;404/model_not_found 则先核对模型、项目和接口。不同网关可能使用不同错误正文,应以实际 HTTP 状态和 error.code 为准。
如果你的问题是地址拼错或出现重复的 /v1/v1,阅读 Base URL 与 404 排查。
参考与适用范围
OpenAI 官方文档:Error codes。本文同时说明本站兼容接口的接入方式;本站不是 OpenAI 官方控制台,平台 Key 与官方 Key 分别管理。
仍然无法鉴权?
保留失败时间与 Request ID,再核对 Key 状态。