Que signifie « proxy » dans SillyTavern ?
Dans les communautés de roleplay IA, un proxy désigne tout simplement une URL d'endpoint API placée entre votre interface de chat (comme SillyTavern ou JanitorAI) et un fournisseur de modèles d'IA en amont tel qu'Anthropic, Google ou DeepSeek. Quand vous envoyez un message, votre interface transmet le prompt assemblé à cette adresse, le service fait suivre la requête au modèle, et la réponse s'affiche en direct sur votre écran.
Si les joueurs ont pris l'habitude d'appeler presque toutes les URL d'API tierces des « proxys », c'est à cause du nom donné à ces champs dans les applications elles-mêmes. Dans SillyTavern, les panneaux natifs de Claude et de Google AI Studio rangent les URL tierces sous une section intitulée Reverse Proxy, et JanitorAI place la configuration d'une API externe dans un onglet baptisé Proxy.
Pourtant, si vous passez cinq minutes sur les forums ou les serveurs Discord de la communauté, vous verrez les habitués déconseiller vivement aux nouveaux venus d'utiliser des proxys. Cette méfiance est tout à fait justifiée. Dans le milieu du RP, le mot « proxy » reste fortement associé aux liens communautaires gratuits qui circulent sur des pages anonymes — des endpoints qui tournent sur des clés API fuitées ou volées, enregistrent en douce les discussions privées des joueurs, remplacent des modèles coûteux par de petits modèles au rabais et disparaissent du jour au lendemain.
Pour ne pas tout mélanger, il faut distinguer l'intitulé du bouton dans l'interface de la façon dont le service fonctionne réellement derrière :
- Un proxy gratuit ou à clé partagée vous donne une simple URL publique (ou un mot de passe partagé sur un salon de discussion), sans facturation claire ni responsable identifiable, généralement financé par des comptes d'essai détournés ou des clés compromises.
- Un proxy API payant (ou passerelle API) fonctionne comme n'importe quel service cloud classique : vous vous connectez à votre propre compte, vous générez une clé API privée et vous payez au token pour accéder à des modèles en amont clairement identifiés.
Dans la suite de ce guide, nous utilisons le mot proxy partout où l'interface de votre application l'affiche à l'écran (Reverse Proxy, Proxy URL), et le terme API pour désigner normalement le service auquel vous vous connectez.
De quel type de proxy avez-vous besoin ?
Avant de modifier le moindre fichier de configuration, vérifiez que le tutoriel ou le message de forum que vous lisez parle bien du même type de proxy que celui que vous cherchez. Dans la documentation de SillyTavern et les discussions communautaires, le mot « proxy » sert à désigner quatre outils qui n'ont rien à voir entre eux :
| Comment on l'appelle | Où vous le croisez | Ce qu'il fait réellement | En avez-vous besoin pour discuter avec une IA ? |
|---|---|---|---|
| 1. Proxy d'API de modèle (Custom Endpoint / Reverse Proxy) | Panneau API Connections de SillyTavern ; API Settings → Proxy dans JanitorAI | Transmet votre prompt de roleplay en HTTPS vers un fournisseur de modèles d'IA (Claude, Gemini, DeepSeek) à l'aide d'une clé API. | Oui — sauf si vous utilisez directement la clé API officielle du fournisseur du modèle ou si vous faites tourner un modèle local sur votre propre carte graphique. |
2. Proxy réseau sortant (config.yaml) | Fichier config.yaml à la racine de SillyTavern (paramètres de proxy HTTP / SOCKS) | Fait passer les requêtes internet sortantes de SillyTavern par un tunnel réseau ou un client de type VPN sur votre machine. | Non — sauf si votre connexion internet locale bloque le trafic sortant et impose un proxy réseau système. |
3. Reverse proxy web auto-hébergé (nginx, Caddy) | Guides d'hébergement sur VPS Linux et d'accès à distance | Se place devant votre propre serveur SillyTavern (localhost:8000) pour ajouter le chiffrement HTTPS et un nom de domaine lorsque vous ouvrez SillyTavern hors de chez vous. | Non — utile uniquement si vous exposez votre propre serveur SillyTavern sur internet (la plupart des joueurs utilisent plutôt Tailscale ; voir notre guide d'installation). |
4. Ancien script intermédiaire local (simple-proxy-for-tavern) | Anciens tutoriels de configuration de 2023–2024 | Un script local séparé qu'il fallait faire tourner sur son PC pour convertir les formats d'API avant que SillyTavern ne les prenne en charge nativement. | Non — obsolète dans les versions actuelles de SillyTavern, qui se connectent directement aux API compatibles OpenAI, Claude et Gemini. |
Astuce : Si vous venez d'installer SillyTavern ou d'ouvrir JanitorAI et que vous voulez simplement brancher Claude, Gemini ou DeepSeek pour vos RP, vous avez uniquement besoin du n° 1 (un endpoint d'API de modèle). Ne touchez pas aux réglages de proxy réseau dans le fichier config.yaml de SillyTavern, et ignorez les vieux guides qui vous demandent de lancer nginx ou des scripts locaux.
Où faut-il coller l'URL du proxy ?
Toutes les applications de roleplay demandent les trois mêmes éléments — une URL d'endpoint, une clé API et un ID de modèle — mais chaque interface attend un format de chemin d'URL légèrement différent. Voici l'emplacement exact de ces champs dans chaque client, en prenant TavernAPI et nos cinq ID de modèles (claude-opus-5-5, claude-sonnet-5-5, gemini-4-argon, gemini-3.8-flash et deepseek-v4-pro) comme exemples concrets.
SillyTavern : Chat Completion → Custom (OpenAI-compatible)
Passer par Custom (OpenAI-compatible) est la méthode la plus propre dans SillyTavern, car une seule URL et une seule clé vous permettent de basculer entre Claude, Gemini et DeepSeek depuis le même menu déroulant :
- Cliquez sur l'icône API Connections (la prise électrique dans la barre supérieure).
- Réglez API sur
Chat Completion. - Réglez Chat Completion Source sur
Custom (OpenAI-compatible). - Renseignez les champs de connexion :
- Custom Endpoint (Base URL):
https://tavernapi.com/v1 - Custom API Key: Votre clé
sk-tav-...(créée sous Clés API dans la console utilisateur ; copiez-la tout de suite car elle ne s'affiche qu'une seule fois).
- Custom Endpoint (Base URL):
- Cliquez sur Connect, ouvrez le menu déroulant Available Models et sélectionnez
gemini-4-argon,claude-opus-5-5,gemini-3.8-flash,deepseek-v4-proouclaude-sonnet-5-5.
N'ajoutez pas /chat/completions à la fin du champ Custom Endpoint (Base URL) — SillyTavern ajoute ce suffixe automatiquement lors de l'envoi d'un message.
SillyTavern : champs Reverse Proxy pour Claude et Google AI Studio
Si vous utilisez un preset local conçu spécifiquement pour la source native Claude ou Google AI Studio de SillyTavern — ou si vous souhaitez accéder aux réglages d'interface propres à Claude ou Gemini — vous pouvez utiliser la section Reverse Proxy de SillyTavern au lieu de Custom (OpenAI-compatible).
- Ouvrez API Connections (l'icône de prise) et laissez API réglé sur
Chat Completion. - Réglez Chat Completion Source sur
Claudeou surGoogle AI Studio. - Cliquez sur Reverse Proxy pour déplier les champs du proxy et entrez l'URL correspondante :
- Pour la source Claude, réglez Proxy Server URL sur
https://tavernapi.com/v1 - Pour la source Google AI Studio, réglez Proxy Server URL sur
https://tavernapi.com(sans/v1à la fin, car SillyTavern ajoute lui-même le chemin versionné de Google)
- Pour la source Claude, réglez Proxy Server URL sur
- Dans Proxy Password, collez votre clé API
sk-tav-.... (SillyTavern appelle ce champ un mot de passe, mais c'est bien votre clé API qu'il faut y mettre.) - Cliquez sur Connect et sélectionnez
claude-opus-5-5ouclaude-sonnet-5-5sous Claude, ougemini-4-argonougemini-3.8-flashsous Google AI Studio.
Pour un pas-à-pas complet sur ces deux méthodes de connexion et l'importation de presets, consultez notre guide de configuration SillyTavern. Si vous rencontrez une erreur 402 en envoyant un message, voyez comment résoudre l'erreur 402 Insufficient Balance.
JanitorAI : API Settings → Proxy
JanitorAI est un site de personnages hébergé doté de son propre modèle intégré, mais il permet aussi de faire passer vos discussions par une API externe compatible OpenAI :
- Ouvrez n'importe quel chat sur JanitorAI, cliquez sur API Settings en haut de l'écran, puis sélectionnez l'onglet Proxy.
- Remplissez les trois champs requis :
- Proxy URL:
https://tavernapi.com/v1/chat/completions - API Key: Votre clé
sk-tav-... - Model: Tapez l'ID exact du modèle que vous souhaitez utiliser, comme
gemini-4-argon,claude-opus-5-5,gemini-3.8-flash,deepseek-v4-proouclaude-sonnet-5-5.
- Proxy URL:
- Enregistrez vos paramètres et lancez la discussion.
Remarque : L'erreur la plus fréquente lorsqu'on passe de SillyTavern à JanitorAI vient de la fin de l'URL. La source Custom de SillyTavern attend l'URL de base (https://tavernapi.com/v1), tandis que le champ Proxy URL de JanitorAI exige le chemin complet de complétion de chat (https://tavernapi.com/v1/chat/completions).
RisuAI, Agnaistic et autres applications compatibles OpenAI
D'autres interfaces de roleplay comme RisuAI et Agnaistic (Agnai) acceptent elles aussi n'importe quel endpoint personnalisé compatible OpenAI (consultez notre comparatif des meilleurs outils de roleplay IA pour voir comment fonctionne chaque application).
Pour savoir quel format d'URL une application attend, regardez l'exemple grisé affiché à l'intérieur du champ d'URL :
- Si l'exemple se termine par
/v1, entrezhttps://tavernapi.com/v1. - Si l'exemple se termine par
/v1/chat/completions, entrezhttps://tavernapi.com/v1/chat/completions.
Collez ensuite votre clé API sk-tav-... et indiquez l'un des cinq ID de modèles (gemini-4-argon, claude-opus-5-5, gemini-3.8-flash, deepseek-v4-pro ou claude-sonnet-5-5).
Pourquoi les proxys gratuits sont-ils risqués ?
Faire tourner de grands modèles de langage comme Claude et Gemini coûte de l'argent à chaque réplique — surtout en roleplay, où votre application renvoie des milliers de tokens de fiches de personnages et d'historique de conversation à chaque tour. La documentation officielle de SillyTavern comme celle de Chub mettent toutes deux les joueurs en garde contre les proxys tiers non vérifiés.
Lorsqu'une personne distribue un lien de proxy gratuit ou à un prix anormalement bas sans modèle économique clair, vous vous exposez à quatre risques bien réels :
- Les clés fuitées ou volées sont coupées sans préavis : Les proxys gratuits paient rarement leurs propres serveurs en amont. En pratique, leurs réserves de clés sont souvent récupérées sur des dépôts de code publics, ouvertes avec des moyens de paiement volés ou générées en boucle via des comptes d'essai cloud détournés. Dès que le fournisseur en amont repère le trafic anormal, les clés sont révoquées et votre proxy tombe en panne au beau milieu d'une scène.
- L'administrateur peut enregistrer et lire vos RP privés : Chaque message envoyé via un proxy transite en texte clair par le serveur de l'opérateur avant d'être transmis au modèle. Un administrateur anonyme sans politique de confidentialité peut enregistrer vos prompts, vos cartes de personnages, vos personas et votre adresse IP, sans que vous puissiez savoir où finissent ces journaux.
- Le modèle derrière l'endpoint n'est pas forcément celui annoncé : Comme le serveur proxy contrôle la requête sortante, un opérateur malhonnête peut recevoir une requête destinée à un grand modèle Claude ou Gemini et la rediriger en silence vers un modèle beaucoup plus petit et moins cher. Si un modèle censé être haut de gamme oublie soudainement la logique élémentaire de la scène ou produit des phrases plates et répétitives, il est possible que l'endpoint remplace le modèle en coulisses.
- Aucun support, aucun responsable et aucun remboursement : Les proxys informels et les serveurs Discord « sur don » peuvent fermer du jour au lendemain dès que leur stock de clés s'épuise. Il n'y a ni conditions d'utilisation publiées, ni support client, ni aucun moyen de récupérer votre argent si vous avez payé pour un accès partagé.
Comment vérifier un proxy avant de payer ?
Pas besoin d'être ingénieur réseau pour faire la différence entre un service d'API sérieux et un bricolage douteux. Passez n'importe quel fournisseur au crible de ces sept points avant de recharger un compte :
- Il indique ses fournisseurs en amont pour chaque modèle : Un service digne de confiance précise clairement quel canal cloud ou API officiel sert chaque modèle (comme AWS, Google Cloud, Google AI Studio ou l'API officielle DeepSeek), au lieu de se cacher derrière de vagues « routes privées ».
- Vous payez votre propre consommation selon une grille tarifaire publique et datée : Cherchez une page de tarifs publique affichant une date de dernière mise à jour, où vous êtes facturé au token (ou via des packs de crédit clairement expliqués) sur votre propre clé API personnelle.
- Une politique de confidentialité précise ce qui est conservé et ce qui ne l'est pas : Vérifiez la présence d'une vraie page de politique de confidentialité qui distingue explicitement les métadonnées de facturation (nombre de tokens, nom du modèle, horodatage et coût) du texte privé de vos prompts et de vos cartes de personnages.
- L'équipe est joignable et les conditions d'utilisation sont publiées : Assurez-vous que le site publie des conditions d'utilisation et propose plusieurs moyens de contact fonctionnels — comme un e-mail, Telegram ou Discord — pour joindre une vraie personne en cas de souci lors d'un rechargement.
- Le modèle qui répond correspond bien au modèle sélectionné : Testez l'endpoint avec une carte de personnage ou une scène à plusieurs protagonistes que vous connaissez déjà par cœur, afin de vérifier que le style de prose, la finesse du raisonnement et la vitesse de réponse correspondent bien au modèle d'origine.
- Le tarif est réaliste, loin des promesses de « Claude gratuit et illimité » : Les remises sur volume d'entreprise et la mise en cache du prompt côté serveur permettent légitimement de réduire le prix au token ; en revanche, quiconque promet du « Claude gratuit et illimité » à prix fixe utilise des méthodes que vous n'avez pas envie d'associer à votre compte.
- Vous pouvez commencer par un petit montant et vérifier le journal d'utilisation : Ne déposez jamais une grosse somme dès le premier jour sur un service que vous ne connaissez pas ; commencez par un essai gratuit ou le plus petit rechargement possible, envoyez quelques messages de test et vérifiez que l'historique d'utilisation dans la console correspond bien aux tarifs au token affichés.
Où se situe TavernAPI ?
Par souci d'équité, appliquons exactement cette même grille en sept points à TavernAPI, sans cacher non plus les limites de notre service :
- Canaux officiels clairement nommés : Nous proposons cinq modèles à fenêtre de contexte de 1M choisis spécialement pour le roleplay (lire notre classement détaillé des modèles).
claude-opus-5-5etclaude-sonnet-5-5passent par AWS et Google Cloud,gemini-4-argonetgemini-3.8-flashpassent par Google AI Studio, etdeepseek-v4-propasse par l'API officielle DeepSeek. - Tarifs au token en USD datés : Tous les tarifs d'entrée, de sortie et de cache sont publiés en USD par million de tokens sur notre page des tarifs. Nous appliquons également la mise en cache du prompt automatique côté serveur sur chaque connexion pour réduire le coût d'entrée des longues discussions, et nous affichons le montant exact économisé en dollars sous l'onglet Utilisation de la console utilisateur.
- Aucun stockage du contenu de vos discussions : Comme détaillé dans notre Politique de confidentialité, TavernAPI ne stocke ni le contenu de vos messages, ni vos cartes de personnages, ni vos lorebooks, ni les réponses de l'IA. Pour la facturation, nous enregistrons uniquement le nombre de tokens, l'horodatage de la requête, l'ID du modèle et le coût.
- Équipe joignable et conditions claires : Nous publions des Conditions d'utilisation complètes et proposons une assistance directe par Telegram, Discord ou e-mail sur notre page de contact.
- Testez avant de payer : Les nouveaux comptes reçoivent un essai gratuit de $0.30 valable sur
gemini-4-argonetgemini-3.8-flash, ce qui vous permet de vérifier la qualité des modèles et d'inspecter le détail des tokens par requête dans la console avant de dépenser le moindre centime. Pour les joueurs sur SillyTavern, nous proposons aussi des presets narratifs optionnels qui combinent options modifiables en local et consignes principales développées côté serveur.
Nos limites en toute franchise : TavernAPI n'est plus gratuit une fois votre crédit d'essai de $0.30 épuisé. Comme chaque requête passe par les fournisseurs officiels en amont, les filtres de sécurité propres à ces fournisseurs restent actifs (en revanche, nous ne bannissons jamais votre compte simplement parce qu'un modèle en amont a refusé un prompt). Enfin, nous ne proposons que les cinq modèles Claude, Gemini et DeepSeek listés ci-dessus : si vous cherchez les modèles GPT d'OpenAI ou des dizaines de petits modèles open-weights affinés, une autre passerelle vous conviendra mieux.