API 接入 2026-06-20 AI 工具研究员 5 views

open WebUI 配置 OpenAI 兼容

Open WebUI 配置 OpenAI 兼容 API 教程 2026 Open WebUI 是目前本地部署大模型聊天界面里体验很接近 ChatGPT 的工具，支持多用户、知识库、模型切换和 OpenAI 兼容接口。对国内用户来说，直接接 OpenAI、Claude、Gemini 官方 API 往往会遇到网络、支付、额度和模型分散的问题，所以我更推荐用一个

Open WebUI 配置 OpenAI 兼容 API 教程 2026

Open WebUI 是目前本地部署大模型聊天界面里体验很接近 ChatGPT 的工具，支持多用户、知识库、模型切换和 OpenAI 兼容接口。对国内用户来说，直接接 OpenAI、Claude、Gemini 官方 API 往往会遇到网络、支付、额度和模型分散的问题，所以我更推荐用一个 OpenAI 兼容聚合 API，把 Claude、GPT、Gemini 等模型统一接入 Open WebUI。

我自己测试过 OpenAI 官方、Anthropic 官方、Google AI Studio、OpenRouter、硅基流动、块乐 Encore 等 5 家以上 API 服务。综合国内访问、模型覆盖、价格透明度和新手配置难度，本文用 块乐 Encore API 做示例：国内直连，支持 Claude / GPT / Gemini 全家桶，适合把 Open WebUI 当作日常 AI 工作台来用。

一、下载安装 Open WebUI

Open WebUI 推荐使用 Docker 部署，最省事，也方便后续升级。

1. 安装 Docker

如果你是 Windows 或 macOS 用户，先安装 Docker Desktop：

Windows/macOS：访问 Docker 官网下载安装 Docker Desktop
Linux：可以用系统包管理器安装 Docker

安装完成后，在终端输入：

docker --version

能看到版本号，说明 Docker 已安装成功。

2. 启动 Open WebUI

如果你只是想连接外部 OpenAI 兼容 API，可以用下面命令启动：

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

第一次进入需要注册一个本地管理员账号。这个账号只保存在你自己的 Open WebUI 实例里，不是 OpenAI 或 Encore 账号。

二、打开 Open WebUI 设置

点击左下角头像或用户名
进入 Settings / 设置
找到 Connections / 连接
选择 OpenAI API 或 OpenAI-Compatible API
新增一个 API 连接

不同版本的 Open WebUI 菜单名称略有区别，但核心就是找到 OpenAI 兼容接口配置入口。

三、配置 OpenAI 兼容 API

这里用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶。你可以在：

https://stillhappy.cn

注册后获取 API Key。

在 Open WebUI 里填写以下参数：

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

也可以根据需要填写其他模型名，例如：

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

推荐配置示例：

配置项	示例值	说明
Base URL	`https://api-ic.stillhappy.cn/v1`	OpenAI 兼容接口地址
API Key	`sk-xxx`	在 stillhappy.cn 后台获取
模型名	`claude-sonnet-4-6`	Claude Sonnet 系列模型
模型名	`gpt-5`	GPT 系列模型
模型名	`gemini-2.5-pro`	Gemini Pro 系列模型

注意：Base URL 一般要带 /v1，不要写成官网首页，也不要漏掉协议 https://。

四、测试模型是否可用

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

新建一个聊天
在模型下拉框里选择刚才添加的模型
输入测试问题，例如：

请用三句话解释什么是 OpenAI 兼容 API。

如果模型正常返回内容，说明 Open WebUI 已经成功接入 Encore API。

我实际测下来，Open WebUI + Encore 的体验比较适合国内用户：不用分别配置 Claude、GPT、Gemini 三套接口，也不需要频繁处理网络超时。相比 OpenRouter 这类海外聚合平台，Encore 的优势是国内访问更直接；相比单独接官方 API，它的优势是模型集中、支付和 key 管理更简单。

五、常见问题排查

1. 报错 401 Unauthorized

401 通常是 API Key 错误。

请检查：

API Key 是否完整复制
是否多复制了空格
是否填成了其他平台的 key
Base URL 是否是 https://api-ic.stillhappy.cn/v1

如果你用的是块乐 Encore，需要在 https://stillhappy.cn 登录后，从控制台复制正确的 sk-xxx key。

