Configurer l'API SillyTavern : URL de base, clé API et liste de modèles

Réponse rapide : les cinq réglages qui comptent

Ouvrez le panneau API Connections (l'icône de prise) et configurez exactement ceci : API = Chat Completion. Chat Completion Source = Custom (OpenAI-compatible). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = votre clé sk-... . Cliquez sur Connect, attendez le voyant vert, et choisissez un modèle dans la liste déroulante, par exemple deepseek-v4-flash. L'erreur la plus courante, et de loin, consiste à coller le chemin complet. SillyTavern ajoute /chat/completions à ce que vous saisissez, donc l'URL doit s'arrêter à /v1. Si vous collez https://api.apisrouter.com/v1/chat/completions, SillyTavern appelle /v1/chat/completions/chat/completions et la connexion échoue avec une erreur 404. C'est l'inverse de JanitorAI, qui veut l'URL complète de completions dans sa configuration de proxy. Même fournisseur, conventions de champs différentes.

Pourquoi l'URL de l'API SillyTavern s'arrête à /v1

Toute API compatible OpenAI est une URL de base plus un ensemble de routes fixes. GET /v1/models renvoie la liste des ID de modèles que votre clé peut utiliser. POST /v1/chat/completions exécute la requête de chat proprement dite. SillyTavern connaît ces routes et les construit lui-même, donc il ne vous demande que la base. Quand vous cliquez sur Connect, il appelle /v1/models avec votre clé et utilise la réponse pour remplir la liste déroulante de modèles. Une liste vide signifie presque toujours que cet appel a échoué. Vous devez aussi choisir le bon mode d'API. Chat Completion envoie des messages structurés avec des rôles system, user et assistant, ce qu'attend tout fournisseur hébergé compatible OpenAI. Text Completion envoie une seule chaîne de prompt brute et existe surtout pour des backends locaux comme KoboldCpp et text-generation-webui. Pour toute clé d'API hébergée, utilisez Chat Completion. Si vous sélectionnez Text Completion contre un endpoint de chat hébergé, vous obtiendrez des erreurs ou un formatage illisible, et plusieurs samplers affichés dans ce mode ne s'appliquent de toute façon pas.

Configuration étape par étape

Si la liste reste vide après Connect, vérifiez trois choses dans l'ordre : l'URL s'arrête bien à /v1 sans chemin supplémentaire ni espaces en trop, la clé est collée sans guillemets ni espaces, et la source est Custom (OpenAI-compatible) plutôt que OpenAI simple. La source OpenAI simple ignore votre URL personnalisée sur certaines versions et parle à api.openai.com, où votre clé n'est pas valide.

• Obtenez une clé. Chez APIsRouter, il n'y a pas de formulaire de compte : vous payez sur /topup et la clé vous est envoyée par e-mail. Toute clé compatible OpenAI fonctionne de la même façon dans ces étapes.
• Dans SillyTavern, cliquez sur l'icône de prise pour ouvrir API Connections.
• Réglez API sur Chat Completion.
• Réglez Chat Completion Source sur Custom (OpenAI-compatible).
• Dans Custom Endpoint (Base URL), saisissez https://api.apisrouter.com/v1 sans rien après /v1.
• Collez votre clé dans le champ Custom API Key.
• Cliquez sur Connect. Le voyant de statut passe au vert et la liste Available Models se remplit depuis /v1/models.
• Sélectionnez un modèle, ouvrez une fiche de personnage et envoyez un court message de test.

Vérifier la connexion en dehors de SillyTavern

Quand quelque chose échoue, testez l'endpoint directement avant d'accuser SillyTavern. Cet appel curl fait exactement ce que fait le bouton Connect. S'il renvoie un tableau JSON d'ID de modèles, votre clé et votre URL sont correctes et le problème vient des champs de SillyTavern. Si la liste de modèles fonctionne mais que les chats échouent, lancez une vraie completion depuis Python avec la même URL de base. Une réponse réussie ici prouve que toute la chaîne fonctionne, et tout message d'erreur que vous recevez est l'erreur réelle du fournisseur plutôt que le message générique de SillyTavern.

curl https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

Les bases des samplers et des presets

Les sources Chat Completion exposent un petit ensemble de samplers : temperature, top P, frequency penalty et presence penalty, plus la longueur de réponse et la taille de contexte. Les samplers plus avancés dont vous avez peut-être entendu parler (min P, mirostat, dynamic temperature) appartiennent aux backends Text Completion et ne sont tout simplement pas envoyés aux API de chat hébergées, donc ne les cherchez pas ici. Les presets de SillyTavern regroupent deux choses : les valeurs de sampler et la structure de prompt que le Prompt Manager assemble à partir de votre fiche de personnage, de votre persona et de votre lorebook. Le preset Default intégré est un bon point de départ. Changez une valeur à la fois et régénérez la même scène pour voir ce qu'elle fait réellement. La taille de contexte mérite de l'attention : SillyTavern remplit la fenêtre de contexte avec l'historique du chat, donc un contexte plus grand veut dire plus de tokens de prompt envoyés à chaque tour, ce qui améliore la mémoire et augmente le coût par message en même temps.

Modèles recommandés pour SillyTavern

Le choix du modèle compte plus que le réglage des samplers. Le consensus de la communauté, dans la limite de rapports approximatifs, place la famille DeepSeek V4 en tête sur le prix : deepseek-v4-flash est la recommandation par défaut pour les chats longs et deepseek-v4-pro tient mieux ensemble les fiches complexes et les chats de groupe. GLM-5, Kimi K2.6 et MiMo sont de bons choix de rapport qualité-prix avec des voix de prose distinctes, à faire tourner quand un chat commence à sembler répétitif. Grok se distingue parce que la politique publiée par xAI autorise explicitement les thèmes matures dans des contextes fictifs, ce qui compte pour les intrigues plus sombres. Claude écrit la meilleure prose de cette liste, mais la politique d'Anthropic interdit le contenu explicite, donc traitez Claude comme le choix pour l'écriture créative SFW et les scènes de style littéraire. Deux remarques pratiques. D'abord, SillyTavern est un logiciel destiné aux adultes, et chaque modèle ici applique la politique de contenu de son propre fournisseur quel que soit votre frontend, donc gardez vos fiches et vos scènes dans ces règles. Ensuite, comme la liste se remplit en direct depuis /v1/models, vous pouvez changer de modèle en cours de chat et comparer les réponses au même message, la façon la plus rapide de trouver votre favori.

Ce que coûtent vraiment les chats SillyTavern

Les modèles hébergés facturent par token, et le roleplay consomme beaucoup d'entrée : chaque tour renvoie la fiche de personnage plus l'historique récent. Un tour qui envoie 8 000 tokens de prompt et reçoit une réponse de 350 tokens coûte environ un dixième de centime sur deepseek-v4-flash, donc quelques dollars couvrent des mois de chat occasionnel. Le même tour sur claude-opus-4-7 coûte environ 25 fois plus, c'est pourquoi la plupart des gens utilisent un modèle bon marché au quotidien et gardent les modèles premium pour les scènes qui comptent vraiment pour eux. Une seule clé de gateway couvre tout ce tableau. APIsRouter est un gateway compatible OpenAI avec facturation à la consommation et sans abonnement : vous payez sur /topup sans créer de compte, la clé arrive par e-mail, votre première recharge ajoute +100% à votre solde, les modèles globaux sont facturés 20% en dessous des tarifs officiels, et les modèles chinois restent sous leurs prix officiels.

Questions fréquentes