FR ▾
Obtenir la clé API

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
Image de la connexion API de SillyTavern : un masque de scène et une fiche du serveur reliés par un câble lumineux.

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.

  1. Ouvrez « API Connections » en haut (icône de fiche).
  2. Sélectionnez « Chat Completion » comme type d'API.
  3. Dans la liste des sources, choisissez la connexion personnalisée (Custom) compatible OpenAI.
  4. Saisissez https://api.mukenetsuapi.com/v1 dans l'URL de l'endpoint. N'ajoutez pas /chat/completions à la fin.
  5. Collez votre clé API dans le champ dédié. Veillez à ne pas inclure d'espaces avant ou après.
  6. Définissez le nom du modèle sur uncensored. Sélectionnez-le dans la liste ou saisissez-le manuellement.
  7. 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ômesCauses possiblesSolutions
401Clé incorrecte ou présence d'espacesCollez à nouveau la clé et testez-la avec curl.
404URL incorrecteVérifiez que l'URL se termine par /v1.
Modèle introuvableOrthographe du nom du modèleSaisissez-le en minuscules : uncensored.
429 (concurrency)Trop de requêtes simultanéesRé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éeAttendez un peu.
429 (avec Retry-After: 5)Congestion temporaireAttendez 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.

Obtenir la clé API