Open WebUI 自定义大模型 API 连接配置教程
在 Open WebUI 管理后台「外部连接(Connections)」填入 https://deepclub.net/v1 与 DeepClub API Key,即可在自托管界面里统一切换 DeepSeek、Gemini、GLM、Kimi 与兼容模型。
Open WebUI 怎么接入深云 DeepClub?
- 在深云 DeepClub 控制台「API 密钥」页面创建密钥(建议在密钥权限中勾选需要的在售模型)。
- 使用管理员账号登录 Open WebUI,进入 Admin Panel → Settings → Connections(或启动容器时配置环境变量)。
- 在 OpenAI API 区域新增或修改连接:
- URL:
https://deepclub.net/v1 - Key:粘贴
sk-...密钥 - Model IDs:填入你想开放给界面使用的精确模型 ID,例如
deepseek-v4.1-flash、gemini-4-hydrogen、gemini-4-carbon、glm-5.3、kimi-k3、gpt-6.1-sol。
- URL:
# Docker 部署时也可直接通过环境变量注入
OPENAI_API_BASE_URL=https://deepclub.net/v1
OPENAI_API_KEY=sk-你的DeepClub密钥
为什么建议手动填精确模型 ID?
如果你使用的是按模型授权的子 Key,或者只想给团队开放几款主力模型,在 Open WebUI 连接设置里显式指定 Model IDs 可以避免模型下拉列表过长,也能防止前端请求不在销售目录内的别名。
注意事项
- Open WebUI 的标准 OpenAI 连接发送
/v1/chat/completions;对deepseek-v4.1-flash、gemini-4-*、glm-5.3、kimi-k3、qwen3.8-flash这是首选协议,对gpt-6.1-sol与claude-sonnet-5-5这是兼容模式(调用 Claude 5.x 时请勿在高级参数里覆盖温度)。 - 需要查看每笔请求消耗时,前往深云控制台「使用日志」;全部模型实时单价见 定价页。
常见问题
- Open WebUI 填了 https://deepclub.net/v1 后报 404 怎么检查?
- 核对 URL 末尾不要多写 /chat/completions(Open WebUI 会自动拼接),并确认填写的模型 ID 与 /pricing 页面展示的 api_model 完全一致。
- Open WebUI 支持和 LobeChat / Cherry Studio 共用同一个深云账号吗?
- 支持。可以在深云后台为 Open WebUI 单独签发一个带额度上限的子 Key,共享同一个账户余额并独立查看用量。
更新于