先检查这几项
- 打开 Settings → Admin → Connections，添加 OpenAI 兼容连接并保存 Base URL 和 Key。
- 刷新列表。若明确选择手动 Model IDs，填写平台真实 ID；手动列表不能证明模型可调用。
- 后端部署在 Docker 时，从容器所在网络检查连通性；如果是 Direct Connections，则检查浏览器网络与 CORS。
正在打开页面…
正在加载内容，请稍候。
常见错误与配置项
模型不显示、Docker 连接失败与用户权限Open WebUI 模型不显示Open WebUI Docker 中模型连接失败怎么查？
按失败位置逐项排查
先检查这几项
本站绘制的内容说明图：本页工具汇总中的地址、模式与易错字段；是技术说明图，不是厂商 UI 或已完成的模型请求。 若采用官方面板图，截图中的 MiniMax-M2.1 为旧演示；自己的准确型号与 Key 按本文配置，不表示 M3 接入完成。
常见错误与配置项
本站绘制的内容说明图：各分支对应本页实际错误入口；按错误正文继续进入详情，不能用其中一项通过代替整个客户端验收。
先检查这几项
本页说明 Admin Connections 的 URL、认证与 Model IDs，官方面板与这些字段直接对应；图中 MiniMax-M2.1 仅是旧官方演示。
报错检查与修复步骤
Open WebUI 模型不显示：连接、Docker 与用户权限
Open WebUI 模型不显示先确认使用管理员 Connections 还是浏览器 Direct Connections，再检查对应运行环境的地址与 Key。列表发现、手动 Model IDs、用户可见权限和真实聊天分开验证，容器网络不能由本机浏览器测试代替。
查看报错修复快速判断
- 管理员能用而普通用户看不到时，核对模型可见性和用户组权限。
- 聊天成功但标题生成或 RAG 失败时，分别检查任务模型与 embedding 配置，不能用聊天模型配置代替全部功能。
Open WebUI 报错怎么转成可用配置
不要只看错误码本身。先确认请求是否进入 apizt 后台，再按 API Key、Base URL、模型名、provider 类型排查。 这几个页面分别覆盖认证失败、连接失败、模型不存在、限流和工具配置覆盖问题。