FR ▾
Obtenir la clé API

SillyTavern API : connecter un modèle compatible OpenAI

Pour utiliser SillyTavern avec une API compatible OpenAI, il faut une URL, une clé et un nom de modèle. Voici les étapes, les réglages de contexte et les erreurs à connaître.

Tout savoir sur l'IA Sans Censure : Usage, Intégration et Limites

Mis à jour

Points clés
  • URL de base à renseigner : https://api.apiiasanscensure.com/v1, modèle uncensored.
  • Contexte maximal de 100 000 tokens, mais un contexte plus court réduit le coût de chaque message.
  • Un message de 16 000 tokens de contexte et 400 de réponse coûte environ 0,0026 $.
  • Les erreurs 401, 404 et 429 ont presque toujours une cause simple à corriger.
Scène de théâtre avec masques et bulles lumineuses reliée par un câble à un serveur, symbole du jeu de rôle via API

Ce qu'il faut avoir sous la main

La recherche sillytavern api mène souvent à des tutoriels pour des backends locaux. Ici, on se branche sur une API hébergée qui parle le format OpenAI. SillyTavern sait s'y connecter, car il propose un mode de complétion de chat avec une source OpenAI personnalisée. Trois informations suffisent :

  • l'URL de base : https://api.apiiasanscensure.com/v1
  • une clé API, créée sur la page obtenir une clé API
  • le nom du modèle : uncensored

Le modèle est un modèle de texte réglé pour répondre sans refus de contenu dans le cadre d'un usage adulte légal, ce qui convient bien à la fiction et au jeu de rôle. Il ne génère pas d'images : si vous voulez des avatars ou des fonds, il faudra un autre outil. Et la règle ne change pas, tout contenu sexuel impliquant des mineurs est exclu.

Étapes de connexion

Les libellés de l'interface de SillyTavern changent d'une version à l'autre. Voici la logique générale, à comparer avec votre version et avec la documentation officielle de l'outil si un intitulé diffère.

  1. Ouvrez le panneau de connexion à l'API (l'icône en forme de prise, en haut).
  2. Choisissez le type d'API « Chat Completion » (complétion de chat).
  3. Dans la source, sélectionnez l'option personnalisée, compatible OpenAI.
  4. Collez l'URL de base, sans rien ajouter après /v1. L'outil ajoute lui-même /chat/completions.
  5. Collez la clé API dans le champ prévu.
  6. Saisissez l'identifiant du modèle, uncensored, à la main s'il n'apparaît pas dans la liste.
  7. Utilisez le bouton de connexion ou de test, puis vérifiez que l'état passe au vert.

Avant de vous lancer dans SillyTavern, vous pouvez valider la clé et l'URL avec un simple appel, pour exclure d'emblée un problème de saisie :

curl https://api.apiiasanscensure.com/v1/models   -H "Authorization: Bearer VOTRE_CLE"

Si cette commande renvoie la liste des modèles, la clé et l'adresse sont bonnes. Un test de génération complet se fait avec /v1/chat/completions, décrit dans la documentation.

Contexte, longueur de réponse et coût par message

Le modèle accepte jusqu'à 100 000 tokens par requête, prompt et réponse compris. Ce n'est pas une raison de tout utiliser. SillyTavern renvoie à chaque message la fiche du personnage, les consignes et l'historique récent, et tout cela est facturé en entrée à chaque fois.

Prenons un contexte rempli à 16 000 tokens et une réponse de 400 tokens, au tarif de 0,15 $ par million en entrée et 0,50 $ par million en sortie :

  • Entrée : 16 000 × 0,15 / 1 000 000 = 0,0024 $
  • Sortie : 400 × 0,50 / 1 000 000 = 0,0002 $
  • Total : 0,0026 $ par message, soit 0,26 $ pour 100 messages

Avec un contexte de 8 000 tokens, on obtient 0,0012 + 0,0002 = 0,0014 $ par message. Le crédit d'essai de 0,50 $ permet alors environ 357 messages, contre environ 192 avec 16 000 tokens de contexte. À vous de choisir entre mémoire longue et coût bas.

Réglages de départ raisonnables : contexte entre 8 000 et 16 000 tokens, longueur de réponse de 300 à 500 tokens, température autour de 0,9 pour un récit vivant. Les pénalités de répétition sont transmises à l'API, et le paramètre seed aussi si vous voulez reproduire une réponse. Le champ max_tokens reste facultatif côté API, mais fixer une limite évite des réponses interminables.

Le streaming et la concurrence

Activez le streaming dans SillyTavern pour voir le texte s'afficher au fil de l'eau. Le serveur envoie les jetons en SSE et donne l'usage à la fin du flux. Un détail compte : une requête en streaming occupe son emplacement de concurrence jusqu'à la fermeture du flux.

