Dépannage : corriger les erreurs TavernAPI dans SillyTavern

Vérifications de base

Avant de chercher un code d'erreur précis, prenez 60 secondes pour vérifier ces cinq points dans le panneau API Connections de SillyTavern (l'icône de prise électrique tout en haut). Corriger un petit décalage ici règle la majorité des problèmes de connexion sur-le-champ :

1. Chat Completion Source : Réglez API sur Chat Completion et Chat Completion Source sur Custom (OpenAI-compatible).
2. Base URL : Réglez Custom Endpoint (Base URL) sur https://tavernapi.com/v1, sans barre oblique finale (/) et sans /chat/completions à la fin.
   • Applications web (JanitorAI) : Les interfaces dans le navigateur qui demandent l'URL complète du proxy font exception — indiquez-leur https://tavernapi.com/v1/chat/completions.
   • Reverse Proxy natif de SillyTavern : Si vous passez par les sources natives de SillyTavern plutôt que par Custom, réglez Proxy Server URL sur https://tavernapi.com/v1 pour la source Claude, ou sur https://tavernapi.com pour la source Google AI Studio.
3. Clé API : Collez votre clé complète sk-tav-... dans Custom API Key (ou dans Proxy Password sur les sources natives), sans espace au début ni à la fin.
4. Se connecter et choisir un modèle : Cliquez sur Connect et sélectionnez un modèle dans le menu déroulant Available Models (claude-opus-5-5, claude-sonnet-5-5, gemini-4-argon, gemini-3.8-flash ou deepseek-v4-pro).
5. Solde du compte : Ouvrez la console TavernAPI et vérifiez que votre solde en USD ou votre crédit d'essai de $0.30 est supérieur à zéro.

Comment s'affichent les erreurs TavernAPI dans SillyTavern

Lorsqu'une requête ne peut pas aboutir, TavernAPI renvoie une réponse JSON standard sous cette forme :

{"error": {"message": "...", "type": "...", "code": "..."}}

SillyTavern affiche le texte du champ "message" dans une notification rouge. Si l'encadré disparaît trop vite, regardez la fenêtre où tourne le serveur SillyTavern (l'Invite de commandes sous Windows ou Termux sur Android) : l'erreur complète y est affichée avec le statut HTTP et le "code".

Codes d'erreur

Repérez votre statut HTTP et le message correspondant ci-dessous pour comprendre pourquoi la requête a échoué et comment la débloquer.

401 Clé API invalide

• Ce que vous voyez : Message Invalid API key, code invalid_api_key. Si aucune clé n'a été envoyée (champ laissé vide), le message commence par Missing API key et le code est missing_api_key.
• Pourquoi cela arrive : Le champ de clé API est vide, la clé sk-tav-... a été tronquée au moment du copier-coller, contient une espace en trop au début ou à la fin, a été révoquée dans la console, ou provient d'un autre service (comme OpenRouter ou OpenAI).
• Comment corriger le problème : Recopiez et recollez votre clé sk-tav-... complète en vérifiant qu'aucune espace ne s'est glissée dedans. Si vous n'avez plus la clé complète sous la main, ouvrez l'onglet Clés API dans la console et créez une nouvelle clé (copiez-la tout de suite, car chaque clé ne s'affiche qu'une seule fois).
• Êtes-vous débité ? Non.

402 Solde insuffisant

