Open WebUI 接入

Open WebUI 是自托管的 AI Web 平台，通过 Connections 添加 OpenAI 兼容连接接入 Router。

• 协议：OpenAI Chat Completions
• 接入地址：https://routerapi.<你的域名>/v1

准备工作

1. 登录 Router 控制台，签发一个 Key 并保存明文
2. 在控制台「快速接入」页记下 OpenAI Chat Completions 协议的接入地址
3. Open WebUI 管理员账号（Connections 配置需要管理员权限）

配置

1. 打开 Open WebUI → 左下角头像 → Admin Panel（管理员面板）
2. 进入 Settings → Connections
3. 在 OpenAI API 部分点 + 添加连接：
   • URL 填：https://routerapi.<你的域名>/v1
   • API Key 填你的 Key
4. 保存。Open WebUI 会自动拉取 /v1/models 的模型列表；如需指定模型，可在连接里显式填写模型名（控制台「可用模型」列表中的名称）

验证

回到主界面新建对话，顶部选择刚接入的模型，发一条消息。正常流式回复即接入成功；控制台「调用记录」出现调用明细。

常见问题

Q：保存连接后模型列表为空？ 检查 URL 以 /v1 结尾、Key 有效；Open WebUI 服务端所在网络需要能访问数据面域名。也可以在该连接上直接手写模型名跳过自动发现。

Q：普通用户看不到该连接？ Connections 默认对管理员可见；在 Admin Panel 的模型管理里把模型对目标用户组开放。