OpenAI 兼容 API,使用 cURL 和 Bearer Token
要从命令行调用 OpenAI 风格 API,你需要发送带有携带 Token 的 Authorization 头的 HTTP POST 请求。本页提供了此 API 所有功能的可用 cURL 命令,以及故障排查检查步骤。
更新于

要点
- Token 放在 Authorization: Bearer YOUR_KEY 头中,模型 ID 为 uncensored。
- 存在两个接口:GET /v1/models 和 POST /v1/chat/completions。
- 添加 -N 和 stream true 以通过服务器发送事件查看 token 到达。
- 使用 curl -i 读取 X-Balance-USD 和速率限制头;429 表示等待并重试。
最小请求
这是在此服务上执行 open ai api curl with token 的最短方式。将密钥放入环境变量中,以免出现在 shell 历史记录中,然后发送聊天消息:
export UF_KEY="paste-your-key-here"
curl https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what a bearer token is in two sentences."}
]
}'
响应是 OpenAI 聊天补全格式的 JSON。答案位于 choices[0].message.content,usage 对象报告提示词和补全 token。命令的每个部分都有特定用途:
Authorization: Bearer ...携带 token。"Bearer" 是认证方案;持有 token 的人被视为其所有者,这就是你要将其移出公共仓库的原因。Content-Type: application/json告诉服务器如何读取请求体。没有它,请求通常会因请求体解析错误而失败。model必须是uncensored,这是该 API 提供的唯一模型。messages是一个对象列表,包含role(system、user、assistant 或 tool)和content。
要获取密钥,请使用 Google 或电子邮件和密码注册,然后访问 API 密钥页面。新用户可以在那里一键领取 $0.50 的试用额度:无需信用卡,有效期 7 天,每人限领一次。
使用 GET /v1/models 检查密钥
在调试长请求之前,先用最便宜的调用确认 token 是否有效。列出模型不花钱,并显示 URL、头和密钥是否都正确。
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY"
良好的响应是一个包含 uncensored 的 JSON 列表。如果你安装了 jq,可以将输出通过管道传递以仅提取 ID:
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'
如果没有返回任何有用的内容,请按顺序排查以下列表,因为原因按发生频率列出:
- 变量为空。运行
echo "${UF_KEY:0:6}"查看前几个字符,而不打印整个密钥。 - 请求头拼写错误,或者密钥前缺少 "Bearer"。
- 文档或聊天客户端中的弯引号替换了命令中的直引号。
- Base URL 错误。它是
https://api.unfilteredaimodels.com/v1,前面有api.,后面有/v1。 - 复制密钥时带有尾随空格或换行符。
读取响应头
添加 -i 以在输出中包含头,或 -D - 以打印头同时保持请求体干净:
curl -s -D - -o /dev/null \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'
有四个值得了解的响应头:
| 头 | 含义 |
|---|---|
X-Request-Id | 此请求的标识符。联系支持时请引用它。 |
X-Balance-USD | 你剩余的预付额度。 |
X-RateLimit-Limit-Requests | 你的密钥每分钟允许的请求数。 |
X-RateLimit-Limit-Concurrency | 你的密钥允许的并发请求数。 |
完整密钥的限制为每分钟 300 个请求和 8 个并发请求,试用密钥为每分钟 60 个和 2 个。上述请求将 max_tokens 设置为 5,以保持测试量小。正常使用中 max_tokens 是可选的,补全可以使用提示词之后 100,000-token 上下文窗口的剩余部分。
从命令行进行流式输出
设置 "stream": true 并添加 -N 以便 curl 不缓冲输出。你将看到以 data: 开头的行,每行携带一个小 JSON delta,以及最终的 data: [DONE]。[DONE] 之前的块包含 token 使用情况。
curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
}'
要仅打印文本,请使用短管道过滤流:
curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
| sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
| jq -rj '.choices[0].delta.content // empty'
echo
流式请求会占用其并发槽位,直到流结束。如果你从脚本中并行启动许多流并忘记让它们完成,即使请求速率较低,你也会达到并发限制。
JSON 模式和工具调用
JSON 模式使模型返回单个有效的 JSON 对象。在提示词中声明你想要的结构,否则键将是模型选择的任意内容。
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
]
}' | jq -r '.choices[0].message.content'
工具调用使用标准的 tools 和 tool_choice 字段。模型以 tool_calls 数组而非文本回答;你自己运行函数,并将结果作为带有 role: "tool" 和匹配的 tool_call_id 的消息发回。
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"tool_choice": "auto",
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
}'
在回复中,查找 choices[0].message.tool_calls[0].function.arguments。这是一个 JSON 字符串,你解析它,调用自己的天气函数,并在下一个请求中返回。参数如 temperature、top_p、stop、seed 和惩罚项会透传。文档列出了所有支持的字段。
保持 token 安全,命令整洁
Bearer token 是一个换了名字的密码。任何拥有它的人都可以花费你的额度,所以要像对待密码一样对待它。切勿将真实密钥粘贴到公共 issue、截图或共享的终端日志中。如果你怀疑密钥泄露,请从密钥页面替换它并更新你的脚本。
Shell 历史记录是个人机器上最常见的泄露源。直接在命令中输入密钥会将其存储在历史记录文件中。使用 export 设置一次仍会存储该行。两个更干净的习惯会有所帮助。从只有你能打开的文件读取密钥,或者如果你的 shell 设置为忽略以空格开头的行,则在命令前加空格。一个小文件效果很好:
mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key
export UF_KEY="$(cat ~/.config/uf/key)"
长 JSON 请求体在单引号内难以阅读,一旦提示词本身包含撇号,引用就会出错。将请求体放入文件中,让 curl 使用 -d @file 读取它:
cat > request.json <<'JSON'
{
"model": "uncensored",
"temperature": 0.3,
"messages": [
{"role": "system", "content": "You answer in plain language."},
{"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
]
}
JSON
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d @request.json | jq -r '.choices[0].message.content'
同样的方法使大型提示词保持在 8 MB 请求体限制内易于管理,并且文件可以在 Git 中进行版本控制,而密钥保持在仓库之外。在 Windows PowerShell 中,JSON 周围的单引号行为不同,且不存在反斜杠续行符;-d @request.json 形式避免了这两个问题,你可以使用行尾的反引号来续行。
测试完成后,转向 SDK。OpenAI Python 和 Node 库接受相同的基础 URL 和密钥,为你处理重试和流式输出,并读取你在此处手动解析的相同响应格式。curl 命令仍然是检查故障是来自你的代码还是请求本身的最快方式,因此请在你的笔记中保留一个已知良好的 curl 命令。当向支持团队报告问题时,包括失败调用的 X-Request-Id 和确切的状态码;这对组合可以让支持人员找到请求,而无需让你重复测试,并节省来回沟通的时间。
错误、重试和每次调用成本
超出限制时,API 返回 HTTP 429。错误代码会告知是哪个限制:rate_limited表示每分钟请求过多,concurrency表示同时请求过多。临时过载也会返回 429 并附加 Retry-After: 5。curl 可以自行重试临时错误:
curl --retry 3 --retry-delay 5 --retry-all-errors \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
还将请求体保持在 8 MB 以下,如果你将编码到提示词中的文件发布,这很重要。
失败或拒绝的请求不收费。成功的请求遵循简单公式:每 1M 输入 token $0.15,每 1M 输出 token $0.50。一次包含 40 个输入 token 和 120 个输出 token 的测试调用成本为 40 / 1,000,000 x $0.15 = $0.000006 加上 120 / 1,000,000 x $0.50 = $0.00006,总计 $0.000066。一千次这样的调用总计 $0.066。
额度是预付的,且永不过期。充值金额从 $20 到 $500 不等,整额充值,从 $50 起有 5% 的奖励,从 $100 起有 10% 的奖励,从 $200 起有 15% 的奖励,支持加密货币(TRC20 上的 USDT,Base 上的 USDC)。定价页面显示了详细信息。如果响应看起来不正确,常见误区和事实页面 解释了模型做什么和不做什么。
更多指南
问答
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。
Token 在 cURL 命令中放在哪里?
- 放在请求头中:-H "Authorization: Bearer YOUR_KEY"。请求体还需要 Content-Type: application/json 头。
我应该使用哪个模型名称?
- 使用 uncensored。你可以通过 GET /v1/models 来确认。
为什么会出现 429 错误?
- 你触发了限制。rate_limited 表示每分钟请求过多,concurrency 表示并发请求过多。等待几秒,或降低并发请求数。
如何查看剩余额度?
- 每条响应均包含 X-Balance-USD 响应头。使用 curl -i 或 curl -D - 打印响应头。
这是官方的 OpenAI API 吗?
- 不是。这是一个独立运行的 OpenAI 兼容服务,仅使用一个开放权重模型,因此只需更改 Base URL 和 API 密钥,专为 OpenAI 格式构建的 SDK 和 curl 命令即可直接使用。