FR ▾

Paramètres API SillyTavern : configurer une API compatible OpenAI

Les paramètres API de SillyTavern sont rapides à configurer si vous disposez de quatre valeurs : source, URL de base, clé et nom du modèle. Voici ce que vous devez saisir, comment choisir la taille du contexte et de la réponse, et comment résoudre les erreurs.

IA sans censure : API LLM vs modèles locaux vs services cloud

Mis à jour le

Scène de théâtre avec des masques et des bulles de dialogue lumineuses menant à une prise : connecter SillyTavern à une API

Points importants

  • Saisissez une source compatible OpenAI, l'URL de base, la clé API et le nom du modèle uncensored.
  • La taille du contexte dans le client doit correspondre à la fenêtre de contexte de 100 000 tokens de l'API et à votre budget.
  • Les erreurs courantes proviennent d'une mauvaise URL de base ou d'une faute de frappe dans la clé.
  • Le jeu de rôle coûte une fraction de centime par message, car l'historique est envoyé à chaque fois.

Les quatre valeurs dont vous avez besoin

SillyTavern est une interface pour les chats et les jeux de rôle avec des cartes de personnages. Il peut se connecter à différentes sources de texte, y compris des points de terminaison qui parlent le format OpenAI. Pour la connexion, vous avez besoin exactement de quatre informations :

  • Source : une source de chat completion compatible OpenAI ou personnalisée
  • URL de base : https://api.unzensiertesllm.com/v1
  • Clé API : votre clé depuis la page Obtenir une clé API
  • Nom du modèle : uncensored

Les noms des menus et des champs peuvent varier selon les versions de SillyTavern. Référez-vous aux termes ci-dessus et lisez la documentation de SillyTavern en cas d'écart.

Connexion étape par étape

  1. Connectez-vous à nous (Google ou e-mail avec mot de passe) et générez la clé. Après la connexion, récupérez $0,50 de crédit d'essai en un clic : une fois par personne, valable 7 jours, sans données de paiement.
  2. Ouvrez dans SillyTavern la section des connexions API.
  3. Sélectionnez la variante chat-completion comme type d'API et la source personnalisée compatible OpenAI (les noms exacts dépendent de votre version).
  4. Saisissez l'URL de base avec le suffixe /v1.
  5. Insérez la clé sans espaces au début ou à la fin.
  6. Indiquez le modèle uncensored ou sélectionnez-le dans la liste si le client interroge les modèles.
  7. Connectez-vous et envoyez un court message de test.

Si le client affiche une liste de modèles, il appelle GET /v1/models. Si uncensored apparaît dans la liste, l'adresse et la clé sont correctes.

Vérifier la connexion en dehors de SillyTavern

Si cela ne fonctionne pas, vérifiez l'adresse et la clé séparément du client. Cela évite de deviner.

curl https://api.unzensiertesllm.com/v1/models \
  -H "Authorization: Bearer DEIN_SCHLUESSEL"

curl https://api.unzensiertesllm.com/v1/chat/completions \
  -H "Authorization: Bearer DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Sag kurz Hallo."}], "max_tokens": 30}'

Si curl répond, le problème vient du client. Si curl ne répond pas, le problème vient de la clé, de l'adresse ou du réseau. Le solde restant est visible dans l'en-tête de réponse X-Balance-USD.

Choisir correctement la taille du contexte et la longueur de réponse

Deux curseurs déterminent quelle quantité est envoyée et générée par message :

  • Taille du contexte : Combien de tokens d'historique, de description de personnage et d'informations mondiales sont envoyés ensemble. L'API autorise jusqu'à 100 000 tokens pour le prompt et la réponse combinés. Vous n'avez pas besoin de l'exploiter au maximum. Pour beaucoup de jeux de rôle, quelques milliers de tokens suffisent, et chaque token de contexte coûte à chaque message.
  • Longueur de réponse : Correspond à max_tokens. L'option est facultative dans l'API ; dans le client, définissez-la pour éviter que les réponses ne s'étendent trop.

Une règle pratique : choisissez la taille du contexte de sorte que la carte de personnage, les notes importantes et la dernière douzaine de messages tiennent dans la fenêtre de contexte. Tout ce qui est plus ancien peut être ignoré par le client, ou vous pouvez le résumer.

Valeurs du sampler

