先运行此 curl 测试
在修改代码前,先隔离你的应用。此命令向 API 发送最小有效请求:
curl -i https://api.unrestrictedaiapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
GET /v1/models 不花钱,因此是测试密钥的安全方式。-i 标志会打印状态行和头。
- 200 和模型列表: 密钥没问题。你的应用发送了不同的内容,请转到环境变量和 Base URL 部分。
- 401: 密钥或标头错误。请继续下一部分。
- 连接或 DNS 错误: Base URL 错误,这与 401 是不同的问题。
手动将密钥粘贴到此测试中,不要通过变量。这样可以排除环境变量作为嫌疑对象。
原因 1:头不完全正确
API 期望 Authorization: Bearer <key>。微小的偏差都会导致 llm api 401 错误:
Authorization: YOUR_KEY缺少 Bearer 一词。Authorization: Bearer: YOUR_KEY多了一个冒号。Authorization: Bearer "YOUR_KEY"值中包含引号。Authorization: Bearer YOUR_KEY有两个空格。- 名为
X-API-Key或api-key的头,而不是Authorization。这是其他服务的惯例。
如果你使用 OpenAI SDK,则不需要自己编写头。SDK 从 api_key 参数构建它。如果仍然看到 401,则传递给 SDK 的值是问题所在,而不是头格式。
原因 2:密钥本身已损坏
密钥是长随机字符串,因此复制错误很常见且肉眼难以发现。
- 尾部换行符或空格。 从终端或文本文件复制时通常会添加一个。许多 HTTP 库随后会发送无效的头或不匹配的密钥。
- 截断的密钥。 如果密钥包含破坏单词选择的字符,双击只会选择字符串的一部分。改用 API 密钥页面 上的复制按钮。
- 智能引号。 通过文字处理器或聊天应用粘贴可能会将直引号替换为弯引号。
- 旧密钥或已轮换的密钥。 如果你创建了新密钥,旧密钥可能不再是你要使用的密钥。
要检查 Python 中的不可见字符,请打印值的 repr:
import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))
如果第二行打印 False,则密钥周围有空格。读取时调用 .strip()。
原因 3:错误的 Base URL
这是将现有应用切换到新提供商时最常见的错误。你的密钥仅在签发它的宿主上有效。此站点的 Base URL 为:
{"base_url": "https://api.unrestrictedaiapi.com/v1"}
两种失败模式反复出现:
- 你设置了新密钥但保留了旧的 Base URL。请求发送到旧提供商,它拒绝从未见过的密钥并返回 401。错误文本随后提到旧提供商,这是一个有用的线索。
- 你设置了新的 Base URL 但在环境中保留了旧密钥。请求到达我们这里,我们拒绝其他提供商的密钥。
还要检查路径。Base URL 已以 /v1 结尾,因此 SDK 会添加 /chat/completions。如果你手动构建 URL,完整路径是 /v1/chat/completions,而不是 /v1/v1/chat/completions。
原因 4:环境变量和配置文件
如果 curl 能正常工作但你的应用失败,说明应用接收到了你以为之外的其他密钥。
- 变量未导出。在 shell 中,
API_KEY=abc python app.py有效,但单独一行的API_KEY=abc无法传递到子进程。请使用export。 - 被其他值屏蔽。 库可以自动读取
OPENAI_API_KEY。如果旧值在 shell 配置文件中设置,它可能会覆盖你的预期值。 - .env 文件中的引号。 某些加载器将引号保留为值的一部分。如果你的密钥被引号字符包裹,请删除它们或使用上面的 repr 检查进行测试。
- 未重启。 服务器和笔记本在启动时读取环境变量。编辑后请重启。
- 生产环境中的不同配置。容器、CI 和托管仪表板各有自己的变量存储。在日志中打印密钥长度,而非密钥本身。
证明配置的最小 Python 检查
此脚本使用 OpenAI SDK,并在认证失败时清晰报告:
import os
from openai import OpenAI, AuthenticationError
client = OpenAI(
base_url="https://api.unrestrictedaiapi.com/v1",
api_key=os.environ["API_KEY"].strip(),
)
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ok."}],
max_tokens=5,
)
print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
print("401:", e.status_code, e.response.headers.get("X-Request-Id"))
如果输出 X-Request-Id,请在联系 支持团队 时附上该 ID,以便团队定位你的请求。其他语言的相同检查方法见 五种语言的快速入门。
401 与其他错误
如果错误不是认证问题,不要在此浪费时间。以下是一份简要排查指南:
| 状态码 | 通常含义 | 排查位置 |
|---|---|---|
| 401 | 密钥缺失或无效 | Header、密钥、Base URL |
| 429 | 速率限制或临时过载 | 退避并重试;查看文档了解限制详情 |
| 400 | 请求体格式错误 | JSON、模型名称、参数 |
| 404 | 路径错误 | Base URL 和接口 |
同时检查模型名称。精确使用 uncensored;错误的模型 ID 是请求错误,而非 401。API 接受的接口和标头等规范详情,请参阅 OpenAI 兼容 API 规范 页面。
代理、浏览器及最后手段
两种配置会导致看似神秘的 401 错误。
代理和网关
应用与 API 之间的反向代理、API 网关或无服务器包装器可能会丢弃或重写 Authorization 标头。使用 curl 在同一台机器上进行测试并比较。某些框架仅将标头转发到同源主机,因此自定义 fetch 包装器在跨域调用时可能会静默丢失它。
前端代码中的密钥
直接从浏览器 JavaScript 调用 API 会将密钥暴露给任何打开开发者工具的人,并且浏览器也可能因跨域原因阻止请求,这些原因看起来像认证错误。将密钥保留在服务器上,让前端调用你自己的接口,由该接口携带密钥调用 API。如果密钥曾粘贴到公共代码或截图中,请替换它。
仍卡住
如果新复制的密钥在 curl 测试中仍返回 401,请从 API 密钥页面重新生成密钥,直接粘贴到命令中,再试一次。如果失败,向支持团队发送请求时间、接口和 X-Request-Id 响应标头。不要在消息中发送完整密钥;首尾四个字符足以识别它。
