Open WebUI
Self-hosted chat UI · Chat Completions
One connection in the admin panel and Open WebUI pulls the whole KoRouter catalog into its model picker by itself.
Base URL · OpenAI-compatible
https://korouter.ai/v1
Plus an API key from Keys and a bare model ID from Models. Every price on the catalog sits below the provider's official rate — pay as you go.
Setup
- 1. Open Admin Panel → Settings → Connections.
- 2. Under OpenAI API, add
https://korouter.ai/v1with your key. - 3. Save. Open WebUI loads the model list from
GET /v1/modelsinto the picker.
Verify
The model selector lists KoRouter model IDs. Send a message and confirm the call on Usage.
If it fails
- empty model picker — re-verify the connection — a mistyped URL or key keeps the list empty. The model list itself works even at zero balance.
- too many models — use the connection's model filter to expose only the IDs your members should see.
- surprise spend — every chat message is a normal billed API call; the key's spend limit still applies.
Troubleshooting
The failures below account for nearly every unsuccessful first connection, whatever the tool.
| Status | Symptom | Fix |
|---|---|---|
| 401 | Key missing, mistyped, or deleted | Re-copy the key from Keys and confirm which header your tool sends — Authorization: Bearer or x-api-key. |
| 403 | No credits on the account (INSUFFICIENT_BALANCE) | Add credits first. Verify buttons and test prompts inside tools fire real requests. |
| 404 | Model not found | Send the bare model ID exactly as listed on Models — no provider/ prefix in the request body. |
| 429 | Concurrency or key spend limit reached | Lower parallel requests, or raise the key's spend limit, then retry with backoff. |
The full status-code table, retry guidance, and error envelopes are in Errors & limits. Still stuck? Email support@korouter.ai with the tool name, the model ID, and the exact error text.
Other tools
Free to sign up, no monthly fee — pay as you go with credits.