--- title: "将 Open WebUI 接入 XiuRouter" description: "首次新增 XiuRouter OpenAI-compatible connection,或保留 Open WebUI 原连接后切换。" image: "https://docs.xiu.ai/og.png" --- > XiuAI 文档索引 > 完整文档索引:https://docs.xiu.ai/llms.txt > 阅读前先通过索引确认当前可用页面。 # 将 Open WebUI 接入 XiuRouter 首次配置直接新增一个 XiuRouter OpenAI-compatible connection。已经在使用 Open WebUI 时,保留原连接作为回滚路径。XiuRouter 提供 `/v1/models`,不需要先在集成页选择模型。 ## 选择配置方式 - 首次配置:新增 XiuRouter 连接并保存。 - 替换已有:保留原连接,新增独立的 XiuRouter connection。 - 对话协助:不提供。连接和凭据由 Open WebUI 管理设置保存。 ## 前置条件 - 你有 Open WebUI 管理权限。 - 已创建一把 Open WebUI 专用 XiuRouter API Key。 ## 新增连接 1. 打开 **Admin Settings → Connections**。 2. 在 **OpenAI** 连接区域选择新增连接。 3. URL 填 `https://router-api.xiu.ai/v1`。 4. API Key 填 XiuRouter API Key。 5. 保存并执行连接验证。 旧连接保持启用,便于回滚。Open WebUI 会从 `/v1/models` 读取这把 Key 可访问的模型。模型列表为空时,先检查 Key 的服务分组和模型范围,不要添加猜测的模型名。 ## 验证 1. 新建聊天,选择 XiuRouter 返回的精确模型 ID。 2. 发送一个短文本请求。 3. 在 XiuRouter 控制台“检查实际请求”核对 Key、模型、`/v1/chat/completions` 和成功状态。 4. 需要工具或图片时,再按目标模型单独验证。 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“检查实际请求”中出现对应模型、接口和成功状态后,基础接入才算完成。 源文件:https://docs.xiu.ai/router/integrations/open-webui/index.mdx