Open WebUI 怎么接 API？Docker 地址、模型可见性与聊天检查
Open WebUI 接 API，先确认请求由服务器还是浏览器发出，再配置对应连接，最后检查模型权限与实际聊天。电脑能访问接口，不代表 Docker 容器能访问；管理员能用，也不代表普通用户能用。本文按 2026-10-25 当前官方文档整理，未安装或联调云岚API，菜单与选项请同时核对自己的版本。
请求从哪里发出，决定到哪里排错
| 连接方式 | 推理请求路径 | 首先检查 |
|---|---|---|
| 管理员配置的常规连接 | 浏览器 → Open WebUI 后端 → 提供方 | 后端所在服务器或容器的网络 |
| Direct Connections | 浏览器 → 提供方 | 用户电脑网络、来源许可与浏览器错误 |
Direct Connections 当前标为实验功能，需要管理员启用，再由用户在个人连接设置中配置。Key 保存在浏览器本地存储，上游须允许相应跨源请求；它不是隐藏共享 Key 的方式。而且标题、标签等后台步骤仍可能由服务器处理，不能理解为整个会话都绕过后端。官方 Direct Connections 说明
若准备给团队共用一个服务端连接，从管理员设置开始；遇到浏览器直连的跨源错误，再看 CORS 排查，不要用修改上游 Key 代替确认请求路径。
Docker 里的 localhost，到底指谁？
普通容器网络中，localhost 指容器自身。模型服务在宿主机上，容器内访问同一个 localhost 并不会自动到宿主机；浏览器的 localhost 又指运行浏览器的电脑。官方请求来源对照
| 提供方位置 | 地址核对方向 |
|---|---|
| 公网 API | 从 Open WebUI 后端确认该公网域名的 DNS、TLS 与出站连接 |
| 同一宿主机上的服务 | 检查 host.docker.internal 是否在当前容器可解析、端口是否可达 |
| 同一容器网络里的其他服务 | 检查服务名、容器内部端口和共享网络，而非照搬宿主机映射端口 |
Docker Desktop 自动解析 host.docker.internal；其他 Docker 环境可按官方说明配置主机映射，例如参数 --add-host=host.docker.internal:host-gateway。这只是地址映射，不会自动修复服务监听地址、防火墙或 API 鉴权。Docker 主机映射说明
先记录从哪台机器检查、解析到哪里、失败发生在连接还是 HTTP 响应阶段。不要为试地址反复重建容器或删除数据卷；界面已经能打开，也只证明浏览器到 WebUI 这一段可用。
配好连接后，分别看验证与模型列表
当前入口为 Settings → Admin → Connections → Manage OpenAI API Connections。添加一条连接，填写提供方确认的 URL、API Key，保存并确认启用；这和个人设置不是同一范围。管理员与个人设置
以云岚API为配置示意，URL 填基础前缀 https://v2.cloudmist.cloud/v1，不在这里追加 /chat/completions。这是按兼容指南填写前缀的示意，未验证该客户端联调；Key 与模型 ID 仍以自己的控制台为准。
按当前兼容指南，Save 不执行测试；URL 旁的 Verify Connection 请求提供方 /models。因此验证失败可能是列表端点缺失或认证方式不合，也可能是真实连接或凭据错误，必须看具体响应，不能一概认定聊天可用或不可用。官方连接步骤与验证范围
已确认聊天协议与准确模型 ID、只是服务不提供自动发现时，可在连接的 Model IDs 中手动添加。这里也会限定显示的模型；拼错 ID 或漏加目标项，都可能影响列表。手工出现一个名称，不会授予上游调用权限。基础路径和完整接口的区别交给 Base URL 教程处理。
模型有了，为什么同事仍然看不到？
按顺序检查连接启用状态、Model IDs、模型启用/隐藏状态，以及目标用户或用户组的访问授权。Selected/Pinned 影响默认选择或快捷入口，不等同于访问限制。模型管理与选择规则
Workspace 模型是基于基础模型的配置预设，不是另一份独立模型。当前规则要求用户同时有权访问预设与它的基础模型；只共享预设，仍可能得到 Model not found。让维护者核对两层授权，不要靠把所有模型改成公开来试错。模型访问条件
Open WebUI 内部权限也不会代替供应商 Key 的模型权限与额度，两边分别核对。RBAC 与提供方凭据范围
用目标用户完成一条短聊天
用预期实际使用的账号新建聊天，明确选中目标模型。先不用工具、附件或知识库，发送一个可判断的小任务，例如“将‘明天下午三点开会’改成礼貌提醒，保留时间，只写一句话”。这是待执行的合成测试，不是调用成绩。
记录所选连接、模型 ID、账号角色、时间、完整回复或错误，再核对对应后端/提供方记录。管理员测试和普通用户测试分开；聊天出现首段文字，还需确认结束和内容完整，见输出不完整排查。
下载 Open WebUI 连接检查包，按网络、列表、权限和聊天四层填写，未知项留待验证。已有云岚API账号可在控制台核对端点、模型与额度；首次接入先看新手教程。本页不承诺任意模型或高级功能均兼容。
常见问题
浏览器打开 API 地址正常，为什么容器还超时？
两者使用的 DNS、代理和网络出口可能不同。以实际发请求的后端环境为准；能打开一个网页，也不能代替对应模型接口的认证和响应检查。
手动填了 Model IDs，就能绕过模型权限吗？
不能。它用于模型列表配置；Open WebUI 的访问控制和供应商权限仍然生效。看到模型、能选择模型和聊天完成，应分别记录。
切到 Direct Connections 就能解决所有连接问题吗？
不能。它把推理请求移到浏览器，带来另一套网络与 CORS 条件，还改变 Key 的存放位置。先定位原链路失败点，再决定是否需要这种连接方式。