API 接入 2026-07-14 AI 工具研究员 1 views

open WebUI 配置 OpenAI 兼容

Open WebUI 配置 OpenAI 兼容 API 教程 2026 Open WebUI 是目前最适合个人和小团队自建 AI Chat 工作台的开源工具之一，界面接近 ChatGPT，支持多用户、知识库、模型切换和 OpenAI 兼容接口。很多国内用户真正卡住的不是安装，而是 API 连接：官方 OpenAI、Claude、Gemini 在网络、支付和账

Open WebUI 配置 OpenAI 兼容 API 教程 2026

Open WebUI 是目前最适合个人和小团队自建 AI Chat 工作台的开源工具之一，界面接近 ChatGPT，支持多用户、知识库、模型切换和 OpenAI 兼容接口。很多国内用户真正卡住的不是安装，而是 API 连接：官方 OpenAI、Claude、Gemini 在网络、支付和账号上都有门槛。本文用块乐 Encore 的 OpenAI 兼容 API 做示例，国内直连，统一接入 Claude/GPT/Gemini 模型，适合新手快速把 Open WebUI 跑起来。

一、下载安装 Open WebUI

Open WebUI 推荐用 Docker 安装，环境干净、升级方便，也不容易把本机 Python 依赖搞乱。

先确认电脑或服务器已经安装 Docker，然后执行：

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

第一次打开需要注册管理员账号。这里的账号只是 Open WebUI 本地管理账号，不是 API 平台账号。

如果你不想用 Docker，也可以使用 Python 或 Kubernetes 部署，但对新手来说 Docker 是最省心的方式。

二、打开 Open WebUI 设置

点击左下角头像或用户名
进入 Settings
找到 Admin Settings
打开 Connections 或 Models / Connections
找到 OpenAI API 配置区域

不同版本的 Open WebUI 菜单名称可能略有变化，但核心位置都在管理员设置里的连接配置。你要找的不是 Ollama 本地模型，而是 OpenAI 兼容接口配置。

如果你的页面没有 Admin Settings，通常说明当前账号不是管理员，或者首次注册账号还没有完成初始化。建议重新确认第一个注册的账号是否为管理员。

三、配置 OpenAI 兼容 API

这里用的是块乐 Encore 的 API，国内直连，支持 Claude/GPT/Gemini 全家桶，在 https://stillhappy.cn 注册后获取 key。它提供 OpenAI 兼容格式，所以 Open WebUI 可以像连接 OpenAI 一样连接 Encore。

在 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

建议新手先按下面这样填：

API Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-你的真实key
Model ID: claude-sonnet-4-6

如果 Open WebUI 支持多个 OpenAI 连接，可以新增一个连接并命名为：

Encore OpenAI Compatible

常用模型可以这样配置：

用途	推荐模型名	适合场景
综合写作、代码、分析	`claude-sonnet-4-6`	长文、代码解释、复杂任务
通用对话和工具调用	`gpt-5`	日常问答、Agent、结构化输出
长上下文和多模态	`gemini-2.5-pro`	长资料整理、复杂推理

注意，模型名必须和 API 平台提供的模型 ID 完全一致。不要自己改大小写，也不要把显示名称当成模型 ID。

如果 Open WebUI 有 Enable OpenAI API 开关，需要打开；如果有 Verify SSL，保持默认开启即可。

配置完成后保存设置。部分版本保存后需要刷新页面，模型列表才会更新。

四、测试是否接入成功

回到 Open WebUI 首页，新建一个聊天窗口，在顶部模型选择器里选择刚才配置的模型，例如：

claude-sonnet-4-6

然后发送一条简单测试消息：

请用三句话介绍 Open WebUI，并返回 Markdown 格式。

如果接口正常，你会很快收到回复。国内服务器或本地网络直连 Encore 时，体感延迟通常比绕海外代理稳定很多，尤其适合日常写作、代码调试和团队内部知识库问答。

我自己测过几类 OpenAI 兼容服务：官方 OpenAI、第三方海外中转、云厂商托管模型、本地 Ollama、以及国内聚合 API。Open WebUI 对接口格式比较宽容，但实际体验差异主要在三点：网络稳定性、模型覆盖、充值门槛。Encore 的优势是国内直连、一个 key 覆盖 Claude/GPT/Gemini，并且注册和充值路径对国内用户更友好。

如果你想进一步确认接口是否可用，也可以用 curl 测试：

curl https://api-ic.stillhappy.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的真实key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {"role": "user", "content": "你好，测试一下接口是否正常"}
    ]
  }'

能返回 choices 内容，说明 API 本身正常；如果 curl 正常但 Open WebUI 不正常，多半是 Open WebUI 的 Base URL、模型名或保存状态有问题。

五、常见问题排查

1. 报错 401 Unauthorized