• Ce que vous voyez : Message Insufficient balance, code insufficient_balance.
• Pourquoi cela arrive : Votre solde actuel (ou votre crédit d'essai) est inférieur au montant temporairement bloqué pour lancer la requête. Avant de transmettre chaque prompt, TavernAPI bloque une estimation égale aux tokens d'entrée visibles plus la totalité de votre Max Response Length (max_tokens) calculée au tarif de sortie du modèle. Dès que la réponse est terminée, TavernAPI ne facture que les tokens réellement consommés et libère immédiatement le reste de la somme bloquée. À cause de cette pré-autorisation, l'erreur 402 peut apparaître alors qu'il vous reste encore un peu de solde — surtout si Max Response Length est réglé très haut ou si vous appelez un modèle plus coûteux comme claude-opus-5-5.
• Comment corriger le problème :
  1. Ouvrez AI Response Configuration (l'icône des curseurs dans SillyTavern) et baissez Max Response Length à une valeur raisonnable (comme 1024 ou 2048 tokens) pour réduire le montant pré-autorisé.
  2. Passez sur un modèle plus économique dans le menu déroulant, comme gemini-3.8-flash ou deepseek-v4-pro (voir les tarifs des modèles).
  3. Ou rechargez votre solde dans la console.
• Êtes-vous débité ? Non.

403 Essai gratuit ou preset non débloqué

• Ce que vous voyez : L'un de ces trois messages et codes 403 :
  • Restriction du crédit d'essai : Message Model "<id>" is not available with trial credit. Add credit to unlock it., code trial_restricted.
  • Pack de preset verrouillé : Message "<preset pack name>" is not included in your account. See https://tavernapi.com/console/presets (ou This preset is currently unavailable), code preset_locked.
  • Statut du compte : Message Account suspended, code account_banned.
• Pourquoi cela arrive :
  • trial_restricted : Le crédit d'essai gratuit de $0.30 fonctionne uniquement avec gemini-4-argon et gemini-3.8-flash. Appeler claude-opus-5-5, claude-sonnet-5-5 ou deepseek-v4-pro sur un compte disposant uniquement du crédit d'essai déclenche cette erreur.
  • preset_locked : Votre preset actif dans SillyTavern contient des marqueurs [[tav:...]] d'un niveau de preset que votre compte n'a pas encore débloqué.
  • account_banned : Le compte a été suspendu (consultez la Politique d'utilisation acceptable).
• Comment corriger le problème :
  • Pour trial_restricted : Choisissez gemini-4-argon ou gemini-3.8-flash dans le menu déroulant des modèles de SillyTavern, ou rechargez votre compte dans la console pour débloquer tous les modèles.
  • Pour preset_locked : Repassez sur votre propre preset local dans SillyTavern, désactivez les entrées verrouillées [[tav:...]] dans le Prompt Manager, ou débloquez le preset sur https://tavernapi.com/console/presets. Le preset Standard se débloque dès votre premier rechargement ; le preset Pro se débloque via un achat unique à $4.99, un pack de crédit actif à $19 ou $39, ou $25 de rechargements cumulés (voir comment fonctionnent les presets TavernAPI).
  • Pour account_banned : Contactez le support en indiquant l'adresse e-mail de votre compte.
• Êtes-vous débité ? Non.

404 Modèle indisponible

• Ce que vous voyez : Message Model "<id>" is not available, code model_not_found.
• Pourquoi cela arrive : L'ID du modèle envoyé dans votre requête contient une faute de frappe, provient d'un autre fournisseur (par exemple anthropic/claude-... depuis OpenRouter, ou un ancien suffixe -story), ou le modèle est temporairement désactivé.
• Comment corriger le problème : Cliquez sur Connect dans SillyTavern pour rafraîchir le menu déroulant des modèles et choisissez-en un dans la liste. Si vous tapez l'ID du modèle à la main (comme dans JanitorAI), entrez l'un de ces cinq identifiants exacts :
  • claude-opus-5-5
  • claude-sonnet-5-5
  • gemini-4-argon
  • gemini-3.8-flash
  • deepseek-v4-pro
• Êtes-vous débité ? Non.

404 Page introuvable (mauvaise URL)

• Ce que vous voyez : Message Not found, code not_found.
• Pourquoi cela arrive : Le chemin de l'URL est incorrect. Le plus souvent, /v1 a été écrit deux fois (https://tavernapi.com/v1/v1), ou /chat/completions a été collé dans le champ Custom Endpoint de SillyTavern (qui ajoute déjà /chat/completions tout seul). S'il manque complètement /v1 (https://tavernapi.com), la requête arrive sur le site web au lieu de l'API et renvoie une page 404 classique plutôt que cette erreur JSON ; le correctif reste le même.
• Comment corriger le problème : Remplacez l'endpoint par l'URL exacte correspondant à votre interface dans les Vérifications de base :

• Êtes-vous débité ? Non.

400 Requête invalide

• Ce que vous voyez : L'un de ces trois messages et codes 400 :
  • model is required (code model_required)
  • messages must be a non-empty array (code messages_required)
  • Unknown preset block [[tav:...]]. Download the latest preset from https://tavernapi.com/console/presets (code preset_block_unknown)
• Pourquoi cela arrive :
  • model_required : Aucun modèle n'a été sélectionné avant l'envoi du message.
  • messages_required : La requête envoyée ne contenait aucun message dans le tableau (par exemple, un prompt vide ou un script regex / une extension qui a supprimé tous les messages).
  • preset_block_unknown : Votre fichier de preset local est plus ancien que la définition actuelle sur le serveur, ou une balise [[tav:...]] a été modifiée à la main.
• Comment corriger le problème :
  • Pour model_required, cliquez sur Connect dans SillyTavern et sélectionnez un modèle dans le menu déroulant.
  • Pour messages_required, vérifiez que votre chat contient au moins un message et contrôlez les extensions qui modifient le prompt.
  • Pour preset_block_unknown, téléchargez la dernière version du fichier JSON du preset depuis https://tavernapi.com/console/presets et importez-le à nouveau dans SillyTavern.
• Êtes-vous débité ? Non.

429 Trop de requêtes ou serveur en amont saturé

• Ce que vous voyez : Message Upstream error (429), type rate_limit_error, code upstream_error.
• Pourquoi cela arrive : Soit vous avez envoyé trop de requêtes simultanément (par exemple en cliquant plusieurs fois sur régénérer pendant qu'une réponse est déjà en cours), soit le fournisseur du modèle en amont est momentanément surchargé. Lorsqu'un canal en amont atteint sa limite de capacité, TavernAPI essaie automatiquement d'autres routes avant de renvoyer 429.
• Comment corriger le problème : Patientez quelques secondes, puis balayez (swipe) ou régénérez la réponse.
• Êtes-vous débité ? Non — vous n'êtes pas débité lorsqu'aucune réponse n'a été générée.

Erreurs serveur 5xx

• Ce que vous voyez :
  • HTTP 502 : Message Upstream error (502), code upstream_error
  • HTTP 503 : Message No upstream route is configured for this model, code no_route
  • HTTP 500 : Un code preset_... (par exemple preset_block_error)
• Pourquoi cela arrive :
  • Upstream error (502) (upstream_error) : Le fournisseur du modèle en amont a rencontré une erreur ou la connexion réseau a coupé pendant la requête.
  • No upstream route is configured for this model (503, no_route) : Le modèle est temporairement indisponible sur l'ensemble des canaux configurés en amont.
  • Codes 500 preset_... (comme preset_block_error) : Une erreur côté serveur s'est produite lors du développement d'un bloc de preset verrouillé.
• Comment corriger le problème :
  • Pour 502 (upstream_error) : Patientez quelques secondes, puis balayez ou régénérez la réponse.
  • Pour 503 (no_route) : Passez temporairement sur un autre modèle dans le menu déroulant le temps que le canal soit rétabli.
  • Pour 500 (preset_block_error) : Essayez le même chat sans le preset TavernAPI (ou en désactivant les entrées verrouillées [[tav:...]]) pour vérifier que la génération fonctionne, puis contactez le support en précisant l'heure approximative et l'ID du modèle.
• Êtes-vous débité ? Si le fournisseur échoue avant que le moindre texte de réponse ne soit produit, le montant pré-autorisé est intégralement restitué. Si l'erreur survient en cours de réponse après le début du streaming, vous ne payez que les tokens effectivement générés.

Problèmes sans code d'erreur

Il arrive que SillyTavern n'affiche aucune alerte d'erreur HTTP, mais que le comportement dans la fenêtre de chat soit quand même anormal.

Le voyant Connect reste rouge ou la liste des modèles est vide

Si le clic sur Connect dans SillyTavern laisse le voyant au rouge ou que le menu déroulant Available Models reste vide :

1. Vérifiez la source, la Base URL et la clé API en suivant les Vérifications de base.
2. Assurez-vous que l'URL commence bien par https:// (et non http://) et ne comporte aucune espace avant https:// ni après /v1.
3. Si vous utilisez la source native Claude ou Google AI Studio de SillyTavern, vérifiez que vous avez bien déplié la section Reverse Proxy et collé votre clé sk-tav-... dans Proxy Password, et non dans le champ de clé directe du fournisseur situé au-dessus. Consultez le guide de configuration SillyTavern pour le détail de chaque champ.

Les réponses sont vides ou coupées

Si le message du personnage s'arrête au milieu d'une phrase ou revient complètement vide :

• Max Response Length est trop bas : Une réponse s'arrête dès qu'elle atteint la limite Max Response Length (max_tokens) définie dans le panneau AI Response Configuration de SillyTavern. De plus, les modèles qui réfléchissent avant de répondre utilisent une partie de ce budget de tokens pour leur réflexion interne avant d'écrire la réponse visible. Si Max Response Length est réglé très bas (par exemple 250 ou 400), le modèle peut consommer tout le budget pour sa réflexion et laisser la réponse visible vide. Augmentez Max Response Length (par exemple à 1024–2048 tokens) et régénérez.
• Filtres de sécurité en amont : Les filtres de sécurité propres au fournisseur du modèle peuvent également interrompre une réponse prématurément ou renvoyer un message vide lorsqu'un prompt déclenche leur classifieur.

Les réponses ignorent le preset ou affichent [[tav:...]]

Les marqueurs de presets verrouillés ([[tav:...]]) ne sont développés que lorsque votre requête passe par le serveur de TavernAPI. Si vos réponses ignorent les consignes du preset ou si vous voyez apparaître des balises [[tav:...]] brutes :

1. Ouvrez API Connections (l'icône de prise) et vérifiez que votre connexion active pointe bien vers https://tavernapi.com/v1 — et non vers un autre fournisseur sur lequel vous auriez laissé le preset TavernAPI activé.
2. Ouvrez AI Response Configuration (l'icône de curseurs) et vérifiez que le preset TavernAPI est bien sélectionné dans le menu déroulant Chat Completion Presets et que les entrées principales du prompt sont activées.
3. Après une mise à jour de preset, retéléchargez le fichier JSON depuis https://tavernapi.com/console/presets et réimportez-le pour que votre fichier local corresponde à la version du serveur. Voir comment fonctionnent les presets TavernAPI.

La consommation est plus élevée que prévu

En roleplay, SillyTavern renvoie l'historique du chat, la carte de personnage et le preset à chaque tour. TavernAPI réduit automatiquement ce coût d'entrée grâce au cache de prompt côté serveur ; une consommation plus élevée que d'habitude vient donc presque toujours de ratés du cache de prompt (cache misses) ou d'un chat très long :

• Envoyer le premier message après une pause : Les fournisseurs en amont ne conservent les préfixes mis en cache que pendant quelques minutes d'inactivité. Le premier tour après une longue pause doit reconstruire le cache et coûte donc sensiblement plus cher ; les tours suivants repassent aussitôt au tarif réduit de lecture du cache.
• Modifier d'anciens messages ou déplacer des entrées en haut du prompt : Éditer ou supprimer un message ancien, changer de preset en cours de discussion ou placer des macros aléatoires ({{random}}, {{roll}}) près du début du prompt modifie le préfixe et oblige à réécrire un nouveau cache.
• Contexte très long non tronqué : Un chat qui dépasse 100k tokens coûte plus cher à chaque tour qu'un chat de 20k tokens, même lorsque le cache est actif.

Consultez notre guide sur le prompt caching pour garder un taux de lecture du cache élevé, et ouvrez la page Utilisation dans la console pour voir le détail exact de vos tokens d'entrée, en cache et de sortie pour chaque requête.

Problèmes de rechargement et de paiement

Les rechargements en cryptomonnaie sur TavernAPI passent par une page de paiement NOWPayments pour des montants entiers en dollars de $6 à $500 (voir comment payer en crypto). Dans la console, sous l'onglet Facturation, chaque commande crypto affiche l'un de ces cinq statuts : En attente (Pending), Payé en partie (Partially paid), Payé (Paid), Expiré (Expired) ou Échoué (Failed).

Le montant reçu est inférieur à la facture

Cela arrive généralement lorsque votre plateforme d'échange (exchange) ou votre portefeuille déduit ses frais de retrait du montant envoyé au lieu de les ajouter en plus.

• Le statut de la commande passe sur Payé en partie (Partially paid), et nous créditons automatiquement la part effectivement reçue, au prorata.
• Pour compléter le montant manquant, lancez simplement une nouvelle commande de rechargement dans la console.
• N'envoyez pas de second paiement vers l'ancienne adresse de dépôt, sauf si le support vous le demande.

La commande affiche Expiré

Les commandes crypto non payées sont clôturées automatiquement au bout d'1 heure et passent au statut Expiré (Expired). Si votre paiement avait déjà été envoyé et arrive sur la blockchain après ce délai d'une heure, il est tout de même crédité automatiquement sur votre solde.

Mon rechargement n'est pas arrivé

Les confirmations sur les réseaux blockchain prennent généralement quelques minutes, mais un réseau saturé ou un traitement par lots un peu lent du côté de la plateforme d'échange peut allonger le délai. Le statut dans l'onglet Facturation de votre console se met à jour tout seul dès que la transaction est confirmée.

Si rien n'a bougé au bout d'environ 30 minutes, contactez le support en indiquant :

• Le hash de transaction (TXID)
• La cryptomonnaie et le réseau utilisés
• Le montant envoyé
• L'adresse e-mail de votre compte TavernAPI

J'ai envoyé plus que le montant de la facture

Lorsqu'un paiement dépasse le total de la facture, seul le montant initial de la commande est crédité automatiquement ; le surplus n'est pas ajouté tout seul. Contactez le support avec votre hash de transaction (TXID) et l'adresse e-mail de votre compte afin que nous puissions vérifier le paiement et ajouter la différence sur votre solde.

J'ai utilisé le mauvais réseau ou la mauvaise crypto

Si vous avez envoyé des fonds sur le mauvais réseau blockchain ou envoyé une autre cryptomonnaie que celle sélectionnée lors du paiement, contactez le support immédiatement avec le hash de transaction (TXID), la cryptomonnaie, le réseau et le montant. La récupération des fonds n'est pas garantie.

Toujours bloqué ?

Si les étapes ci-dessus n'ont pas suffi à régler le problème, écrivez-nous via la page de contact en joignant ces informations pour que nous puissions vérifier les journaux rapidement :

• Pour une erreur d'API ou de preset : l'adresse e-mail de votre compte TavernAPI, l'ID du modèle (claude-opus-5-5, claude-sonnet-5-5, gemini-4-argon, gemini-3.8-flash ou deepseek-v4-pro), l'heure approximative à laquelle l'erreur s'est produite (avec votre fuseau horaire), le statut HTTP et le code d'erreur, ainsi que le nom du pack de preset si vous en utilisiez un.
• Pour un problème de paiement : l'adresse e-mail de votre compte, le hash de transaction (TXID), la cryptomonnaie et le réseau utilisés, ainsi que le montant envoyé.