Open WebUI - 开源 AI 对话平台
将 Open WebUI 接入 88API，统一使用多家兼容模型。
适用范围
本教程适用于 Open WebUI 管理员。完成配置后，站点用户可以在模型列表中选择 88API 提供的模型进行对话。
Open WebUI 是可自托管的开源 AI 对话平台，支持通过 OpenAI 兼容接口连接外部模型服务。
- 官网：https://openwebui.com
- 官方文档：https://docs.openwebui.com
- GitHub：https://github.com/open-webui/open-webui
使用前准备
- 登录 88API，创建 API Key 并确认账户余额充足。
- 准备至少一个当前账户可用的准确模型 ID。
- 使用 Open WebUI 管理员账户登录；普通用户不能新增全站连接。
配置参数
| Open WebUI 字段 | 填写内容 |
|---|---|
| URL | https://88api.ai/v1 |
| Auth | Bearer |
| API Key | 在 88API 控制台创建的 API Key |
| Provider Type | OpenAI |
| Model IDs | 可留空自动获取，或手动添加准确模型 ID |
这里必须保留 /v1
Open WebUI 的 URL 字段需要填写 API 基础地址，因此应使用
https://88api.ai/v1。
图形界面配置
- 打开 Open WebUI，点击左下角头像进入 Admin Panel / 管理员面板。
- 进入 Settings → Connections → OpenAI，点击 Add Connection。
- 在连接编辑窗口中填写 URL 和 API Key，认证方式保持 Bearer。
下图以 Open WebUI 官方兼容服务商连接窗口为底图，仅将 URL 和模型 ID 替换为 88API 示例值；API Key 始终保持遮盖。
-
如果模型列表可以正常获取，
Model IDs可以留空。 -
如果只想展示部分模型，或连接检查无法取得模型列表，点击加号手动加入准确模型 ID。
-
点击 Save 保存连接。
-
返回新对话页面，在模型选择器中选择刚添加的模型并发送一条测试消息。
Docker 环境变量配置
自托管管理员也可以在部署 Open WebUI 时设置环境变量：
OPENAI_API_BASE_URL=https://88api.ai/v1
OPENAI_API_KEY=<你的 88API API Key>修改后需要重新创建或重启 Open WebUI 容器。多连接部署还可以使用官方提供的
OPENAI_API_BASE_URLS、OPENAI_API_KEYS 或 OPENAI_API_CONFIGS，具体格式请以
当前版本的环境变量文档为准。
验证是否成功
- 在 Open WebUI 中选择 88API 模型并发送简单问题。
- 确认回答可以正常流式返回。
- 打开 88API 控制台的使用日志，确认出现对应模型的请求记录。
只看到模型名称不代表调用已经成功；应同时完成一次真实对话和日志核对。
常见问题
连接检查失败，但接口地址和密钥都正确
Open WebUI 的连接检查会请求 /v1/models。如果模型列表接口暂时不可用，可以先在
Model IDs 中手动加入准确模型 ID，再进行实际对话测试。
模型列表为空
确认 URL 是 https://88api.ai/v1，然后刷新连接。仍为空时，从 88API 模型列表复制
准确模型 ID，使用 Model IDs 手动添加。
返回 401
API Key 无效、已删除或复制时带有空格。请重新复制密钥并保存连接，不要把完整密钥 发到聊天、截图或公开日志中。
Responses API 是否需要开启
基础对话优先使用 OpenAI Chat Completions 兼容方式。只有确认当前模型和渠道支持 Responses API 时才启用相关实验选项。