Open WebUI API 接口：连接无审查 LLM

你需要的值

Open WebUI 只需要此服务的三个要素。第一个是 Base URL，https://api.dolphinllm.com/v1。第二个是你账户中的 API 密钥。第三个是模型 ID，uncensored，一旦连接生效，Open WebUI 会自动从模型列表中读取该 ID。

涉及两个接口。GET /v1/models 填充模型下拉菜单，POST /v1/chat/completions 承载你发送的所有消息。聊天不需要其他内容。这是一个文本 API，因此 Open WebUI 的图片、音频和嵌入功能在此无数据可交互。

你不需要信用卡即可试用。注册后，你可以在密钥页面一键领取 $0.50 的试用额度。有效期为 7 天。

在管理面板中添加连接

如果 Open WebUI 已在运行，这是最快的路径。

1. 以管理员身份登录并打开 管理设置，然后进入 连接。
2. 在 OpenAI API 部分，点击加号按钮添加连接。
3. 将 https://api.dolphinllm.com/v1 粘贴为 URL，并将你的密钥粘贴到密钥字段。
4. 使用字段旁边的验证按钮。绿色确认意味着模型列表已返回。
5. 保存，打开新聊天，并从模型选择器中选择 uncensored。

Open WebUI 不同版本中的菜单名称略有不同。如果找不到“连接”，请在设置中搜索“OpenAI”。字段始终相同：URL、密钥和有时是模型过滤器。

使用 Docker 环境变量进行设置

对于全新安装，你可以跳过管理界面，在容器启动时传递连接。Open WebUI 在启动时读取 OPENAI_API_BASE_URL 和 OPENAI_API_KEY。

Copydocker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL="https://api.dolphinllm.com/v1" \
  -e OPENAI_API_KEY="YOUR_KEY" \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

然后访问 http://localhost:3000，创建第一个账户（该账户将成为管理员），模型列表应已显示。如果机器是共享的，请将密钥保留在 shell 历史记录之外：将其放入 env 文件并使用 --env-file。

某些 Open WebUI 版本将这些变量仅视为初始值。一旦你在 UI 中保存了连接，存储的值将生效。如果你修改变量但无变化，请在管理设置中编辑连接。

为多用户运行

Open WebUI 拥有自己的用户账户，因此一次安装即可服务于一个家庭或小型团队，而服务器上只需一个 API 密钥。这很方便，但也存在风险：所有用户都从同一余额中消费。确定谁拥有账户，并时不时查看 X-Balance-USD，以免长假角色扮演导致余额意外耗尽。

将密钥保留在环境变量或密钥文件中，不要放在截图或共享文档中。你的密钥位于 API 密钥页面；如果你怀疑密钥泄露，一旦获得新密钥，请立即在 Open WebUI 中替换它。对于面向公众的安装，请将其置于 HTTPS 之后，并关闭开放注册，以防止陌生人创建账户并使用你的额度。

共享设置的另一个要点：该模型经过调整，可在合法成人使用中无内容拒绝地回答。这是用于小说和私人研究的功能，这也意味着你决定内部规则。在共享模型上设置系统提示词是编写规则的最简单方法。无论提示词如何，API 上不允许涉及未成年人的性行为。

此设置的良好用途

将 Open WebUI 连接到无审查接口的用户通常希望拥有一个没有托管聊天机器人限制的干净聊天窗口。常见用途包括长篇小说和世界构建、成人角色扮演和伴侣角色、起草主流助手拒绝处理的材料，以及普通的编码或写作帮助。同一模型可处理所有这些任务，因此你可以在一个聊天中切换任务。

Open WebUI 在几个特定方面提供帮助。保存的提示词和模型预设让你可以一键即可访问角色或编辑者人格。文档上传和网页搜索功能（启用时）会将额外文本发送到提示词中，从而增加 token 使用量，因此请留意附件的大小。聊天文件夹和搜索功能让你可以轻松返回到长期项目。

它无法通过此连接生成图片、语音或视频，因为 API 仅支持文本。

在归咎于 Open WebUI 之前测试接口

