Open WebUI API 设置

Open WebUI 按协议管理模型服务，而不是为每家厂商安装单独插件。TokenHub 应作为一条 OpenAI API Connection 添加，由 Open WebUI 在 API 根地址后调用 /models 与 /chat/completions。

在 Admin Connections 添加 TokenHub

以下顺序对应 Open WebUI 官方 Step 1: Add Your Provider Connection：

1. 用管理员账号打开 Open WebUI。
2. 进入 Settings → Admin → Connections。
3. 找到 Manage OpenAI API Connections，点击 Add Connection（加号）。
4. URL 填 https://us-api.tokenhub.com/v1。
5. API Key 填 TokenHub API Key。
6. 如果连接校验没有返回模型，在同一表单的 Model IDs (Filter) 中输入准确的 TokenHub Model ID，并点击加号加入 allowlist。
7. 点击 Save。

不要在 URL 中填写 /chat/completions。Open WebUI 会自行拼接请求路径；填完整请求地址会造成重复路径。

理解 Verify Connection 与 Model IDs (Filter)

保存前，Open WebUI 会用标准 Bearer Token 请求 Provider 的 /models。官方特别说明：某些兼容服务可能在这个探测请求上返回 400、401 或 403，但聊天接口仍然可用。因此应按下面的顺序判断：

1. 在 Model IDs (Filter) 手动加入模型 ID并保存。
2. 回到新对话，确认模型出现在选择器中。
3. 选中模型并点击发送，用真实 Chat Completions 请求验证。

同一个 Model ID 只需加入一次，输入两端的空格会被清理。连接右侧的开关可以暂时停用 Provider，而无需删除配置。

Docker 部署时不要照搬 host.docker.internal

官方的 host.docker.internal 提示只适用于“Open WebUI 容器访问宿主机上的本地模型服务”。TokenHub 是远程 HTTPS 服务，URL 仍应填写 https://us-api.tokenhub.com/v1。如果容器请求超时，应检查容器 DNS、HTTPS 出站访问和代理配置，而不是改成 localhost。

按 Open WebUI 的实际请求验证

1. 新建一个 Chat，选择刚加入 allowlist 的 TokenHub 模型。
2. 先发送一条纯文本短消息。
3. 在 TokenHub 请求日志中确认路径为 /v1/chat/completions、Model ID 正确且已产生用量。
4. 基础聊天成功后，再分别开启工具、图片或知识库功能；Open WebUI 能显示这些功能，不代表所选模型或兼容端点一定支持。

若出现 404，先检查 URL 是否只到 /v1；模型未显示则回到 Model IDs (Filter)；只有容器内失败时再检查 Docker 网络。

官方资料

• Open WebUI：连接 OpenAI-compatible Provider