API gratuite pour SillyTavern : crédit d'essai et configuration et configuration
SillyTavern fonctionne avec n'importe quel endpoint compatible OpenAI, donc sa connexion nécessite trois champs. Cette page présente les paramètres, le coût par message et les limites importantes pour les sessions de jeu de rôle longues.
Mis à jour

Points clés
- Il y a un démarrage gratuit, pas un service gratuit à vie : $0,50 de crédit d'essai en un clic, valable 7 jours, sans méthode de paiement nécessaire.
- Dans SillyTavern, choisissez Complétion de chat, puis Personnalisé (compatible OpenAI), et collez l'URL de base, votre clé et l'ID de modèle uncensored.
- Un message de chat typique coûte une fraction de centime, donc le crédit couvre des centaines de messages.
- Les clés d'essai permettent 2 requêtes simultanées, ce qui est utile à savoir avant de lancer des chats de groupe.
Ce que signifie « gratuit » ici
Si vous recherchez une API gratuite pour SillyTavern, la réponse directe est que personne ne peut faire tourner un modèle de langage large gratuitement pour rien indéfiniment, et ce service ne prétend pas le contraire. Ce que vous obtenez est un démarrage gratuit. Après vous être connecté avec Google ou avec un e-mail et un mot de passe, la page de la clé API propose un bouton pour réclamer $0,50 de crédit d'essai. Il y a une seule réclamation par personne, elle est valable 7 jours et ne nécessite pas de méthode de paiement.
Ce crédit est une vraie utilisation, pas une démo qui s'arrête après trois messages. SillyTavern parle à l'API exactement comme il le ferait avec n'importe quel backend compatible OpenAI, en utilisant le modèle uncensored, et chaque requête prélève sur le solde à $0,15 par 1M de tokens en entrée et $0,50 par 1M de tokens en sortie. Lorsque l'essai est épuisé, vous décidez si vous continuez. Les recharges commencent à $20, le crédit n'expire jamais, et il n'y a pas d'abonnement à annuler.
Le modèle est un modèle à poids ouverts unique exécuté par un fournisseur indépendant et ajusté pour répondre sans refus de contenu pour un usage adulte légal. Ce n'est pas une API officielle d'un fournisseur de modèle, et il est textuel uniquement. Les fonctionnalités image et voix de SillyTavern nécessitent leurs propres services ; cet endpoint gère le chat.
Ce que $0,50 achète dans un chat SillyTavern
SillyTavern renvoie beaucoup de texte à chaque tour : la description du personnage, votre persona, les entrées du lorebook qui s'activent, le prompt système et autant d'historique de chat que votre paramètre de fenêtre de contexte le permet. Ainsi, le coût d'un message est principalement du côté de l'entrée. Voici deux exemples concrets aux prix réels.
| Scénario | Tokens d'entrée | Tokens de sortie | Coût par message | Messages dans $0,50 |
|---|---|---|---|---|
| Chat léger, historique court | 6 000 | 250 | $0.001025 | environ 487 |
| Chat long, gros lorebook | 20 000 | 400 | $0.0032 | environ 156 |
Le calcul pour la première ligne : 6 000 tokens d'entrée à 0,15 $ par 1M font 0,0009 $, et 250 tokens de sortie à 0,50 $ par 1M font 0,000125 $. Ajoutez-les et vous obtenez 0,001025 $. Divisez 0,50 $ par ce montant et vous obtenez environ 487 messages. Pour la deuxième ligne, 20 000 tokens d'entrée coûtent 0,003 $ et 400 tokens de sortie coûtent 0,0002 $, soit 0,0032 $ par message et environ 156 messages.
Mettez à l'échelle et les nombres restent petits. Un millier de messages de type léger coûtent 1,025 $. Un millier de type lourd coûtent 3,20 $. La leçon pratique est que la longueur de l'historique pilote votre facture, pas la longueur de la réponse. Si une session devient coûteuse, réduisez la fenêtre de contexte plutôt que les réponses.
Les requêtes échouées ou refusées ne sont pas facturées, donc une erreur de connexion ou une requête rejetée ne grignote pas votre solde. Vous pouvez surveiller le solde dans l'en-tête de réponse X-Balance-USD si vous testez avec curl, et la page de tarification présente les paliers de rechargement et les bonus.
Connectez SillyTavern étape par étape
1. Obtenez la clé
Inscrivez-vous sur la page clé API, obtenez le crédit d'essai et copiez la clé. Traitez-la comme un mot de passe. Si jamais vous la collez dans une capture d'écran ou un préréglage partagé, remplacez-la.
2. Testez l'endpoint en dehors de SillyTavern
Un test de trente secondes économise beaucoup de devinettes plus tard. Si cela renvoie une réponse, la clé et l'URL sont correctes :
curl https://api.ttsapihub.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the word ready."}],
"max_tokens": 10
}'3. Remplissez le panneau de connexion
Ouvrez l'icône prise (Connexions API) dans SillyTavern. Définissez le type d'API sur Chat Completion et la source de chat completion sur Custom (compatible OpenAI). Les noms de menu varient légèrement entre les versions, mais les trois champs sont toujours les mêmes :
- Endpoint personnalisé (URL de base) :
https://api.ttsapihub.com/v1 - Clé API personnalisée : la clé que vous avez copiée
- ID de modèle :
uncensored
Cliquez sur Connecter. Un statut vert signifie que SillyTavern peut atteindre l'endpoint. Si vous saisissez l'ID du modèle manuellement et que la liste déroulante reste vide, c'est normal ; le champ accepte le nom directement. Vous pouvez également vérifier ce que le serveur liste avec GET /v1/models.
Paramètres à modifier immédiatement
Les valeurs par défaut de SillyTavern sont réglées pour d'autres backends, donc quelques modifications sont utiles immédiatement.
Taille du contexte
Le modèle a une fenêtre de 100 000 tokens, partagée entre le prompt et la réponse. Vous n'avez pas à tout utiliser. De nombreuses sessions de jeu de rôle fonctionnent bien avec 16 000 à 32 000 tokens de contexte, et la facture augmente avec chaque token que vous renvoyez. Commencez à 16 000 et augmentez-le seulement lorsque le personnage oublie quelque chose qui vous importe.
Longueur maximale de réponse
Cela définit max_tokens. C'est optionnel côté API, mais SillyTavern l'envoie, et c'est votre plafond pour les divagations. 300 à 500 donne des réponses de longueur de chat. Pour des scènes de récit longues, augmentez-le.
Diffusion en continu
Activez le streaming. L'API envoie des événements envoyés par le serveur, SillyTavern imprime la réponse à mesure qu'elle arrive, et vous pouvez arrêter une génération médiocre tôt. Une chose à retenir : une requête en streaming garde son slot de concurrence jusqu'à la fin du flux, donc ne laissez pas une génération bloquée tourner pendant que vous en essayez une autre.
Échantillonnage
La température, top_p, les séquences d'arrêt, le seed et les pénalités de répétition sont transmis au modèle. Si le modèle semble répétitif, augmentez légèrement les pénalités et changez une valeur à la fois. En changer cinq à la fois ne vous apprend rien.
Limites que vous remarquerez dans les longues sessions
Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute. Une clé d'essai permet 2 requêtes simultanées et 60 par minute. Pour une personne dans un chat unique, c'est largement suffisant. L'endroit où vous pouvez toucher le plafond est un chat de groupe, où SillyTavern peut générer les réponses de plusieurs personnages rapidement, ou lorsque vous ouvrez deux onglets de navigateur et régénérez dans les deux.
Lorsque vous dépassez une limite, l'API répond avec HTTP 429. Le code d'erreur est rate_limited lorsque vous avez envoyé trop de requêtes par minute et concurrency lorsque trop sont en vol simultanément. En cas de surcharge temporaire, vous obtenez aussi un 429 avec un en-tête Retry-After: 5. Dans tous les cas, la solution est la même : attendez quelques secondes et appuyez sur régénérer. Rien n'est facturé pour la tentative échouée.
Le corps de la requête peut faire jusqu'à 8 Mo, ce qui est largement au-delà de ce dont un prompt de chat a besoin, même avec une fenêtre de contexte de 100 000 tokens.
Dépannage d'une connexion qui ne fonctionne pas
| Symptôme | Cause probable | Correction |
|---|---|---|
| Le statut reste rouge après Connect | URL de base mal tapée, ou le chemin ajouté deux fois | Utilisez exactement l'URL de base ci-dessus, se terminant par /v1, sans /chat/completions à la fin |
| 401 Non autorisé | Clé manquante, tronquée ou collée avec un espace | Collez-la à nouveau et vérifiez les espaces au début ou à la fin |
| Modèle non trouvé | Nom de modèle incorrect | Définissez l'ID de modèle sur uncensored en minuscules |
| 429 après quelques gestes de balayage | Concurrence de 2 pour la clé d'essai | Attendez que les générations en cours se terminent, puis réessayez |
| La réponse s'arrête en plein milieu d'une phrase | Longueur de réponse maximale trop faible | Augmentez-le, ou demandez une continuation |
Si rien de tout cela ne l'explique, relancez le test curl de l'étape 2. Lorsque curl fonctionne et que SillyTavern ne fonctionne pas, le problème vient des champs de SillyTavern. Lorsque curl échoue aussi, vérifiez la clé et votre réseau. La documentation quickstart liste le format de la requête en entier.
Contenu, confidentialité et limite stricte
Le modèle est ajusté pour rester dans le personnage pour la fiction et le jeu de rôle entre adultes, ce qui est la raison pour laquelle de nombreux utilisateurs de SillyTavern recherchent un backend comme celui-ci. Il est conçu pour une utilisation légale pour adultes. Une règle n'a aucune exception : pas de contenu sexuel impliquant des mineurs, sous quelque forme que ce soit, et les requêtes de ce type ne sont pas quelque chose que le service est conçu pour prendre en charge.
En matière de confidentialité, les prompts ne sont pas utilisés pour l'entraînement. C'est une déclaration concernant ce service ; cela ne couvre pas ce que SillyTavern lui-même stocke sur votre machine, donc vos journaux de chat et vos fichiers de personnage restent où vous les gardez.
Lorsque vous êtes prêt à passer à l'étape suivante, la page tarifs affiche les options de rechargement. Tout montant entier de 20 $ à 500 $ fonctionne, avec +5 % de crédit à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $. Les cartes (Visa, Mastercard, Apple Pay, Google Pay) et la crypto (USDT sur TRC20, USDC sur Base) sont toutes deux acceptées.
Plus de guides
Questions et réponses
Existe-t-il vraiment un niveau gratuit pour SillyTavern ?
Il y a un essai unique de 0,50 $ de crédit, réclamé en un clic sur la page de la clé API après l'inscription. Il dure 7 jours et ne nécessite pas de carte. Après cela, vous payez par token à partir du crédit prépayé.
Quel ID de modèle dois-je saisir dans SillyTavern ?
Saisissez uncensored, en minuscules. L'URL de base est https://api.ttsapihub.com/v1 et la clé va dans le champ Clé API personnalisée.
Pourquoi obtiens-je une erreur 429 lorsque je régénère rapidement ?
Une clé d'essai permet 2 requêtes simultanées, et une réponse en streaming occupe sa place jusqu'à sa fin. Attendez quelques secondes et réessayez ; les requêtes échouées ne sont pas facturées.
L'API génère-t-elle des images ou de la voix pour SillyTavern ?
Non. Il s'agit uniquement de texte, sans génération d'images, d'audio ou de vidéo, et sans vecteurs d'embedding.
Puis-je définir un plafond de dépenses ?
Vous payez à partir du crédit prépayé, vous ne pouvez donc dépenser que ce que vous avez rechargé. Surveillez l'en-tête de réponse X-Balance-USD pour voir ce qu'il reste.
Il ne vous reste qu'un formulaire à remplir pour obtenir votre clé
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.