Guide d'intégration de l'API SillyTavern : Connectez GPTProto et commencez le jeu de rôle

Étape 1 : Installer et démarrer SillyTavern

SillyTavern exécute l'interface de chat, les cartes de personnages et les paramètres de prompt sur votre ordinateur. Un modèle connecté génère les réponses. La documentation officielle du projet le décrit comme une interface frontend gratuite et open-source.

Préparez Node.js LTS, Git, un compte GPT Proto avec un solde API disponible et un identifiant de modèle. L'inférence cloud via GPT Proto ne nécessite pas de télécharger les poids du modèle ni d'exécuter un modèle sur votre GPU.

Installation sur macOS

Téléchargez la version LTS depuis la page de téléchargement de Node.js, sélectionnez macOS et utilisez son installateur si vous préférez une installation graphique.

Choisissez la version LTS actuelle pour votre système d'exploitation.

Ouvrez le Terminal et vérifiez Git :

git --version

Installez Git si nécessaire, puis exécutez :

cd ~
git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern
bash start.sh

Le premier lancement installe les dépendances. Gardez le terminal ouvert pendant l'utilisation de SillyTavern, et ouvrez l'adresse locale qui y est affichée si le navigateur ne se lance pas automatiquement. Ces commandes suivent les instructions d'installation officielles pour macOS.

Le premier démarrage télécharge les dépendances requises.

Pour le lancer à nouveau plus tard :

cd ~/SillyTavern
bash start.sh

Installation sur Windows

Installez Node.js LTS et Git pour Windows. Créez un dossier tel que C:\AI, ouvrez-le dans l'Explorateur de fichiers, tapez cmd dans la barre d'adresse et appuyez sur Entrée. Exécutez :

git clone https://github.com/SillyTavern/SillyTavern -b release

Ouvrez le dossier SillyTavern téléchargé et double-cliquez sur Start.bat. Laissez sa console ouverte pendant que vous discutez. Le guide officiel pour Windows recommande d'éviter les dossiers contrôlés par Windows tels que Program Files et d'exécuter le fichier de démarrage sans privilèges d'administrateur.

Étape 2 : Connecter SillyTavern à GPT Proto

Connectez-vous à GPT Proto et ouvrez la page du modèle GLM-5.3. Sa section API Usage fournit l'identifiant du modèle et une entrée pour créer une clé API. Créez ou sélectionnez votre clé, vérifiez le tarif actuel et assurez-vous d'avoir un solde suffisant pour un petit test.

Dans SillyTavern, ouvrez API Connections en utilisant l'icône de prise dans la barre supérieure. Entrez :

Collez la clé elle-même dans le champ dédié. N'ajoutez pas Bearer, de guillemets ou d'en-tête HTTP complet à cet endroit.

Les instructions officielles pour les endpoints personnalisés spécifient une URL de base sans /chat/completions ; SillyTavern ajoute ce suffixe automatiquement. Pour cette connexion, le champ de l'endpoint doit se terminer par /v1.

Si vous avez déjà suivi notre guide de configuration de l'API Janitor AI, notez cette différence : l'URL de proxy de Janitor utilise l'adresse complète https://gptproto.com/v1/chat/completions. Copier cette adresse complète dans le champ URL de base de SillyTavern fournirait une entrée incorrecte.

Faites correspondre la source, l'URL de base, la clé et l'ID du modèle aux champs ci-dessus.

Cliquez sur Connect, puis sur Test Message. Vous pouvez également envoyer Hello depuis l'écran d'accueil. La procédure a généré la réponse ci-dessous.

Un message de base confirme que la connexion peut générer une réponse.

Une liste de modèles disponibles vide ne signifie pas nécessairement que la génération est indisponible. Entrez l'ID exact manuellement lorsque la découverte de modèles ne fonctionne pas. Pour changer de modèle plus tard, utilisez un autre ID de modèle texte pris en charge par GPT Proto et testez à nouveau ; les fonctionnalités et les paramètres acceptés peuvent varier.

Étape 3 : Importer une carte de personnage ou créer la vôtre

Une connexion API fonctionnelle fournit le modèle. La carte de personnage fournit l'identité, la voix et la situation de départ.

Importer une carte de personnage existante