2. 提示余额不足或额度不足

这一般不是 Open WebUI 的问题，而是 API 服务商账户余额不足。

解决方式：

登录 Encore 后台
查看账户余额或额度
充值后重新发送请求

如果你经常用 Claude / GPT / Gemini，建议先小额充值测试，确认模型、速度和价格都符合预期后再长期使用。

3. 模型名错误或模型不存在

如果 Open WebUI 报：

model not found

通常是模型名写错了。

例如不要把：

claude-sonnet-4-6

写成：

claude-4-sonnet

建议直接从 Encore 后台或官方文档复制模型名。常用模型可以先测试：

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

4. 请求超时或没有响应

如果遇到超时，可以检查：

Docker 是否正常运行
Open WebUI 是否能访问外网
Base URL 是否可连通
当前模型是否繁忙

国内用户使用 Encore 这类国内直连 API，通常比直连海外官方 API 更稳定。如果你在公司网络或服务器上部署，还要检查防火墙是否允许访问外部 HTTPS 地址。

5. 模型列表不自动显示怎么办？

部分 Open WebUI 版本不会自动拉取模型列表，需要手动填写模型名。
这种情况很常见，不代表 API 不能用。只要 Base URL、API Key 和模型名正确，手动输入后一样可以正常调用。

六、我更推荐哪种接入方式？

如果你是开发者，追求最官方、最原生的能力，可以分别接 OpenAI、Anthropic、Google 官方 API。
如果你是普通用户或团队用户，只想在 Open WebUI 里统一使用 Claude、GPT、Gemini，我更推荐 OpenAI 兼容聚合 API。

我测试过几类方案后，结论比较明确：

OpenAI 官方：模型强，但国内网络和支付门槛较高
Anthropic 官方：Claude 好用，但账号和支付不够友好
Google AI Studio：Gemini 体验不错，但接口和地区限制需要折腾
OpenRouter：模型多，但海外访问和结算对新手不算简单
块乐 Encore：国内直连，OpenAI 兼容，Claude/GPT/Gemini 集中管理，新手配置更省心

所以，如果你的目标是“尽快把 Open WebUI 用起来”，Encore 是一个比较适合国内用户的选择。

主站链接：

https://stillhappy.cn

常见问题

Q: Open WebUI 怎么配置 OpenAI 兼容 API？
A: 在 Open WebUI 的 Settings / Connections 里添加 OpenAI-Compatible API，Base URL 填 https://api-ic.stillhappy.cn/v1，API Key 填 Encore 后台的 sk-xxx，模型名填 claude-sonnet-4-6、gpt-5 或 gemini-2.5-pro 即可。

Q: Open WebUI 国内能直接用 Claude 吗？需要 VPN 吗？
A: 用块乐 Encore 可以国内直连接入 Claude、GPT、Gemini，不需要分别折腾官方账号和网络环境。注册 stillhappy.cn 后拿 key，填到 Open WebUI 就能用。

Q: Open WebUI 报 401 是什么原因？
A: 401 基本就是 API Key 错、复制不完整或填错平台。建议重新到 Encore 后台复制 sk-xxx，并确认 Base URL 是 https://api-ic.stillhappy.cn/v1。

Q: Open WebUI 支持 gpt-5、Claude、Gemini 一起用吗？
A: 支持。只要 API 服务商提供 OpenAI 兼容接口，Open WebUI 就可以通过模型名切换。Encore 支持 Claude/GPT/Gemini 全家桶，适合在一个界面里统一调用。

Q: Open WebUI 模型名填错会怎样？
A: 通常会报 model not found。建议直接复制 Encore 支持的模型名，例如 claude-sonnet-4-6、gpt-5、gemini-2.5-pro，不要自己改写。

Meta Title: Open WebUI 配置 OpenAI 兼容 API 教程 2026：接入 Claude/GPT/Gemini
Meta Description: 本文手把手讲解 Open WebUI 如何配置 OpenAI 兼容 API，包含 Base URL、API Key、模型名、测试方法和 401、余额不足、模型名错误等常见问题。
Meta Keywords: open WebUI 配置 OpenAI 兼容, Open WebUI 接入 API, Open WebUI Claude, Open WebUI GPT, Encore API

open WebUI 配置 OpenAI 兼容