中文 ▾
获取 API 密钥

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'

如果没有返回任何有用的内容,请按顺序排查以下列表,因为原因按发生频率列出:

  1. 变量为空。运行 echo "${UF_KEY:0:6}" 查看前几个字符,而不打印整个密钥。
  2. 请求头拼写错误,或者密钥前缺少 "Bearer"。
  3. 文档或聊天客户端中的弯引号替换了命令中的直引号。
  4. Base URL 错误。它是 https://api.unfilteredaimodels.com/v1,前面有 api.,后面有 /v1。
  5. 复制密钥时带有尾随空格或换行符。

读取响应头

添加 -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 命令即可直接使用。