中文 ▾

5 分钟完成 Open WebUI OpenAI 兼容 API 配置

要使用 open webui openai compatible api 设置,只需添加一个包含基础 URL 和密钥的连接,模型就会出现在选择器中。以下是 Abliterated API 的精确设置,从 Docker 到首次聊天。

已更新

聊天界面通过发光线缆连接到托管 API 服务器,代表 Open WebUI 连接

要点

  • 基础 URL 为 https://api.abliteratedapi.com/v1,模型 ID 为 uncensored。
  • 在管理员连接设置中添加,或向 Docker 传递 OPENAI_API_BASE_URL 和 OPENAI_API_KEY。
  • 先用 curl 测试密钥,以便区分是密钥问题还是 UI 问题。
  • Open WebUI 仅是前端:你按 token 为模型读取和写入的内容付费,开始使用无需银行卡。

简短说明

如果要用一段话概括 open webui openai compatible api 设置:打开管理员设置,添加一个 OpenAI API 连接,将 URL 设置为 https://api.abliteratedapi.com/v1,粘贴你的密钥,保存,然后选择名为 uncensored 的模型。就是这样。Open WebUI 可以连接任何实现 OpenAI 聊天补全格式的 API,本 API 即为此类。

该服务是一个托管的、OpenAI 兼容的文本 API,运行一个开放权重模型,针对合法成人用途进行了优化,可在无内容审查的情况下回答。由独立提供商运营,并非任何模型实验室的官方 API。Open WebUI 只是你指向它的聊天前端。

开始之前

  • API 密钥。 在 API 密钥页面 创建一个。支持 Google 或邮箱加密码注册。新用户可在该页面一键领取 $0.50 试用额度,有效期 7 天,无需绑定银行卡。
  • 一个正在运行的 Open WebUI。 Docker 安装或 pip 安装均可。以下步骤涵盖 Docker 和设置界面。
  • 网络访问权限 从运行 Open WebUI 的机器到 api.abliteratedapi.com 的 HTTPS 连接。

在操作 UI 之前先检查密钥。如果此调用返回包含 uncensored 的列表,则密钥和 URL 有效:

curl https://api.abliteratedapi.com/v1/models   -H "Authorization: Bearer $ABLITERATED_API_KEY"

然后确认一次真实的文本补全可以正常工作:

curl https://api.abliteratedapi.com/v1/chat/completions   -H "Authorization: Bearer $ABLITERATED_API_KEY"   -H "Content-Type: application/json"   -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

方法 1:在设置中添加连接

这是最简单的路径,适用于现有安装。菜单标签在不同 Open WebUI 版本中会有所变化,因此以下名称可能略有不同。

  1. 以管理员身份登录 Open WebUI,打开 管理面板,然后进入 设置,再进入 连接。
  2. 找到 OpenAI API 部分,并使用加号按钮添加新连接。
  3. 在 URL 字段中输入 https://api.abliteratedapi.com/v1。停在 /v1 即可。不要添加 /chat/completions;Open WebUI 会自动追加该路径。
  4. 将你的密钥粘贴到密钥字段中。它将以 Authorization: Bearer <key> 的形式发送。
  5. 如果你的版本有验证按钮,请使用它,然后保存。

打开新聊天并打开模型选择器。模型 uncensored 应该出现在列表中,因为 Open WebUI 从 GET /v1/models 读取它。如果列表为空,请转到下面的故障排除部分。

方法 2:在启动时通过 Docker 设置

对于全新安装,将接口作为环境变量传递。Open WebUI 在启动时读取 OPENAI_API_BASE_URL 和 OPENAI_API_KEY。

# base URL: https://api.abliteratedapi.com/v1   model to pick in the UI: uncensored
docker run -d -p 3000:8080   -e OPENAI_API_BASE_URL="https://api.abliteratedapi.com/v1"   -e OPENAI_API_KEY="$ABLITERATED_API_KEY"   -v open-webui:/app/backend/data   --name open-webui --restart always   ghcr.io/open-webui/open-webui:main

然后访问 http://localhost:3000,创建第一个账户(将成为管理员)并开始聊天。命名卷会在更新容器时保留你的聊天记录和设置。

有一点容易让人困惑:许多 Open WebUI 设置会在首次启动后保存到其数据库中,且保存的值可能会覆盖后续的环境变量。如果你在 Docker 中更改了密钥或 URL 但没反应,请在连接屏幕中更改,或重置保存的设置。

值得调整的设置

聊天功能正常后,以下选项可提升体验并让费用更可控。

合理使用上下文窗口

