Open WebUI 接入 Claude 和 GPT API 教程：一个连接同时用两家模型（2026）

说明：我是 APIVAI 的运营者，下面示例里的地址是 APIVAI 的。配置方法对任何兼容 OpenAI 格式的网关都一样，换成你自己用的地址即可。

Open WebUI 是一个自托管的聊天界面，通常用 Docker 运行，支持用户账号、聊天记录、模型预设和文档对话。它本身不带云端模型，而是连接任何支持 OpenAI Chat Completions 协议的服务器。这篇按 2026 年 10 月的 Open WebUI 文档和界面字段，讲清楚怎么接第三方 API 同时用 Claude 和 GPT、/v1 要不要带、怎么省掉后台任务的开销，以及常见报错。

用哪种连接方式

Open WebUI 通过 OpenAI 连接访问云端模型。它没有填写自定义 Anthropic Messages 地址的字段，内置的 Anthropic 支持只认 Anthropic 官方地址。所以只能用 OpenAI 格式，好在 Claude 和 GPT 都能走这个格式，一个连接全覆盖。

/v1 的规则：地址以 /v1 结尾，且只出现一次。不带 /v1 的 https://api.apivai.com 是给 Claude Code 这类基于 Anthropic SDK 的工具用的，在 Open WebUI 里用不上。

第 1 步：添加连接

1. 用管理员账号登录 Open WebUI。
2. 打开 Settings > Admin > Connections，找到 Manage OpenAI API Connections 列表。
3. 点 + Add Connection。
4. 按下表填写 URL 和 API Key，Connection Type 保持 External。

第 2 步：验证、选模型、保存

1. 点 URL 字段旁的 Verify Connection。Open WebUI 会用你的 Key 请求 /models，应显示 Server connection verified。
2. 可选：展开 Advanced。在 Model IDs 里输入要开放的模型 ID，每输入一个点一次 +；留空则列出 Key 能用的全部模型。Prefix ID 会在模型名前加上 apivai. 这样的标签，发请求前 Open WebUI 会自动去掉。Provider 保持 Default。
3. 点 Save。新建对话时，模型会出现在顶部的模型选择器里。

模型列表会变，以接口返回的 ID 为准，别照抄旧教程：

curl https://api.apivai.com/v1/models -H "Authorization: Bearer 你的Key"

自部署：用 Docker 环境变量配置

用 Docker 部署的话，可以在创建容器时用环境变量传入同样的值：

docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  -e WEBUI_SECRET_KEY=your-secret-key \
  -e OPENAI_API_BASE_URL=https://api.apivai.com/v1 \
  -e OPENAI_API_KEY=你的Key \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

没跑 Ollama 的话，加上 -e ENABLE_OLLAMA_API=False，Open WebUI 就不会再尝试连接它。想用环境变量限制模型列表，可以用 OPENAI_API_CONFIGS：一个以连接序号为键的 JSON 对象，包含 model_ids、prefix_id 等字段。

有个坑：这些变量属于 ConfigVar。在默认的 ENABLE_PERSISTENT_CONFIG=True 下，通过管理面板存进数据库的值优先于环境变量。之后改了 OPENAI_API_BASE_URL 却没生效，就直接到 Settings > Admin > Connections 里改连接。

设置便宜的任务模型

Open WebUI 会在后台发一些小请求，用来生成对话标题、标签、推荐追问和输入自动补全。默认用的是当前对话的模型，所以用贵模型的对话，连标题也按贵模型计费。在 Settings > Admin > Interface 里把 External Task Model 设为 claude-haiku-4-5 或 gpt-6-luna。

后台请求默认只有 1,000 个输出 token，思考 token 也算在里面。标题为空或被截断时，在同一部分打开 Task Model Parameters > Configure，把 max_tokens 设为 4096。

文档和知识库能用吗

对话没问题。但文档检索（RAG）需要嵌入（embedding）模型来索引文件，APIVAI 不提供嵌入接口。

Open WebUI 默认用本地的 SentenceTransformers 模型生成嵌入（RAG_EMBEDDING_ENGINE 留空），所以上传的文档不用改任何设置就能继续用。只是不要把嵌入引擎切换成 OpenAI 并填网关地址。需要云端嵌入的话，通过 RAG_OPENAI_API_BASE_URL 和 RAG_OPENAI_API_KEY，或在 Settings > Admin > Documents 里单独配一个嵌入服务商。回答仍然由你选的 Claude 或 GPT 生成。图像生成和语音功能也需要各自的服务商，APIVAI 不提供图像模型。

模型怎么搭配

• 团队默认对话模型：claude-sonnet-5-5 或 claude-sonnet-4-6
• 快速问答和后台任务（标题、标签）：claude-haiku-4-5 或 gpt-6-luna
• 想用 GPT：gpt-6.1-sol，要求高的任务用 gpt-6-astra
• 最难的问题：claude-opus-5-5，真正需要时再用

给团队用的话，可以用 Model IDs 列表只开放你愿意买单的模型，对日常用户隐藏 Opus 是控制共享账单最简单的办法。每条消息都会把之前的对话重新发一遍，对话越长每条越贵，换话题就新开一个对话。

常见报错

• 401 / Verify Connection 失败：Key 有多余空格、没复制全，或者已经被删了。
• 402 / insufficient_quota：这个 Key 的预算用完了，或者剩得太少、不够贵的模型（Opus、Sonnet 4.6 等）发一次请求。给 Key 加点预算，或者先换便宜的模型。Key 在还剩一点钱时就会停用，这部分不会丢，删掉 Key 会退回账户余额。
• 404：URL 写错了。必须是 https://api.apivai.com/v1：不能少 /v1，不能是 /v1/v1，不能写成 /v1/chat/completions 这样的完整路径，结尾也不要加斜杠。
• 找不到模型：Model IDs 里的某个 ID 不存在（常见于旧名称或显示名称），用 GET /v1/models 核对。显示成 apivai.claude-sonnet-4-6 是正常的，那是你设的 Prefix ID。
• 回复为空或被截断：思考默认开启，思考 token 算输出。在 Advanced Params 里把 max_tokens 设到 4096 以上：单个对话在 Chat Controls 里设，所有人统一则在 Workspace > Models 里按模型设。
• 环境变量不生效：管理面板里保存的值覆盖了它们（见上面 Docker 部分）。
• 429：默认每个 Key 每分钟 60 次请求，后台任务也算在内。人多的团队可以给用户分不同的 Key（比如用个人 Direct Connections）。

有问题欢迎评论区交流。