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

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.