Guide d'intégration SillyTavern

Vue d'ensemble

SillyTavern communique avec UnoRouter via la source Chat Completion. Vous collez la base URL, votre clé API, et choisissez un modèle dans le dropdown rempli automatiquement. Pas de serveur proxy, pas de tunnel inverse, aucune configuration supplémentaire.

Configuration rapide

Copiez ces trois valeurs dans les champs de la source Custom (compatible OpenAI) de SillyTavern.

Base URL: https://api.unorouter.ai/v1
Clé API:  YOUR_API_KEY
Modèle:    claude-opus-4-5

Ne collez que la base URL. SillyTavern ajoute `/chat/completions` automatiquement. L'ajouter vous-même provoquera une erreur 400.

Configuration pas à pas

1. 1
   Ouvrir la configuration des réponses IA

   Dans SillyTavern, cliquez sur l'icône en forme de prise en haut pour ouvrir le panneau API Connections.

2. 2
   Sélectionner Chat Completion

   Définissez le type d'API sur Chat Completion.

3. 3
   Choisir Custom (compatible OpenAI)

   Dans le dropdown Chat Completion Source, choisissez Custom (OpenAI-compatible).

4. 4
   Coller la base URL

   Saisissez la base URL de UnoRouter se terminant par `/v1`. N'ajoutez pas `/chat/completions`.

5. 5
   Coller votre clé API

   Collez votre clé API UnoRouter dans le champ Custom API Key.

6. 6
   Se connecter et choisir un modèle

   Cliquez sur Connect. Le dropdown Model se remplit automatiquement à partir de la liste de modèles de UnoRouter ; choisissez celui que vous souhaitez.

7. 7
   Optionnel : contourner la vérification du statut

   Si SillyTavern affiche toujours une bannière d'avertissement alors que les messages passent, activez Bypass API Status Check.

Comportement du dropdown des modèles

SillyTavern appelle `GET /v1/models` sur votre base URL pour remplir le sélecteur de modèles. UnoRouter expose cet endpoint, donc le dropdown se remplit automatiquement. S'il reste vide, repliez-vous sur le champ texte Custom Model ID et tapez vous-même le nom du modèle.

Dépannage

• Erreur 400 Bad Request à chaque message. Vous avez ajouté `/chat/completions` à l'URL. Retirez-le ; la base URL doit se terminer par `/v1`.
• Le dropdown des modèles est vide. La connexion a échoué. Revérifiez la base URL, puis activez Bypass API Status Check pour que SillyTavern cesse de court-circuiter la liste.
• Erreur 401 Unauthorized. La clé API est expirée ou mal saisie. Générez-en une nouvelle depuis votre tableau de bord UnoRouter et collez-la sans espace avant ou après.
• Erreur 429 Too Many Requests. Vous avez atteint la limite de débit de votre offre actuelle. Attendez une minute ou passez à une offre supérieure sur la page de facturation de UnoRouter.
• Erreurs SSL ou de certificat. L'horloge de votre système est désynchronisée. Synchronisez-la puis réessayez ; SillyTavern utilise le magasin de confiance du système.
• Le streaming se coupe en milieu de phrase. Désactivez Streaming dans les paramètres de génération pour confirmer que le problème vient bien du streaming, puis réactivez-le. Les proxys d'entreprise qui retirent le préfixe `data:` peuvent aussi en être la cause.