L'API transmet temperature, top_p, stop, seed et les paramètres de pénalité. Commencez avec des valeurs modérées, par exemple une température autour de 0,8, et modifiez toujours un seul paramètre à la fois. D'autres samplers que SillyTavern propose pour certaines sources peuvent ne pas être pris en charge par cette interface ; ils restent alors sans effet. Vérifiez cela dans la documentation.

Combien coûte une session de jeu de rôle

Prix : $0,15 par 1M de tokens d'entrée, $0,50 par 1M de tokens de sortie. Supposons que chaque message envoie 8 000 tokens de contexte et reçoive 350 tokens de réponse :

  • Entrée : 8 000 / 1 000 000 × $0,15 = $0,0012
  • Sortie : 350 / 1 000 000 × $0,50 = $0,000175
  • Total : $0,001375 par message

Une session de 200 messages coûte donc $0,275. Le crédit d'essai de $0,50 suffit pour environ 363 de ces messages (0,50 / 0,001375 ≈ 363,6). Si vous doublez le contexte à 16 000 tokens, la part d'entrée augmente à $0,0024 et le message à $0,002575.

Vous pouvez recharger n'importe quel montant entier de $20 à $500 avec USDT sur TRC20 ou USDC sur Base. À partir de $50, il y a +5 % de bonus, à partir de $100 +10 %, à partir de $200 +15 %. Le crédit prépayé n'expire jamais. Le palier est sur la page des tarifs.

Erreurs courantes et leurs solutions

Message ou symptômeCauseSolution
401 ou erreur d'authentificationClé incorrecte, tronquée ou avec des espacesRéinsérer, vérifier avec curl
404 ou modèle introuvable/v1 manquant ou nom de modèle incorrectEntrez l'URL de base avec /v1, modèle uncensored
429 avec concurrencyTrop de requêtes simultanées (clé de test : 2, clé complète : 8)Fermez les onglets de streaming, utilisez les chats de groupe séquentiellement au lieu de manière parallèle
429 avec rate_limitedTrop de requêtes par minute (60 ou 300 respectivement)Ne pas déclencher la régénération trop rapidement
429 avec Retry-After: 5Surcharge temporaireAttendez 5 secondes et renvoyez la requête
Réponse interrompue en plein milieu d'une phraseLongueur de réponse trop faible dans le clientAugmenter la longueur de réponse
Erreur due à un contexte trop longL'historique seul ne tient pas dans la fenêtre de 100 000 tokens (la réponse est limitée à l'espace restant)Réduire la taille du contexte dans le client, raccourcir les messages anciens

Un appel en streaming occupe sa place dans la limite de débit pour les requêtes simultanées jusqu'à la fin du flux. Cela explique certains messages 429 surprenants lorsque vous avez plusieurs chats ouverts.

Informations sur le contenu et la confidentialité

Le modèle est conçu pour servir la fiction, le jeu de rôle et les scénarios pour adultes sans refus de contenu. Il s'agit d'un seul modèle à poids ouverts fourni par un tiers indépendant, et non de l'API officielle d'un grand fournisseur. Les contenus sexuels impliquant des mineurs sont exclus sans exception. L'API fournit uniquement du texte ; elle ne génère pas d'images ni de voix. Les prompts ne sont pas utilisés pour l'entraînement.

Pour en savoir plus sur le choix de modèles sans censure, consultez le comparatif des IA sans censure.

Autres guides

Questions fréquentes

Quelle Base URL saisir dans SillyTavern ?

https://api.unzensiertesllm.com/v1, avec le suffixe /v1. Pour le modèle, indiquez uncensored.

Quelle taille de contexte est appropriée ?

L'API autorise jusqu'à 100 000 tokens pour le prompt et la réponse. Pour le jeu de rôle, quelques milliers suffisent souvent ; des valeurs plus élevées augmentent le coût par message.

Pourquoi obtiens-je une erreur 429 ?

Le code d'erreur indique la cause : rate_limited signifie trop de requêtes par minute, concurrency trop de requêtes simultanées. Avec la clé de test, 60 par minute et 2 simultanément s'appliquent.

Combien coûte une session de 200 messages ?

Avec 8 000 tokens de contexte et 350 tokens de réponse, environ $0,275. Avec plus de contexte, le prix augmente.

Votre clé est à un clic de distance

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

Obtenir la clé API