Search docs...

Start typing to search documentation

SillyTavern

SillyTavern Integration Guide

Connect UnoRouter to SillyTavern through the Custom OpenAI-compatible chat completion source.

What is SillyTavern?

SillyTavern is a self-hosted roleplay and character chat frontend for large language models. It runs locally, stores characters and chats on your own machine, and supports any OpenAI-compatible API as its chat completion source.

Overview

SillyTavern talks to UnoRouter through the Chat Completion source. You paste the base URL, your API key, and pick a model from the auto-populated dropdown. No proxy server, no reverse tunnel, no extra setup.

Quick Config

Copy these three values into the Custom (OpenAI-compatible) source fields in SillyTavern.

text
Base URL: https://api.unorouter.ai/v1
API Key:  YOUR_API_KEY
Model:    claude-opus-4-5

Sign in to auto-fill your API key

Paste the base URL only. SillyTavern appends `/chat/completions` automatically. Adding it yourself will cause a 400 error.

Step-by-step setup

  1. 1
    Open AI Response Configuration

    In SillyTavern, click the plug icon at the top to open the API Connections panel.

  2. 2
    Select Chat Completion

    Set the API type to Chat Completion.

  3. 3
    Pick Custom (OpenAI-compatible)

    In the Chat Completion Source dropdown, choose Custom (OpenAI-compatible).

  4. 4
    Paste the base URL

    Enter UnoRouter's base URL ending in `/v1`. Do not add `/chat/completions`.

  5. 5
    Paste your API key

    Paste your UnoRouter API key into the Custom API Key field.

  6. 6
    Connect and pick a model

    Click Connect. The Model dropdown auto-populates from UnoRouter's model list; pick the one you want.

  7. 7
    Optional: bypass status check

    If SillyTavern still shows a warning banner even though messages go through, enable Bypass API Status Check.

Model dropdown behavior

SillyTavern calls `GET /v1/models` on your base URL to populate the model picker. UnoRouter exposes this endpoint, so the dropdown fills automatically. If it ever comes up empty, fall back to the Custom Model ID text field and type the model name yourself.

Troubleshooting

  • 400 Bad Request on every message. You appended `/chat/completions` to the URL. Remove it; the base URL must end at `/v1`.
  • Model dropdown is empty. The connection failed. Re-check the base URL, then toggle Bypass API Status Check so SillyTavern stops short-circuiting the list.
  • 401 Unauthorized. The API key is expired or mistyped. Generate a new one from your UnoRouter dashboard and paste it without leading or trailing spaces.
  • 429 Too Many Requests. You hit the rate limit on your current plan. Wait a minute or upgrade the plan on the UnoRouter billing page.
  • SSL or certificate errors. Your system clock is off. Sync it and retry; SillyTavern uses the system trust store.
  • Streaming cuts off mid-sentence. Disable Streaming in the generation settings to confirm the issue is on the stream side, then re-enable it. Corporate proxies that strip the `data:` prefix can also cause this.

Ready to chat?

Get your UnoRouter API key and start running SillyTavern against every model we support.