Ouvrez Characters → Import Character, sélectionnez le fichier de carte téléchargé et choisissez le personnage importé pour commencer à discuter. Vous pouvez également parcourir les personnages via Extensions → Download Extensions & Assets.

Pour les cartes PNG, téléchargez le fichier original. Un portrait ou une capture d'écran classique ne contient aucune définition de personnage utilisable, sauf si ces données ont été intégrées dans l'image. La FAQ officielle explique les problèmes d'importation de PNG invalides, y compris les cas où l'enregistrement ou le traitement d'une image supprime ses données intégrées.

Créer Noah Bennett à partir de texte

Choisissez Créer un nouveau personnage. Commencez par le Nom, la Description et le Premier message ; vous pourrez ajouter des champs avancés plus tard. La description informe le modèle sur le personnage. Le premier message établit la scène d'ouverture et démontre le style souhaité. Le guide de conception de personnage explique ces deux champs.

Utilisez l'éditeur de personnage pour définir l'identité et la scène d'ouverture de l'IA.

Réglez le Nom sur Noah Bennett. Collez cet exemple original dans la Description. {{char}} fait référence au personnage et {{user}} à l'identité utilisateur que vous avez sélectionnée.

Vous jouez le rôle de {{char}}, Noah Bennett, un homme de 25 ans à la carrure musclée, au sourire facile et à la personnalité chaleureuse et affectueuse.

APPARENCE
Noah mesure 188 cm, avec des épaules larges, des bras puissants, un torse défini et des jambes solides développées par des années de musculation. Il a des cheveux châtain foncé légèrement ébouriffés, des yeux noisette chaleureux, une barbe naissante et une fossette qui apparaît quand il sourit. Ses vêtements habituels sont des t-shirts ajustés, des joggings confortables et des baskets. Sa voix est basse et chaleureuse, et son rire vient facilement.

PERSONNALITÉ
Noah est un cœur tendre avec une assurance enjouée. Il est attentionné, physiquement expressif et à l'aise pour montrer de l'affection. Il aime faire sourire {{user}} par des taquineries douces, des gestes attentionnés et des compliments sincères. Son charme vient de l'alliance entre sa carrure imposante et son cœur étonnamment tendre.

Il a ses propres opinions, amitiés, ambitions et parfois des jours sans. Il cache parfois sa nervosité derrière une blague et devient adorablement confus quand {{user}} le surprend à être sentimental. Il sait admettre ses erreurs et rire de lui-même.

CONTEXTE
Noah travaille comme coach sportif et espère ouvrir une petite salle de sport de quartier. En dehors du travail, il aime cuisiner, faire de la randonnée, les comédies romantiques médiocres et expérimenter des recettes de pancakes. Il prend l'entraînement au sérieux mais ne juge jamais les gens sur leur corps ou leur niveau de forme physique.

RELATION AVEC {{user}}
Noah et {{user}} sont des voisins sympathiques qui ont récemment commencé à passer plus de temps ensemble. Il est attiré par {{user}} et manifeste son intérêt par de l'attention, un flirt enjoué et des invitations à faire des choses ordinaires ensemble. Laissez leur complicité se développer au fil des interactions réelles.

STYLE DE FLIRT
Son flirt est chaleureux, spécifique et légèrement effronté. Il peut maintenir le contact visuel un peu plus longtemps, se souvenir d'une boisson préférée ou admettre qu'il a trouvé une excuse pour passer. Il remarque les réactions de {{user}} et s'adapte naturellement. L'affection doit sembler bienvenue et mutuelle.

STYLE DE JEU DE RÔLE
Restez dans le personnage de Noah tout au long de l'histoire. Utilisez des dialogues naturels, de petits gestes physiques et des détails concrets plutôt que de longues explications sur sa personnalité.
Écrivez les actions entre *astérisques* et les dialogues entre guillemets.
Répondez généralement en un à trois paragraphes courts, en laissant de la place à {{user}} pour participer.
Contrôlez uniquement la parole, les actions et les pensées de Noah. Laissez les dialogues, les décisions et les sentiments de {{user}} à l'utilisateur.
Maintenez les détails établis et répondez directement à ce qui vient de se passer.
Utilisez un anglais naturel, sauf si {{user}} demande une autre langue.

Collez ceci dans le Premier message :

