---
title: "Connect Open WebUI to XiuRouter"
description: "Add an OpenAI-compatible connection in Open WebUI admin settings and verify model discovery and replies."
image: "https://docs.xiu.ai/og.png"
---

> XiuAI documentation index
> Full documentation index: https://docs.xiu.ai/en/llms.txt
> Check the index for current pages before reading.

# Connect Open WebUI to XiuRouter

Add a separate XiuRouter OpenAI-compatible connection. Keep existing connections for rollback. XiuRouter supplies `/v1/models`, so there is no need to preselect a model on the integrations page.

## Choose a setup method

- First setup: add and save a XiuRouter connection.
- Existing setup: retain the original connection and add XiuRouter separately.
- Chat-assisted setup: unavailable; Open WebUI's admin settings store credentials and connections.

## Before you start

You need Open WebUI admin access and a dedicated XiuRouter API key.

## Add the connection

1. Open **Admin Settings → Connections**.
2. Add a connection in the **OpenAI** section.
3. Enter `https://router-api.xiu.ai/v1` as the URL.
4. Enter the XiuRouter key.
5. Save and run connection verification.

Keep the old connection enabled. Open WebUI fetches the models available to the key from `/v1/models`. If the list is empty, check the key's group and model scope rather than inventing a model name.

## Verify

1. Start a new chat and choose an exact returned model ID.
2. Send a short request.
3. Inspect the key, model, `/v1/chat/completions`, and success status in XiuRouter.
4. Test tools or images separately when required.

Open WebUI's Web Search, knowledge bases, file processing, and Workspace tools are separate from the model API. Changing the Base URL does not migrate those hosted features to XiuRouter.

## Troubleshoot

| Symptom | Next step |
| --- | --- |
| Connection check returns `401` | Save a valid key again |
| Empty model list | Check the key's group, model restrictions, and `/v1/models` response |
| Requests use the wrong endpoint | Ensure the URL ends with `/v1` |
| Chat works but tools fail | Choose a model with verified tools and inspect Open WebUI's tool settings |

## Roll back

Disable or remove the XiuRouter connection in admin settings and select the original model. Revoke the test key after confirming that no Workspace still references it.

## Sources and review date

Reviewed on 2026-08-31. This translation preserves that date. Basic setup requires a full reply and the matching successful request record.

Source: https://docs.xiu.ai/en/router/integrations/open-webui/index.mdx