---
title: "将 Open WebUI 接入 XiuRouter"
description: "在 Open WebUI 管理设置中添加 XiuRouter OpenAI 兼容连接，并验证模型列表和聊天请求。"
image: "https://docs.xiu.ai/og.png"
---

> XiuAI 文档索引
> 完整文档索引：https://docs.xiu.ai/llms.txt
> 阅读前先通过索引确认当前可用页面。

# 将 Open WebUI 接入 XiuRouter

Open WebUI 可以通过 OpenAI-compatible connection 连接 XiuRouter。连接地址使用 `https://router-api.xiu.ai/v1`。

## 前置条件

- 你有 Open WebUI 管理权限。
- 已创建一把 Open WebUI 专用 XiuRouter API Key。
- 已从 XiuRouter 当前目录复制模型 ID。

## 添加连接

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“使用记录”核对模型、服务分组、状态和费用。
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。

## 来源与核对日期

本文按 Open WebUI 当前 OpenAI-compatible connection 设置和 XiuRouter 模型列表、Chat Completions 路由核对，日期为 2026-08-19。本轮未运行真实 Open WebUI 计费任务。

源文件：https://docs.xiu.ai/router/integrations/open-webui/index.mdx