Open WebUI 接入 Models Hub:管理面板配置 OpenAI 连接
在自部署的 Open WebUI 里通过 Settings → Admin → Connections 添加 Models Hub 作为 OpenAI 兼容连接,填入 URL 与 API Key,附验证步骤与常见报错排查。
Open WebUI 是一款可自部署的开源 Web 聊天界面,常见于个人或团队自建的模型入口。它支持在管理面板里添加多个 OpenAI 兼容连接,把其中一个指向 Models Hub 后,所有用户在这个 Open WebUI 实例里发起的对话都会用 Models Hub 的额度。本文只讲接入,不讲 Open WebUI 本身的部署。
三样东西
接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com/v1、一个模型名。管理员在 Admin 面板里配置一次,全部用户即可使用。
准备
推荐模型
| 用途 | 模型名 | 定价 | 实时状态 |
|---|---|---|---|
| 日常对话首选 | claude-sonnet-4-6 | 查看价格 | 可用率与延迟 |
| 复杂推理与长文写作 | gpt-5.5 | 查看价格 | 可用率与延迟 |
| 便宜快速,适合高频简单问答 | gpt-5.4-mini | 查看价格 | 可用率与延迟 |
模型名以 模型定价页 为准。
配置步骤
-
用管理员账号登录 Open WebUI,进入 Settings → Admin → Connections。
-
在 "Manage OpenAI API Connections" 区域点 ➕ Add Connection。
-
URL 填:
https://modelsok.com/v1Open WebUI 官方示例地址都带
/v1,这里必须带上。 -
API Key 粘贴你的 Models Hub Key,保存连接。
-
如果模型列表没有自动拉取到你要的模型,在同一个连接的 "Model IDs (Filter)" 里手动填入模型名(如
claude-sonnet-4-6),保存后回到对话页选择该模型。
验证
回到对话页,选中刚添加的模型,发一句「用一句话介绍你自己」,能正常回复即接通。再打开 Models Hub 控制台的 用量日志,几秒内会出现一条对应模型名的请求,确认走的是 Models Hub。
常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
401 / Unauthorized | Key 复制不完整、多了空格,或令牌已被禁用 | 到 令牌页 重新复制 |
| 保存连接后模型列表拉取失败 | URL 漏了 /v1,或网络无法访问该地址 | 确认填的是 https://modelsok.com/v1;拉取失败也可以直接用 "Model IDs (Filter)" 手动指定模型 |
| 对话页找不到新增的模型 | Model IDs (Filter) 没填,或没有刷新页面 | 手动填入模型名并保存,刷新对话页重新选择 |
| 改完配置后界面卡死打不开 | 地址或格式填错导致启动异常 | 用环境变量 RESET_CONFIG_ON_START=true 重启一次可恢复到默认配置,再重新填 |
| 用量日志里没有记录 | 对话选的不是这个连接下的模型 | 检查对话右上角当前选中的模型来源 |
更多排查见 故障排查。
常见问题
计费方式? 按每次对话实际消耗的输入与输出 token 计费,价格看各模型定价页,用量日志里能看到每条请求的明细。
和直接用官方 API 有什么区别? 请求格式一致,只是接入地址换成了 Models Hub,团队内所有 Open WebUI 用户共用一个 Key 与额度。
改了 OPENAI_API_BASE_URL 环境变量,为什么没生效? Open WebUI 里 管理面板 Connections 里配置的连接会存进数据库,优先级高于环境变量。如果两处都配了,以 Admin 面板里的为准;想用环境变量的默认值,先在 Connections 里删掉对应连接。