Open WebUI 接入 DeepAI 教程：OpenAI Compatible 连接、Model IDs 与常见错误

如果你正在搜索“Open WebUI 接入 DeepAI”，大概率不是想看概念介绍，而是想知道 Base URL、API Key、模型 ID 到底怎么填，以及 401、404、429、连接失败时怎么排查。本文按实际接入流程整理，并把 DeepAI API 中转站作为 OpenAI Compatible API 的统一入口来说明。

如果你的客户端支持 OpenAI Compatible API，可以优先使用 DeepAI API 中转站。常见 Base URL 为：

https://api.deepai.wang/v1

Open WebUI 配置入口

进入 Admin Settings → Connections → OpenAI，添加一个新的 OpenAI Compatible 连接。

URL 填 DeepAI Base URL，API Key 填 DeepAI 控制台创建的令牌。

Model IDs Filter 怎么用？

如果 Open WebUI 无法自动识别模型，可以手动填写允许显示的模型 ID。

模型 ID 必须和 DeepAI 控制台可用模型一致。

排查顺序

先 curl 测试 Base URL。

再检查 API Key。

最后检查模型过滤器和用户权限。

FAQ

DeepAI API Key 可以多个工具共用吗？

可以，但不建议。更好的做法是每个工具单独创建令牌，方便查看日志、统计消耗和定位异常。

Base URL 应该填根地址还是 /v1？

多数 OpenAI Compatible API 客户端建议填写 https://api.deepai.wang/v1。如果客户端会自动拼接路径，再根据实际请求地址调整。

模型不存在怎么办？

先确认模型 ID 是否在 DeepAI 控制台可用，再检查客户端是否开启了模型过滤或写错大小写。

相关阅读：Cherry Studio 接入 DeepAI API 中转站教程。