Open WebUI 接入 CaMeL Hub:一个 Key 调用 GPT、Claude、Gemini、DeepSeek

Open WebUI 是目前使用最广的开源自托管大模型聊天界面——一个 Docker 容器就能跑起一套私有的、类 ChatGPT 体验的前端,自带对话历史、基于本地文档的检索增强生成(RAG)、多用户账号体系,以及不断扩展的工具/插件生态。它原生支持连接 Ollama 跑本地模型,也支持接入任意 OpenAI 兼容 API 调用云端模型。把第二种连接指向 CaMeL Hub,Open WebUI 就变成了一个能同时调用所有主流厂商模型的统一入口:GPT-5.5、Claude Sonnet 5、Gemini 3.1 Pro、DeepSeek V4 以及其余 480 多个模型,全部用同一个 CaMeL Hub API Key 和同一份按量计费的预充值余额调用,不需要分别注册 OpenAI、Anthropic、Google 账号,也不需要分别绑定支付方式。本地 Ollama 模型和 CaMeL Hub 的云端模型会出现在同一个模型选择器里,自托管推理和云端推理可以在同一个界面里并存使用。

Open WebUI ↗

  1. 创建一个 CaMeL Hub API Key

    登录 CaMeL Hub 控制台,进入「API 密钥(Token)」页面,新建一个 Key 并立即复制保存——下一步会把它填进 Open WebUI 的连接配置里。
  2. 打开 Open WebUI 的连接(Connections)设置

    登录你的 Open WebUI 实例,点击右上角头像,进入「管理员面板(Admin Panel)→ 设置(Settings)→ 连接(Connections)」。这里是整个实例统一登记外部模型服务商(Ollama、各类 OpenAI 兼容 API)的地方。
  3. 新增一个 OpenAI API 连接

    在「OpenAI API」区域点击 + 号新增一条连接。把标注为 URL / Base URL 的字段填成 CaMeL Hub 的接入地址,把标注为 Key / API Key 的字段填成第 1 步拿到的 Key,然后打开这条连接的启用开关并保存。
    URL: https://api.camel-hub.com/v1
    Key: sk-your-camel-hub-key
  4. 验证连接是否生效

    点击刚新增连接旁边的小刷新/校验图标。Open WebUI 会对该 Base URL 的 /v1/models 接口发起一次请求——校验通过就说明 Key 和 URL 都填对了,可以放心离开设置页。
  5. 确认模型列表已经出现

    新开一个对话,查看页面顶部的模型下拉框。这个 Key 下 CaMeL Hub 提供的所有模型——包括 claude-sonnet-5、gpt-5.5、gemini-3.1-pro、deepseek-v4-flash——都应该和你原来配置的本地 Ollama 模型一起出现在列表里。
  6. 设置默认模型与可见模型

    回到「管理员面板 → 设置 → 模型(Models)」,可以隐藏用不到的模型、调整排序,并把某个模型设为新对话的默认模型——比如你日常主要用 gpt-5.5 或 claude-sonnet-5,同时保留完整模型库随时可切换。
  7. 想用环境变量?容器启动时直接配好

    如果是脚本化部署或自托管环境,也可以跳过管理面板界面,在启动容器时直接通过环境变量传入 Base URL 和 Key,Open WebUI 会自动把它识别为默认的 OpenAI API 连接。
    docker run -d -p 3000:8080 \
      -e OPENAI_API_BASE_URL=https://api.camel-hub.com/v1 \
      -e OPENAI_API_KEY=sk-your-camel-hub-key \
      -v open-webui:/app/backend/data \
      --name open-webui \
      ghcr.io/open-webui/open-webui:main

常见问题

连接加上了,但模型下拉框是空的,是哪里出问题了?

几乎总是 URL 或 Key 的问题。确认 Base URL 精确是 https://api.camel-hub.com/v1(带 /v1 后缀、末尾不要多加斜杠),Key 粘贴时没有多余空格,并且这条连接的启用开关是打开状态。点一下连接旁的刷新/校验图标重新检测一遍;如果 Open WebUI 部署在有出站限制的内网环境,还要确认它能正常访问 api.camel-hub.com 的 443 端口。

点击校验后连接显示失败(红色状态),这是什么意思?

校验失败说明 /v1/models 请求没有拿到正常响应,常见原因是 Key 失效或填错、Base URL 拼写有误,或是运行 Open WebUI 的机器出站网络/防火墙被拦。这不代表 CaMeL Hub 服务本身出了问题,先去控制台的 API 密钥页确认 Key 状态即可。

默认模型该选哪个?

没有唯一答案,看你最常用的场景:日常聊天和写代码问答,gpt-5.5、claude-sonnet-5 是比较均衡的通用选择;高频调用或对延迟敏感,deepseek-v4-flash 又快又便宜;需要处理很长的文档或上下文,gemini-3.1-pro 是更合适的选择。默认模型之外,每次对话都可以从下拉框里临时切换。

接入 CaMeL Hub 之后,原来的本地 Ollama 模型还能继续用吗?

可以。Open WebUI 支持同时保留多条连接——原有的 Ollama 连接和新加的 CaMeL Hub OpenAI 兼容连接会同时生效,两边的模型会一起出现在同一个模型选择器里。接入 CaMeL Hub 不会关闭或替代本地推理。