*Noah se tient devant votre porte, un sac de sport sur une épaule large et un petit sac en papier à la main. Ses cheveux sombres sont encore légèrement humides et son t-shirt gris ajusté porte une fine trace de farine près de l'ourlet.*

« Avant que tu ne dises quoi que ce soit — oui, je sais cuisiner autre chose que du poulet et du riz. »

*Il soulève le sac en papier, une fossette apparaissant alors qu'il sourit.*

« Des roulés à la cannelle. J'en ai fait trop. » *Une brève pause.* « D'accord, j'en ai fait en plus parce que j'espérais te voir. »

« Alors… tu es libre pour un café ? »

Terminez la création du personnage, puis sélectionnez Noah. Conservez les instructions principales dans la Description et l'introduction dans le Premier message. Les Notes du créateur fournissent des métadonnées aux personnes lisant la carte et ne sont pas utilisées pour construire le prompt du modèle.

La carte Noah terminée sépare son identité continue de son message d'accueil.

Définissez votre propre Persona

Les personnages définissent l'identité de l'IA. Les personas définissent la vôtre. Ouvrez la Gestion des personas, créez et sélectionnez un persona, et ajoutez éventuellement un nom, un avatar et une description, en suivant les instructions officielles sur les Personas.

Pour cette scène fictive, une courte description suffit :

{{user}} est un adulte qui a récemment emménagé dans le quartier. Noah et {{user}} sont des voisins sympathiques qui apprennent à se connaître. {{user}} décide de ses propres paroles, actions, choix et sentiments.

Utilisez des détails fictifs que vous souhaitez que le personnage connaisse ; vous n'avez pas besoin de saisir votre véritable biographie. Pour plus d'idées sur l'écriture de personnages, consultez comment créer votre propre personnage IA avec une API.

Étape 4 : Commencez votre première conversation de jeu de rôle

Ouvrez le chat de Noah et lisez le message d'accueil. Dans la capture d'écran, l'utilisateur répond oui, et Noah répond : « Ouais ? D'accord. Super. » Il poursuit ensuite l'invitation au café avec des actions et des dialogues. Cette continuation générée est une vérification de connexion utile.

Pour un prompt plus spécifique à essayer vous-même, envoyez :

« Donc les roulés à la cannelle n'étaient qu'une excuse pour me voir ? »
*Je jette un coup d'œil au sac en papier, puis je le regarde à nouveau.*

Vérifiez si la réponse respecte la personnalité de Noah, répond à votre dernière entrée et vous laisse le soin de prendre vos propres décisions. Si le style doit être amélioré, modifiez une partie de la fiche et tentez un nouveau chat. Évitez de changer le modèle, le prompt du personnage et plusieurs paramètres en même temps ; vous auriez moins d'informations sur ce qui a aidé.

Optionnel : Ajoutez des informations sur le monde (World Info) à votre personnage

Les informations sur le monde, aussi appelées « lorebook », ajoutent des détails sur le cadre au prompt sous certaines conditions configurées. Pour une première expérience, ajoutez un lieu tiré de la scène de Noah.

Ouvrez World Info, créez un lorebook et ajoutez une entrée activée en utilisant la stratégie de déclenchement par mots-clés. Utilisez ces valeurs d'exemple :

Dans le panneau du personnage de Noah, utilisez Plus… → Lier World Info, ou le bouton globe du lore du personnage, pour associer le lorebook à lui. Ensuite, demandez : À quoi ressemble le Corner Cafe ?

La documentation sur World Info explique que le contenu de l'entrée est ce qui est inséré dans le prompt ; le titre seul ne fournit pas les faits. L'activation dépend également des paramètres et du budget disponible, et le modèle peut ne pas utiliser tous les détails fournis. Commencez par une entrée concise et vérifiez son comportement avant d'ajouter un monde vaste.

Combien coûte SillyTavern avec GPT Proto ?

GLM-5.3 est le modèle utilisé pour cette démonstration. Choisissez votre modèle en fonction de votre budget, du naturel du dialogue, de l'expression émotionnelle, de la cohérence du personnage et de la vitesse de réponse. Comparez les candidats avec la même carte et la même scène d'ouverture. Pour les discussions quotidiennes, incluez les coûts de contexte conservé dans votre budget ; pour les scènes axées sur l'histoire, vérifiez si la voix semble crédible et si le modèle vous laisse libre de vos choix.

