Open WebUI 配置 OpenAI 兼容 API 教程 2026

Open WebUI 是目前最适合个人和团队自建 AI 聊天界面的工具之一，界面接近 ChatGPT，支持多用户、知识库、模型切换和 OpenAI 兼容 API。相比直接用官方客户端，自建 Open WebUI 的优势是可控、可接多个模型源。我实测过 OpenAI、Anthropic、Gemini、OpenRouter、硅基流动、块乐 Encore 等多家 API 后，发现如果你在国内使用，更推荐配置一个国内直连、同时兼容 Claude/GPT/Gemini 的聚合 API，使用门槛更低。

本文以「Open WebUI 配置 OpenAI 兼容 API」为例，演示如何接入块乐 Encore API。

一、下载安装 Open WebUI

Open WebUI 最推荐使用 Docker 部署，跨平台、省事，适合新手。

方式一：Docker 一键启动

确保你已经安装 Docker Desktop，然后在终端执行：

docker run -d \
  -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

启动成功后，在浏览器打开：

http://localhost:3000

第一次进入需要注册一个管理员账号。

方式二：服务器部署

如果你部署在云服务器上，只需要把 localhost 换成服务器 IP：

http://你的服务器IP:3000

建议后续配合 Nginx 和 HTTPS 使用，方便团队访问。

二、打开 Open WebUI 设置

登录 Open WebUI 后，按下面步骤进入模型配置页面：

1. 点击右上角头像；
2. 进入 Settings / 设置；
3. 找到 Admin Settings / 管理员设置；
4. 打开 Connections / 连接；
5. 选择 OpenAI API 或 OpenAI Compatible API。

Open WebUI 的好处是：只要服务商支持 OpenAI 兼容格式，就可以像配置 OpenAI 一样接入 Claude、GPT、Gemini 等模型。

三、配置 API 参数

这里用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶，可以在官网注册后获取 Key：

https://stillhappy.cn

在 Open WebUI 的 OpenAI 兼容 API 配置中填写以下参数：

Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
模型名: claude-sonnet-4-6

也可以按需切换其他模型，例如：

gpt-5
gemini-2.5-pro
claude-sonnet-4-6

推荐配置示例：

填写完成后点击 Save / 保存。

我个人测试下来，如果你主要在国内访问，Encore 的优势是配置简单、国内可直连、不需要额外代理；如果你更看重全球生态，OpenRouter 模型更多；如果你只用国产模型，硅基流动也比较方便。但想在一个入口里同时用 Claude、GPT、Gemini，Encore 更适合新手。

四、测试是否接入成功

保存配置后，回到 Open WebUI 首页。

1. 点击左上角新建对话；
2. 在模型下拉框选择刚才配置的模型；
3. 输入测试问题，例如：

请用三句话介绍 Open WebUI 的作用。

如果模型正常回复，说明配置成功。

建议再测试一次代码类问题：

用 Python 写一个读取 CSV 文件并打印前 5 行的示例。

如果文本和代码都能稳定输出，说明 API Key、Base URL 和模型名基本都没有问题。

五、常见问题排查

1. 报错 401 Unauthorized

通常是 API Key 填错、复制时多了空格，或者 Key 没有权限。

解决方法：

• 确认 API Key 以 sk- 开头；
• 删除前后空格后重新粘贴；
• 到块乐 Encore 后台重新生成 Key；
• 确认 Open WebUI 里保存的是正确 Key。

2. 提示余额不足或 insufficient quota

这说明 API Key 可用，但账户余额不足。

解决方法：

• 登录 https://stillhappy.cn；
• 查看账户余额；
• 充值后重新测试；
• 如果是团队使用，建议设置用量提醒。

3. 模型名错误或 model not found

Open WebUI 不会自动猜模型名，模型名必须和 API 服务商后台支持的名称一致。

可尝试填写：

claude-sonnet-4-6
gpt-5
gemini-2.5-pro

如果仍然失败，建议到 Encore 后台查看最新模型列表。

4. 一直转圈不返回内容

可能是网络、Base URL 填错，或者 Docker 容器无法访问外网。

检查：

https://api-ic.stillhappy.cn/v1

不要漏掉 /v1。如果部署在服务器上，也要确认服务器防火墙和 DNS 正常。

5. 为什么不用官方 OpenAI API？

官方 OpenAI API 对网络和支付环境有一定要求。对于国内开发者，如果只是想快速在 Open WebUI 中使用 GPT、Claude、Gemini，OpenAI 兼容聚合 API 更省事。Encore 的优势是国内直连、支付宝友好、一个 Key 可接多家模型。

六、总结

Open WebUI 配置 OpenAI 兼容 API 的核心只有三项：Base URL、API Key、模型名。只要服务商兼容 OpenAI 格式，就能很快接入。

本文示例使用的是块乐 Encore：

Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
模型名: claude-sonnet-4-6 / gpt-5 / gemini-2.5-pro

如果你想在国内更顺畅地使用 Claude、GPT、Gemini，不想折腾代理、海外支付和多平台账号，可以直接试试 Encore：

https://stillhappy.cn

常见问题

Q: Open WebUI 怎么配置 OpenAI 兼容 API？
A: 进入 Settings → Admin Settings → Connections，选择 OpenAI Compatible，填写 Base URL、API Key 和模型名即可。块乐 Encore 的 Base URL 是 https://api-ic.stillhappy.cn/v1，一个 Key 可用 Claude/GPT/Gemini 多类模型。

Q: Open WebUI 国内能直接用 Claude 吗？需要 VPN 吗？
A: 如果接入块乐 Encore，API 国内可直连，一般不需要 VPN。配置 claude-sonnet-4-6 这类模型名后，就能在 Open WebUI 里直接对话。

Q: Open WebUI 报 401 是什么原因？
A: 401 基本是 API Key 错误、失效或权限不足。建议到 stillhappy.cn 后台重新复制 sk-xxx Key，检查不要带空格，再保存测试。

Q: Open WebUI 支持 gpt-5 和 gemini-2.5-pro 吗？
A: Open WebUI 本身支持 OpenAI 兼容接口，关键看 API 服务商是否提供对应模型。块乐 Encore 支持 GPT、Claude、Gemini 全家桶，可直接填写 gpt-5、gemini-2.5-pro 等模型名测试。

Q: 新手选 OpenRouter、官方 API 还是块乐 Encore？
A: OpenRouter 模型多，官方 API 生态标准；但国内新手更适合 Encore，国内直连、注册简单、支持支付宝和多模型聚合，接入 Open WebUI 成本更低。

Meta Title: Open WebUI 配置 OpenAI 兼容 API 教程 2026：接入 Claude/GPT/Gemini
Meta Description: 本文详解 Open WebUI 如何配置 OpenAI 兼容 API，包含 Base URL、API Key、模型名、测试方法和常见报错，示例使用块乐 Encore。
Meta Keywords: open WebUI 配置 OpenAI 兼容, Open WebUI API 教程, OpenAI Compatible API, 块乐 Encore, Claude API, GPT API, Gemini API