大多数设置失败源于 URL 中的拼写错误或过期的密钥，这两者在终端中会更快显现。从托管 Open WebUI 的机器上运行以下两个调用。

Copycurl https://api.dolphinllm.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

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

第一次调用应列出 uncensored。第二次调用应返回正常的聊天完成结果。检查响应头：X-Balance-USD 显示账户剩余余额，这是确认 Open WebUI 是否使用你预期的密钥消费额度的便捷方式。

完整参数列表位于 API 文档 中。

值得更改的聊天设置

系统提示词和采样

Open WebUI 允许你为每个模型或每个聊天设置系统提示词。由于该模型经过调整，可在合法成人使用中无内容拒绝地回答，因此简短的系统提示词（用于固定语气、人格或输出格式）比长规则列表更有效。Temperature、top_p、stop、seed 和惩罚参数会被透传，因此 Open WebUI 中的滑块确实有效。

上下文长度

上下文窗口为 100,000 token，包括提示词和补全。长聊天会在每次交互中增加提示词，并且每次都要为整个历史记录付费。如果线程变得沉重，请开始新聊天或总结旧聊天。

后台请求

Open WebUI 可以在后台发送额外调用来生成聊天标题和标签，默认使用同一模型。对于试用密钥（允许 2 个并发请求和每分钟 60 个请求），这些调用可能会挤占你的实际消息。关闭标题和标签生成，或者接受短暂延迟。完整密钥允许 8 个并发请求和每分钟 300 个请求，这对于个人或小型团队安装来说已经足够。

流式输出、JSON 模式和工具

Open WebUI 默认流式输出回复，API 支持服务器发送事件（stream: true），并在流末尾包含用量块。你会看到文本逐 token 出现，最终响应中的余额头反映你花费的金额。

API 也支持函数调用：tools、tool_choice、流式输出的 tool_calls，以及以 role: "tool" 形式返回的结果。Open WebUI 暴露这些功能的程度取决于其版本以及你安装的工具或函数，因此在围绕其构建工作流之前，请先用一个小工具进行测试。JSON 模式（response_format 设置为 json_object）在从聊天界面旁边的脚本调用同一接口时非常有用。

一种实用模式是：为人员保留 Open WebUI，并使用同一密钥从脚本进行批量工作。两者都通过相同的 Base URL，因此一个余额覆盖所有内容。请记住，限制条件适用于每个密钥：完整密钥允许 8 个并发请求，在 UI 和你的脚本之间共享。

常见错误及修复

• 未显示任何模型。 URL 可能缺少 /v1 或有拼写错误。将其与上面的值逐字符比较，并删除任何尾部斜杠。
• 身份验证错误。 密钥粘贴时带有前导或尾随空格，或者它属于已删除的账户。请从密钥页面再次复制。
• 模型选择器显示错误的列表。 Open WebUI 还会查询你添加的其他连接，例如本地 Ollama。禁用你未使用的连接。
• 回复在流式传输过程中停止出现。 Open WebUI 前面的反向代理可能会缓冲服务器发送的事件。请关闭该路由的缓冲。
• 余额不足。 在余额归零前充值。失败或被拒绝的请求不会收费，因此你只为已交付的补全付费。

在此 API 上运行聊天 UI 的成本

价格为每 1M 输入 token $0.15，每 1M 输出 token $0.50，从预付额度中扣除。考虑长聊天中的一轮典型交互：输入 4,000 token 的历史记录，输出 500 token。输入成本为 4,000 x $0.15 / 1,000,000 = $0.0006。输出成本为 500 x $0.50 / 1,000,000 = $0.00025。该轮交互成本为 $0.00085。

按该速率，$0.50 的试用额度可覆盖约 588 轮对话，$20 的充值可覆盖约 23,500 轮。请参阅 定价页面 了解充值奖励。如果你想在 Open WebUI 之外使用同一密钥，例如在不需要登录界面的脚本中，请参阅 无登录限制使用 LLM 页面了解相关内容。

更多指南

• 面向开发者的免费 LLM API：试用与按量付费
• 如何无登录限制地使用 LLM