首次配置直接新增一个 XiuRouter OpenAI-compatible connection。已经在使用 Open WebUI 时，保留原连接作为回滚路径。XiuRouter 提供 /v1/models，不需要先在集成页选择模型。
选择配置方式
- 首次配置：新增 XiuRouter 连接并保存。
- 替换已有：保留原连接，新增独立的 XiuRouter connection。
- 对话协助：不提供。连接和凭据由 Open WebUI 管理设置保存。
前置条件
- 你有 Open WebUI 管理权限。
- 已创建一把 Open WebUI 专用 XiuRouter API Key。
新增连接
- 打开 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 控制台“检查实际请求”核对 Key、模型、
/v1/chat/completions和成功状态。 - 需要工具或图片时，再按目标模型单独验证。
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。
来源与核对日期
内容核对于 2026-08-31。Open WebUI 收到完整回复，并在 XiuRouter“检查实际请求”中出现对应模型、接口和成功状态后，基础接入才算完成。