上下文窗口为 100,000 token,提示词和回复共享此窗口。Open WebUI 会在每条消息中重新发送聊天记录,因此对话越长,每轮成本越高。输入 token 价格为每 1M token $0.15,20,000 token 的历史记录发送成本为 $0.003,虽然便宜,但在数千条消息后会累积。针对新话题请开启新对话。

流式输出和采样

Open WebUI 默认流式输出回复,API 支持通过 SSE 进行流式输出。在高级参数中,你可以设置 temperature、top_p、停止序列、用于可重复输出的 seed 以及惩罚。这些参数会传递给模型。除非你想要硬限制,否则将 max_tokens 留空,因为它是可选的。

后台任务

Open WebUI 可以在后台进行额外的模型调用,例如为聊天命名。每次调用都会消耗你的余额并计入限制。如果你注意到未输入内容的调用,请查看任务模型设置,将其指向你愿意付费的模型,或关闭辅助功能。

预设和系统提示词

Open WebUI 允许你在工作区部分保存模型预设:名称、基础模型、系统提示词和默认参数。为 uncensored 创建预设,用于你经常执行的任务,如编辑助手、代码审查员或互动小说会话的角色。简短的系统提示说明角色、语气和回复格式,比粘贴到每个聊天中的长指令更有效。

这正是模型配置发挥作用的地方。这是一个开放权重模型,经过调优以在无内容审查的情况下回答,适用于合法成人用途,适合小说、角色扮演和成人伴侣类应用,因为在场景中间出现拒绝会打断体验。它不会改变硬性限制:绝不包含涉及未成年人的色情内容。请确保你的预设和共享实例符合该规则以及你所在地区的法律。

如果其他人使用你的 Open WebUI 实例,请记住他们共享你的密钥及其限制。一个完整的密钥允许 8 个并发请求,因此少量活跃用户没问题,但大量用户同时聊天可能会触及上限。为每个人或团队提供自己的密钥可以分散负载并使余额更易于跟踪。

运行成本

你仅按 token 付费,从预付额度中扣除:每 1M 输入 token $0.15,每 1M 输出 token $0.50。失败或被拒绝的请求不收费,且额度永不失效。典型聊天消息包含 3,000 token 的历史记录和 400 token 的回复,成本为 $0.00045 + $0.0002 = $0.00065,因此 $10 的使用量约为 15,000 条消息。

充值金额从 $20 到 $500 不等,任意整数金额均可,$50 起 +5%,$100 起 +10%,$200 起 +15%。支持加密货币(TRC20 上的 USDT,Base 上的 USDC)支付。详见 定价页面。剩余余额会在每个 API 响应的 X-Balance-USD 标头中返回,以便你通过脚本监控。

故障排除

症状可能原因修复方法
模型列表为空URL 或密钥错误运行 /v1/models 的 curl 测试。URL 必须以 /v1 结尾。
Docker 连接被拒绝或超时容器没有出站 HTTPS 访问权限检查主机上的 DNS、代理和防火墙设置。
每条消息都出现认证错误密钥粘贴时包含空格,或为旧密钥请从密钥页面重新复制密钥并再次保存。
多人同时聊天时出错速率限制完整密钥允许 8 个并发请求和每分钟 300 个请求;试用密钥允许 2 个和 60 个。
长对话停止工作上下文窗口已满上下文窗口为 100,000 token。请开始新对话或进行总结。

如果 curl 测试通过但 Open WebUI 失败,问题出在前端设置。如果 curl 失败,请先检查密钥和余额。快速入门文档列出了所有请求参数,无审查聊天 API 是什么以及不是什么一文解释了模型的范围,包括硬性限制:禁止涉及未成年人的色情内容。

问答

我在 Open WebUI 中输入什么 URL?

使用 https://api.abliteratedapi.com/v1,后面不要加任何内容。Open WebUI 会自动添加 /chat/completions 和 /models。

我应该选择哪个模型名称?

模型 ID 为 uncensored。连接保存且模型列表加载后,它会出现在模型选择器中。

试用需要银行卡吗?

不需要。新用户注册后,可在 API 密钥页面一键领取 $0.50 试用额度。该额度有效期 7 天,无需绑定银行卡。

我可以将其与本地模型一起运行吗?

可以。Open WebUI 支持同时连接多个服务,因此该接口可以与本地模型并存,并在同一个模型选择器中显示。

我的聊天记录会被用于训练吗?

不会。发送给 API 的提示词不会用于训练。Open WebUI 存储的聊天记录保留在你自己的安装实例中。

只差一张表单,即可获得密钥

创建账户,复制密钥,更改基础 URL。这就是全部设置。

获取 API 密钥