如果你已经部署了 Open WebUI，却不想只连接本地 Ollama，最常见的下一步就是接入一个 OpenAI Compatible API。这样做的好处是：Open WebUI 继续作为团队聊天界面，模型能力则通过统一的 API 入口扩展到 GPT、Claude、Gemini、DeepSeek 等多种模型。
这篇文章以 DeepAI API 中转站 为例，讲清楚 Open WebUI 里应该怎么填写 Connections、Base URL、API Key 和模型过滤项，也顺手整理 401、404、模型不显示、流式输出失败等常见问题。
> DeepAI Base URL：https://api.deepai.wang/v1
适合谁看
这篇文章适合以下用户：
- 已经部署 Open WebUI，希望接入云端大模型；
- 想把 Open WebUI、Cherry Studio、Dify、Cline 等工具统一到同一个 API 中转入口；
- 不想在每个客户端里分别管理不同厂商的 Key；
- 遇到 Open WebUI 模型不显示、401、404、stream 报错，不知道该查哪里。
如果你只是想快速验证 DeepAI API Key 是否可用，也可以先看站内这篇：
从 curl 到 Python：如何确认 DeepAI OpenAI 兼容接口真的能用
Open WebUI 和 DeepAI API 中转站是什么关系
Open WebUI 是一个 Web 端聊天界面，它本身不是模型供应商。它负责用户界面、对话历史、知识库、权限、团队协作等功能。
DeepAI API 中转站提供的是 OpenAI-compatible 风格的模型 API 入口。你可以把它理解成一个统一的模型网关：
- Open WebUI 负责“聊天界面”；
- DeepAI API 中转站负责“模型 API 入口”；
- 具体模型由 DeepAI 后台可用模型决定；
- Base URL、API Key、Model ID 是连接两者的关键参数。
所以，Open WebUI 接入 DeepAI 的核心就是一句话：在 Open WebUI 的 Connections 里新增一个 OpenAI-compatible 连接，把 Base URL 填成 DeepAI 的地址，把 Key 填成 DeepAI API Key。
准备工作
开始前你需要准备：
- 一个可以访问的 Open WebUI 实例；
- Open WebUI 管理员权限，至少要能进入 Settings / Admin Settings；
- DeepAI API Key；
- 至少一个可用的模型 ID；
- 网络环境可以访问
https://api.deepai.wang/v1。
建议先在本地用 curl 测一次，确认 Key 和模型 ID 没问题：
curl https://api.deepai.wang/v1/chat/completions \
-H "Authorization: Bearer sk-你的DeepAIKey" \
-H "Content-Type: application/json" \
-d '{
"model": "你的模型ID",
"messages": [
{"role": "user", "content": "hello"}
]
}'如果 curl 都不通，先不要急着改 Open WebUI。先排查 Key、模型 ID、余额、网络和 Base URL。
第一步：进入 Open WebUI 的 Connections 设置
不同版本的 Open WebUI 界面略有差异，但大致路径类似：
1. 登录 Open WebUI； 2. 点击左下角头像或设置入口； 3. 进入 Settings 或 Admin Settings； 4. 找到 Connections； 5. 找到 OpenAI API 或 OpenAI-compatible API 配置区域。
如果你看不到 Connections，常见原因有三个：
- 当前账号不是管理员；
- Open WebUI 版本较旧，设置入口位置不同；
- 部署时关闭了相关功能或权限。
这一步不是 DeepAI API 的问题，属于 Open WebUI 本身的管理权限和版本问题。
第二步：填写 DeepAI Base URL
在 Open WebUI 的 OpenAI API 连接配置里，Base URL / API Base URL 填：
https://api.deepai.wang/v1注意几个容易填错的点：
| 配置项 | 推荐填写 |
|---|---|
| Base URL | https://api.deepai.wang/v1 |
| API Key | DeepAI API Key |
| Chat Endpoint | 通常不用单独填，Open WebUI 会拼接 |
| Model ID | 使用 DeepAI 后台可用模型 ID |
不要把 Base URL 写成：
https://api.deepai.wang/v1/chat/completions很多客户端要求填的是 Base URL，而不是完整接口路径。Open WebUI 会根据请求类型自己拼接 /chat/completions 等路径。如果你把完整路径填进去，最终可能变成重复路径，导致 404 或请求失败。
第三步：填写 API Key
API Key 一般填 DeepAI 生成的 Key，例如：
sk-xxxxxxxxxxxxxxxx实际填写时不要带 Bearer 前缀。多数客户端会自动把它拼成：
Authorization: Bearer sk-xxxxxxxxxxxxxxxx如果你手动填成 Bearer sk-xxx，部分客户端会变成重复 Bearer，从而触发 401。
建议不同客户端分别创建不同 Key，比如：
- Open WebUI 专用 Key；
- Cherry Studio 专用 Key；
- Dify 专用 Key；
- Cline / 代码 Agent 专用 Key。
这样做的好处是后续更容易查日志、控成本、定位异常调用来源。
第四步：配置模型列表或 Model IDs Filter
Open WebUI 有些版本会自动拉取 /models，有些版本则需要你手动设置模型过滤项。这里的关键是：Open WebUI 里显示的模型 ID，必须和 DeepAI API 实际可调用的模型 ID 一致。
如果模型列表为空，可以尝试：
- 确认 DeepAI 后台确实有可用模型；
- 在 Open WebUI 里手动添加模型 ID；
- 检查 Model IDs Filter 是否把模型过滤掉；
- 用 curl 请求
/v1/models看是否能返回列表； - 不要把展示名当作模型 ID。
示例：
模型显示名：DeepSeek Chat
模型 ID：deepseek-chat真实可用 ID 以 DeepAI 后台和接口返回为准。不同平台的模型命名可能不完全一样，配置时不要靠猜。
第五步：保存并发起一次测试对话
保存配置后，回到 Open WebUI 的聊天页面，选择刚刚配置的模型，发送一句简单测试：
请用一句话介绍 OpenAI Compatible API。如果能正常回复，说明基础链路已经打通：
Open WebUI → DeepAI API 中转站 → 上游模型 → DeepAI → Open WebUI如果失败，不要急着把所有配置都改一遍。按照错误码分层排查更快。
常见错误一：401 Unauthorized
401 通常和 Key 有关，优先检查：
- API Key 是否复制完整；
- Key 前后有没有空格；
- 是否误填了
Bearer； - Key 是否被删除或禁用；
- 当前 Key 是否有调用权限；
- Open WebUI 是否保存到了正确的连接配置。
建议用同一个 Key 跑 curl。如果 curl 能通，但 Open WebUI 401，问题多半在 Open WebUI 的填写方式、环境变量覆盖或多连接配置冲突。
常见错误二：404 Model Not Found
404 不一定是 URL 错，也可能是模型 ID 错。
重点检查：
- Base URL 是否填成
https://api.deepai.wang/v1； - 是否误填完整
/chat/completions路径； - 模型 ID 是否真实存在；
- 当前 Key 是否有权限调用该模型；
- Open WebUI 选择的模型是否还是旧配置。
如果你刚改过模型列表，建议刷新页面或重新进入对话，避免前端缓存还在使用旧模型。
常见错误三：模型列表不显示
模型不显示时，不要只盯着 API Key。Open WebUI 的模型列表可能受到多个因素影响：
/v1/models是否能返回；- Open WebUI 是否启用了模型过滤；
- 当前用户是否有模型权限；
- 管理后台保存后是否生效；
- 反向代理是否拦截了请求；
- 前端缓存是否没刷新。
如果你的目标只是先跑通聊天，可以先手动添加一个确定可用的模型 ID，而不是依赖自动拉取模型列表。
常见错误四：流式输出失败
Open WebUI 默认可能使用 stream 模式。流式输出失败时，常见原因包括：
- 反向代理没有正确处理 SSE；
- Nginx 缓冲导致响应卡住；
- Cloudflare 或网关中断长连接；
- 模型端响应时间太长；
- 客户端和服务端对流式格式兼容性不同。
可以先尝试关闭 stream，或用非流式请求确认模型本身能回复。如果非流式能通、流式不通，重点查 Open WebUI 部署层和代理层。
Open WebUI 接 DeepAI 的推荐配置清单
为了后续稳定使用，建议按下面方式配置：
| 项目 | 建议 |
|---|---|
| Base URL | 固定使用 https://api.deepai.wang/v1 |
| API Key | Open WebUI 单独创建一个 Key |
| 模型 ID | 只添加已验证可用的模型 |
| 流式输出 | 先开；有问题再关闭测试 |
| 日志 | 同时看 Open WebUI 日志和 DeepAI 调用日志 |
| 团队使用 | 给不同团队或用途拆分 Key |
这种配置方式不是为了复杂，而是为了出问题时能快速定位：到底是 Open WebUI 配置问题、网络代理问题、DeepAI API Key 问题，还是模型 ID/权限问题。
和 Cherry Studio、Dify、Cline 的配置有什么区别
它们的底层逻辑很像：
客户端 / 平台 → OpenAI-compatible Base URL → API Key → Model ID区别在于每个工具的界面不同：
- Cherry Studio 更偏个人桌面客户端；
- Dify 更偏应用编排和工作流；
- Cline 更偏代码 Agent；
- Open WebUI 更偏团队聊天界面和 Web 管理。
如果你已经在 Cherry Studio 或 Dify 里接通过 DeepAI，Open WebUI 的配置会很好理解。核心仍然是三件事：Base URL、API Key、Model ID。
站内也可以继续参考：
- https://paper.deepai.wang/openai-compatible-api-cherry-studio-dify-cline/
- https://paper.deepai.wang/dify-deepai-openai-compatible-tutorial/
- https://paper.deepai.wang/cherry-studio-deepai-model-not-showing/
FAQ
Open WebUI 可以直接接 DeepAI API 中转站吗？
可以。只要你的 Open WebUI 版本支持 OpenAI-compatible API 配置，就可以把 Base URL 填为 https://api.deepai.wang/v1，再填写 DeepAI API Key 和模型 ID。
Base URL 要不要填 /chat/completions？
一般不要。Open WebUI 需要的是 Base URL，推荐填写 https://api.deepai.wang/v1。完整接口路径通常由客户端自动拼接。
为什么 Open WebUI 里看不到模型？
可能是模型列表没有自动拉取、Model IDs Filter 配置不正确、当前用户没有权限，或模型 ID 与 DeepAI 后台不一致。可以先手动添加一个确认可用的模型 ID 测试。
401 是 DeepAI 出问题了吗？
不一定。401 多数是 Key 填错、Key 无效、Bearer 重复、权限不足或客户端保存配置不正确。建议先用 curl 验证同一个 Key。
Open WebUI 可以和 Ollama 一起用吗？
可以。Open WebUI 常见用法就是本地 Ollama 和云端 OpenAI-compatible API 混合使用。本地模型适合隐私和低成本场景，DeepAI API 中转站适合调用更强的云端模型。
总结
Open WebUI 接入 DeepAI API 中转站，本质上就是把 Open WebUI 的模型入口从“单一本地模型”扩展成“统一 OpenAI-compatible API”。配置时别被界面选项绕晕，抓住三个核心参数就够了：
- Base URL：
https://api.deepai.wang/v1； - API Key：DeepAI 创建的 Key；
- Model ID：DeepAI 后台实际可用的模型 ID。
跑通以后，建议再做两件事：一是给 Open WebUI 单独建 Key，方便统计和风控；二是整理一份团队可用模型清单，避免成员随意选择不存在或成本过高的模型。
这样，Open WebUI 就不只是一个本地聊天界面，而可以变成团队统一使用多模型 API 的入口。
