Open WebUI 可以通过 OpenAI-compatible connection 连接 XiuRouter。连接地址使用 https://router-api.xiu.ai/v1。
前置条件
- 你有 Open WebUI 管理权限。
- 已创建一把 Open WebUI 专用 XiuRouter API Key。
- 已从 XiuRouter 当前目录复制模型 ID。
添加连接
- 打开 Admin Settings → Connections。
- 在 OpenAI 连接区域选择新增连接。
- URL 填
https://router-api.xiu.ai/v1。 - API Key 填 XiuRouter API Key。
- 保存并执行连接验证。
Open WebUI 会尝试从 /v1/models 读取这把 Key 可访问的模型。模型列表为空时，先检查 Key 的服务分组和模型范围，不要直接添加一个猜测的模型名。
验证
- 新建聊天，选择 XiuRouter 返回的精确模型 ID。
- 发送一个短文本请求。
- 在 XiuRouter“使用记录”核对模型、服务分组、状态和费用。
- 需要工具或图片时，再按目标模型单独验证。
Open WebUI 自带的 Web Search、知识库、文件处理和其他 Workspace 工具不等于模型 API 能力。修改 Base URL 不会把这些托管功能迁移到 XiuRouter。
常见失败
| 现象 | 处理 |
|---|---|
连接验证返回 401 |
重新保存有效 XiuRouter API Key |
| 模型列表为空 | 检查 Key 的分组、模型限制和 /v1/models 响应 |
| 聊天请求走错地址 | 确认 URL 以 /v1 结尾 |
| 普通聊天成功但工具失败 | 换用已验证工具能力的模型，并单独检查 Open WebUI 工具设置 |
回滚
在 Admin Settings → Connections 禁用或删除 XiuRouter 连接，再切回原模型。确认没有 Workspace 仍引用该连接后，撤销测试 Key。
来源与核对日期
本文按 Open WebUI 当前 OpenAI-compatible connection 设置和 XiuRouter 模型列表、Chat Completions 路由核对，日期为 2026-08-19。本轮未运行真实 Open WebUI 计费任务。