SillyTavern lui-même est gratuit. La génération de modèles GPT Proto utilise votre solde API. Au moment de la rédaction de ce guide, GLM-5.3 est 15 % en dessous de ses tarifs officiels d'entrée et de sortie sur GPT Proto :

Tarifs vérifiés le 3 novembre 2026. Consultez le panneau de tarification GLM-5.3 pour les tarifs actuels et toute tarification de cache applicable.

Une requête illustrative avec 8 000 jetons d'entrée non mis en cache et 500 jetons de sortie facturables coûte :

(8 000 ÷ 1 000 000 × 1,19 $) + (500 ÷ 1 000 000 × 3,74 $)
= 0,01139 $

Ceci est un exemple de calcul, et non la facture réelle de la conversation capturée. La sortie facturable n'est pas un nombre de mots ; utilisez l'utilisation rapportée par le fournisseur, y compris tous les jetons de raisonnement facturés en tant que sortie.

L'entrée peut inclure les instructions du personnage, la Persona, les connaissances sélectionnées et l'historique de conversation conservé. Comme l'explique l'aperçu de la connexion API, SillyTavern les assemble dans l'invite. Un contexte conservé plus long peut augmenter le coût d'une réponse même lorsque votre dernier message n'est que oui.

Pourquoi choisir GPT Proto pour votre API SillyTavern ?

GPT Proto propose des modèles de fournisseurs officiels avec des tarifs réduits sur une sélection de modèles, dont GLM-5.3. Une seule clé et un solde partagé couvrent plusieurs fournisseurs. Dans SillyTavern, conservez vos cartes de personnage et votre connexion personnalisée, passez à un autre identifiant de modèle de chat pris en charge et comparez ses réponses.

Pour plus de fiabilité, les modèles majeurs utilisent des canaux amont redondants et un basculement automatique pour aider à réduire les interruptions lorsqu'un canal devient indisponible. Vous pouvez choisir entre des modèles avec des prix et des styles conversationnels différents tout en conservant votre configuration.

Avant une longue session, vérifiez la disponibilité du modèle, les coûts d'entrée/sortie, la vitesse de réponse et le traitement des données. Commencez par un petit test et examinez l'utilisation. La page des modèles SillyTavern vous permet d'explorer les options et de comparer les coûts.

Problèmes courants de l'API SillyTavern et leurs solutions

Commencez par une nouvelle discussion et un message court. Faites ensuite correspondre le symptôme à la vérification suivante :

Les modèles de raisonnement nécessitent une attention particulière. Le guide officiel du raisonnement explique que la réflexion peut consommer des jetons de réponse, même lorsqu'elle est masquée. Une allocation trop faible pour ce modèle peut laisser une réponse visible vide ou incomplète. Vérifiez la longueur maximale de réponse par rapport aux exigences du modèle plutôt que d'appliquer la même petite limite à chaque modèle.

Une discussion communautaire sur les livres de lore et les réponses vides décrit un utilisateur ayant réussi à résoudre le problème après avoir supprimé un préréglage et augmenté l'allocation de réponse. Les deux ayant été modifiés simultanément, le rapport n'isole pas une cause unique. Cela confirme un ordre de dépannage pratique : faites fonctionner une discussion simple, puis ajoutez les préréglages et le lore un changement à la fois.

Optionnel : Tester l'API en dehors de SillyTavern

Avec votre clé stockée de manière privée dans la variable d'environnement GPTPROTO_API_KEY, cette commande shell macOS/Linux envoie une requête directe en utilisant le format Chat Completions de la page du modèle :

curl --request POST "https://gptproto.com/v1/chat/completions" \
  --header "Authorization: Bearer $GPTPROTO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "glm-5.3",
    "messages": [
      {"role": "user", "content": "Reply with: API connection works."}
    ]
  }'

Vérifiez si vous obtenez une réponse réussie contenant du texte généré, et non seulement un indicateur de connexion. Si cela fonctionne alors que SillyTavern échoue, comparez les champs et les paramètres ajoutés du client. Si les deux échouent, examinez l'erreur d'authentification, de solde, de modèle ou de service renvoyée. Ne partagez jamais de clés réelles dans des publications de dépannage publiques.