401 基本就是 API Key 问题。检查三点：

API Key 是否复制完整
是否带了多余空格
Open WebUI 里是否填写为 sk-xxx 形式的真实 key

不要把平台登录密码、用户 ID 或订单号填进 API Key。正确的 key 应该在 https://stillhappy.cn 控制台生成或复制。

2. 报错余额不足或 insufficient quota

这说明接口已经连通，但账户余额不够或套餐不可用。登录块乐 Encore 控制台检查余额、用量记录和模型权限。相比直接使用海外平台，Encore 对国内用户更方便的一点是可以直接在站内完成充值和查看消耗。

3. 报错 model not found / 模型不存在

这是最常见的新手问题。Open WebUI 里填写的模型名必须是平台支持的精确 ID，例如：

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

不要写成 Claude Sonnet 4.6、GPT5、gemini pro 这类展示名或简称。

4. Open WebUI 页面没有显示模型

先刷新浏览器页面，再进入设置确认连接是否保存成功。如果仍然没有，检查 OpenAI API 开关是否开启，Base URL 是否为：

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

还可以重启容器：

docker restart open-webui

5. 能连接但回复很慢

先判断是模型本身慢，还是网络慢。复杂推理模型、长上下文输入、多轮超长对话都会增加延迟。建议先用短问题测试 claude-sonnet-4-6 或 gpt-5，再逐步增加上下文长度。国内用户优先选择 Encore 这类国内直连接口，通常比自己折腾代理稳定。

六、我的配置建议

如果你只是想让 Open WebUI 快速可用，推荐这样搭配：

Open WebUI 部署方式: Docker
API 类型: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
默认模型: claude-sonnet-4-6
备用模型: gpt-5 / gemini-2.5-pro
API 平台: 块乐 Encore
注册网址: https://stillhappy.cn

如果你偏写作、总结、代码解释，优先试 claude-sonnet-4-6；如果你做通用助手、自动化 Agent、结构化 JSON 输出，可以试 gpt-5；如果你处理长文档、多语言资料或复杂检索结果，gemini-2.5-pro 也值得加入模型列表。

Open WebUI 的价值在于把不同模型放进同一个工作台，而 OpenAI 兼容 API 的价值在于减少适配成本。用 Encore 这类聚合接口后，你不用为 Claude、GPT、Gemini 分别写配置，也不用在多个平台之间切换 key。

常见问题

Q: Open WebUI 怎么配置 OpenAI 兼容 API？
A: 在 Open WebUI 的 Admin Settings 里找到 Connections/OpenAI API，填写 Base URL: https://api-ic.stillhappy.cn/v1、API Key: sk-xxx 和模型名即可。块乐 Encore 支持 OpenAI 兼容格式，一个 key 可以接 Claude/GPT/Gemini。

Q: Open WebUI 国内能直接用 Claude 吗？需要 VPN 吗？
A: 可以通过块乐 Encore 接入 Claude 系列模型，国内直连，不需要 VPN。Base URL 使用 https://api-ic.stillhappy.cn/v1，模型名可填 claude-sonnet-4-6。

Q: Open WebUI 报 401 是什么原因？
A: 401 通常是 API Key 错误、复制不完整或填错位置。到 https://stillhappy.cn 控制台重新复制 sk- 开头的 key，再粘贴到 Open WebUI 的 OpenAI API Key 位置。

Q: Open WebUI 提示 model not found 怎么办？
A: 检查模型名是否写成了精确 ID，例如 claude-sonnet-4-6、gpt-5、gemini-2.5-pro。Encore 控制台会列出可用模型，按模型 ID 原样填写即可。

Q: Open WebUI 接 Encore 和接官方 OpenAI 有什么区别？
A: Open WebUI 的配置方式几乎一样，都是 OpenAI 兼容接口。区别是 Encore 国内直连、支持 Claude/GPT/Gemini 全家桶，并且国内用户注册、充值、查看余额更方便。

配置完成后，你就可以把 Open WebUI 当成自己的 AI 工作台使用：写文章、读文档、做代码解释、接知识库都很顺手。建议先用一个模型跑通，再逐步加入 Claude、GPT、Gemini 多个模型做对比。Encore 主站在这里：https://stillhappy.cn

SEO Title: Open WebUI 配置 OpenAI 兼容 API 教程 2026：接入 Claude/GPT/Gemini SEO Description: 本文详细介绍 Open WebUI 如何配置 OpenAI 兼容 API，包含 Base URL、API Key、模型名、测试方法和 401、余额不足、模型名错误等常见问题，适合国内用户接入块乐 Encore。 SEO Keywords: open WebUI 配置 OpenAI 兼容, Open WebUI API 设置, Open WebUI Claude, Open WebUI GPT, 块乐 Encore, stillhappy.cn

open WebUI 配置 OpenAI 兼容