Configuration de l'API SillyTavern : procédure de connexion compatible OpenAI
Nous expliquons les points de connexion, la clé, le nom du modèle et la valeur du contexte, souvent sources de confusion dans la configuration de l'API SillyTavern, accompagnés de commandes de vérification.
Date de mise à jour
Points clés
- Sélectionnez la connexion personnalisée Chat Completion (compatible OpenAI)
- URL : https://api.mukenetsuapi.com/v1, modèle : uncensored
- Le contexte peut atteindre 100 000, mais il est réaliste de le limiter pour des raisons de coût et de vitesse.
- 401 concerne la clé, 404 l'URL, 429 signale un dépassement suspecté de concurrence ou de nombre de requêtes

Préparez les 3 éléments nécessaires
La configuration de l'API SillyTavern est simple ; les erreurs proviennent souvent des valeurs saisies. Préparez les 3 éléments suivants.
- Clé API : émettez-la sur la page d'acquisition de clé API. Après l'inscription, vous pouvez recevoir un crédit d'essai de 0,50 $ en un clic.
- URL de base :
https://api.mukenetsuapi.com/v1 - Nom du modèle :
uncensored
SillyTavern est une interface qui permet d'ajouter des endpoints compatibles OpenAI. Comme cette API est compatible OpenAI, vous n'avez pas besoin de sélectionner l'API OpenAI officielle ; enregistrez-la simplement comme un endpoint personnalisé.
Procédure de connexion
Le libellé du menu peut varier selon la version. Nous décrivons ici la procédure générale. Si elle diffère, consultez également la documentation propre à SillyTavern.
- Ouvrez « API Connections » en haut (icône de fiche).
- Sélectionnez « Chat Completion » comme type d'API.
- Dans la liste des sources, choisissez la connexion personnalisée (Custom) compatible OpenAI.
- Saisissez
https://api.mukenetsuapi.com/v1dans l'URL de l'endpoint. N'ajoutez pas/chat/completionsà la fin. - Collez votre clé API dans le champ dédié. Veillez à ne pas inclure d'espaces avant ou après.
- Définissez le nom du modèle sur
uncensored. Sélectionnez-le dans la liste ou saisissez-le manuellement. - Cliquez sur le bouton de connexion et vérifiez que le message de succès s'affiche.
Avant de vous connecter, vérifiez la validité de la clé et de l'URL dans le terminal pour faciliter le dépannage en cas de problème.
curl https://api.mukenetsuapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'Si une réponse est renvoyée, la clé, l'URL et le nom du modèle sont corrects. Si SillyTavern échoue dans cet état, le problème vient probablement des paramètres de l'application.
Définir le contexte et la longueur de la réponse
La fenêtre de contexte de cette API permet d'utiliser jusqu'à 100 000 tokens pour le prompt et la sortie combinés. Cependant, nous ne recommandons pas de définir la taille du contexte de SillyTavern au maximum, car chaque entrée transmet à nouveau la configuration du personnage, l'univers et l'historique ; une valeur plus élevée augmente donc le volume d'entrée par requête.
Exemple de calcul des coûts
Si vous utilisez un contexte de 16 000 tokens et que la réponse fait 300 tokens, le coût par message est le suivant :
- Entrée : 16 000 ÷ 1 000 000 × $0,15 = $0,0024
- Sortie : 300 ÷ 1 000 000 × $0,50 = $0,00015
- Total : $0,00255
100 messages coûtent 0,255 $. Diviser le contexte par deux à 8 000 réduit d'environ moitié la charge d'entrée. Consultez la page des tarifs pour plus de détails sur les prix unitaires.
Recommandations
S'il ne s'agit pas de longs récits ou de scènes à plusieurs personnages, il est réaliste de commencer par 8 000 à 16 000, puis d'augmenter si vous sentez que le personnage oublie les événements passés. La longueur maximale de la réponse doit correspondre à la longueur souhaitée pour une seule réponse. max_tokens est optionnel, mais il est rassurant de définir une limite côté SillyTavern si vous souhaitez éviter des réponses trop longues.
Approche des paramètres d'échantillonnage
temperature, top_p, stop, seed et les diverses pénalités sont directement transmis à l'API. Vous pouvez les ajuster via les profils de SillyTavern.
- Répétitions de formulations : augmentez légèrement les pénalités de fréquence et de présence.
- Réponses désordonnées : baissez la température.
- Monotonie : augmentez légèrement la température.
- Comparaison : figez le seed et modifiez les valeurs une par une.
Les noms des champs des profils varient selon la version de SillyTavern. Si les paramètres ne sont pas appliqués, vérifiez si le protocole de connexion que vous utilisez prend en charge ces champs, ou consultez la documentation de SillyTavern.
Erreurs courantes et solutions
| Symptômes | Causes possibles | Solutions |
|---|---|---|
| 401 | Clé incorrecte ou présence d'espaces | Collez à nouveau la clé et testez-la avec curl. |
| 404 | URL incorrecte | Vérifiez que l'URL se termine par /v1. |
| Modèle introuvable | Orthographe du nom du modèle | Saisissez-le en minuscules : uncensored. |
429 (concurrency) | Trop de requêtes simultanées | Réduisez les taps ou swipes répétés, ainsi que la génération simultanée dans les chats de groupe. |
429 (rate_limited) | Limite de débit par minute dépassée | Attendez un peu. |
429 (avec Retry-After: 5) | Congestion temporaire | Attendez 5 secondes puis réessayez. |
La clé complète permet 8 requêtes simultanées et 300 par minute ; la clé d'essai permet 2 requêtes simultanées et 60 par minute. Une réponse en streaming occupe une connexion simultanée jusqu'à sa fin. Si vous utilisez une clé d'essai pour un chat de groupe, les limites seront rapidement atteintes.
Vous pouvez vérifier que votre solde est suffisant avec la commande suivante :
curl https://api.mukenetsuapi.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY"Vous pouvez également lire l'en-tête de réponse X-Balance-USD. Pour consulter la liste des modèles, utilisez GET /v1/models.
curl https://api.mukenetsuapi.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"Remarques d'utilisation
Cette API est dédiée au texte. Pour utiliser les fonctions de génération d'images ou de voix de SillyTavern, un autre service est nécessaire. Le contenu est conçu pour des utilisations adultes légales, telles que la fiction, le jeu de rôle ou les applications de compagnons. Les contenus sexuels impliquant des mineurs ne peuvent pas être générés, quelle que soit la configuration. Les prompts ne sont pas utilisés pour l'apprentissage du modèle.
Pour plus de détails sur les paramètres, consultez la documentation. Les paiements se font en USDT (TRC20) ou USDC (Base) par montants entiers de 20 $ à 500 $.
Autres guides
Questions fréquentes
Quel est le nom du modèle utilisé dans SillyTavern ?
Il s'agit de uncensored. Saisissez-le en minuscules, tel quel.
Faut-il ajouter /chat/completions à la fin de l'URL ?
Non. L'URL de base s'arrête à /v1 ; l'application ajoute le reste du chemin.
La clé d'essai est-elle suffisante ?
Elle est suffisante pour vérifier la connexion ou pour des conversations courtes. Cependant, la clé d'essai est limitée à 2 requêtes simultanées et 60 par minute, et sa durée de validité est de 7 jours. Si vous utilisez des chats de groupe, rechargez votre clé standard.
Pouvez-vous également générer des images ?
Non. Cette API est dédiée au texte et ne prend pas en charge la génération d'images, de voix ou de vidéos.
Quelle taille de fenêtre de contexte choisir ?
La limite maximale est de 100 000 tokens, mais il est réaliste de commencer par 8 000 à 16 000 tokens. Une taille plus importante augmente le volume d'entrée à chaque appel et donc le coût.
Obtenez votre clé API en un seul formulaire
Créez un compte, copiez votre clé et modifiez l'URL de base. Votre configuration est alors complète.