Une clé d'essai autorise 2 requêtes simultanées et 60 par minute. Une clé complète en autorise 8 simultanées et 300 par minute. Dans une discussion de groupe, SillyTavern peut déclencher plusieurs réponses de personnages à la suite, voire en parallèle selon vos réglages. Si vous voyez des refus, c'est la première piste à vérifier.

Erreurs fréquentes et corrections

SymptômeCause probableCorrection
401, clé invalideClé mal copiée, espace en trop, clé suppriméeRecoller la clé, la régénérer si besoin
404 ou page introuvableURL sans /v1, ou avec un chemin en tropUtiliser exactement l'URL de base indiquée
Modèle introuvableNom de modèle différent de uncensoredSaisir l'identifiant à la main
429 rate_limitedTrop de requêtes par minuteEspacer les messages, passer à une clé complète
429 concurrencyTrop de requêtes en même tempsDésactiver les réponses parallèles de groupe
429 avec Retry-After: 5Surcharge temporaireAttendre 5 secondes et relancer
Solde insuffisantCrédit épuisé ou essai expiréRecharger depuis la page de tarifs

Pour suivre la dépense pendant une longue session, l'en-tête X-Balance-USD et la route GET /v1/balance donnent le solde en direct. Les requêtes échouées ou refusées ne sont pas facturées.

Garder un contexte léger sans perdre le fil

Le coût d'une longue session vient presque entièrement de l'entrée. Quelques habitudes l'allègent sans abîmer l'histoire :

  • Fiche de personnage compacte. Une description de 400 tokens bien écrite vaut mieux qu'une de 2 000 tokens pleine de redites. Elle est renvoyée à chaque message.
  • Résumés réguliers. Quand l'historique dépasse la taille voulue, résumez les 30 premiers échanges en un paragraphe et supprimez-les du contexte actif.
  • Exemples de dialogue en petit nombre. Deux ou trois suffisent à fixer le style.
  • Entrées de lore déclenchées par mots-clés plutôt que toujours présentes, si votre version de l'outil propose cette fonction.

Calculons l'effet : si ces mesures ramènent le contexte moyen de 16 000 à 6 000 tokens, l'entrée tombe à 6 000 × 0,15 / 1 000 000 = 0,0009 $ et le message complet à 0,0009 + 0,0002 = 0,0011 $. Sur 1 000 messages, vous passez de 2,60 $ à 1,10 $. L'écart reste modeste à petite échelle, mais il devient réel pour une application avec beaucoup d'utilisateurs.

Un dernier point de cadre : le modèle ne refuse pas par principe les scénarios sombres, donc la tonalité dépend surtout de votre fiche et de vos consignes. Si vous partagez vos personnages ou ouvrez un service à d'autres, c'est à vous de limiter l'accès aux adultes. Le site propose aussi un guide sur l'IA sans censure pour comprendre ce que le service permet.

Payer et garder la main sur le budget

Le service fonctionne au paiement à l'usage, sans abonnement. Les nouveaux utilisateurs peuvent réclamer 0,50 $ de crédit d'essai en un clic, valable 7 jours, sans moyen de paiement. Ensuite, la recharge se fait par montant entier de 20 $ à 500 $, en crypto (USDT sur TRC20 ou USDC sur Base), avec un bonus de 5 % dès 50 $, 10 % dès 100 $ et 15 % dès 200 $. Le crédit ne périme jamais. Le détail est sur la page tarifs.

Avec 20 $ et un message à 0,0026 $, vous disposez d'environ 7 692 messages (20 / 0,0026). Un contexte raisonnable et des réponses de longueur mesurée font donc durer longtemps un petit budget. Les prompts ne servent pas à entraîner le modèle.

Autres guides

Questions fréquentes

Quelle URL saisir dans SillyTavern ?

https://api.apiiasanscensure.com/v1, sans chemin supplémentaire. L'outil ajoute lui-même la route de complétion de chat.

Quel nom de modèle utiliser ?

uncensored. Si la liste déroulante ne le propose pas, saisissez-le manuellement.

Peut-on générer des images depuis SillyTavern avec cette API ?

Non. L'API ne traite que du texte, sans image, audio ni vidéo.

Pourquoi ai-je des erreurs 429 en discussion de groupe ?

Plusieurs réponses lancées en même temps dépassent la limite de requêtes simultanées. Une clé d'essai en autorise 2, une clé complète 8.

Votre clé est à une étape

Créez un compte, copiez la clé, modifiez l'URL de base. C'est tout.

Obtenir la clé APILire la documentation