Open WebUI - 开源 AI 对话平台

适用范围

本教程适用于 Open WebUI 管理员。完成配置后，站点用户可以在模型列表中选择 cnAPI 提供的模型进行对话。

Open WebUI 是可自托管的开源 AI 对话平台，支持通过 OpenAI 兼容接口连接外部模型服务。

• 官网：https://openwebui.com
• 官方文档：https://docs.openwebui.com
• GitHub：https://github.com/open-webui/open-webui

使用前准备

1. 登录 cnAPI，创建 API Key 并确认账户余额充足。
2. 准备至少一个当前账户可用的准确模型 ID。
3. 使用 Open WebUI 管理员账户登录；普通用户不能新增全站连接。

配置参数

这里必须保留 /v1

Open WebUI 的 URL 字段需要填写 API 基础地址，因此应使用 https://cnapi.vip/v1。

图形界面配置

1. 打开 Open WebUI，点击左下角头像进入 Admin Panel / 管理员面板。
2. 进入 Settings → Connections → OpenAI，点击 Add Connection。
3. 在连接编辑窗口中填写 URL 和 API Key，认证方式保持 Bearer。

下图以 Open WebUI 官方兼容服务商连接窗口为底图，仅将 URL 和模型 ID 替换为 cnAPI 示例值；API Key 始终保持遮盖。

4. 如果模型列表可以正常获取，Model IDs 可以留空。

5. 如果只想展示部分模型，或连接检查无法取得模型列表，点击加号手动加入准确模型 ID。

6. 点击 Save 保存连接。

7. 返回新对话页面，在模型选择器中选择刚添加的模型并发送一条测试消息。

Docker 环境变量配置

自托管管理员也可以在部署 Open WebUI 时设置环境变量：

OPENAI_API_BASE_URL=https://cnapi.vip/v1
OPENAI_API_KEY=<你的 cnAPI API Key>

修改后需要重新创建或重启 Open WebUI 容器。多连接部署还可以使用官方提供的 OPENAI_API_BASE_URLS、OPENAI_API_KEYS 或 OPENAI_API_CONFIGS，具体格式请以 当前版本的环境变量文档为准。

验证是否成功

1. 在 Open WebUI 中选择 cnAPI 模型并发送简单问题。
2. 确认回答可以正常流式返回。
3. 打开 cnAPI 控制台的使用日志，确认出现对应模型的请求记录。

只看到模型名称不代表调用已经成功；应同时完成一次真实对话和日志核对。

常见问题

连接检查失败，但接口地址和密钥都正确

Open WebUI 的连接检查会请求 /v1/models。如果模型列表接口暂时不可用，可以先在 Model IDs 中手动加入准确模型 ID，再进行实际对话测试。

模型列表为空

确认 URL 是 https://cnapi.vip/v1，然后刷新连接。仍为空时，从 cnAPI 模型列表复制 准确模型 ID，使用 Model IDs 手动添加。

返回 401

API Key 无效、已删除或复制时带有空格。请重新复制密钥并保存连接，不要把完整密钥 发到聊天、截图或公开日志中。

Responses API 是否需要开启

基础对话优先使用 OpenAI Chat Completions 兼容方式。只有确认当前模型和渠道支持 Responses API 时才启用相关实验选项。

官方依据

• OpenAI 兼容服务商连接教程
• Open WebUI 环境变量说明
• Open WebUI 官方仓库

[

Dify - 可视化 AI 应用开发平台

在 Dify 中通过 OpenAI 兼容模型供应商接入 cnAPI，并完成模型配置、对话验证和常见问题排查。

](/zh/docs/apps/dify)[

NextChat - 轻量跨平台 AI 客户端

将 NextChat 接入 cnAPI，配置自定义接口与模型。

](/zh/docs/apps/nextchat)