Clé API DeepSeek dans SillyTavern : connectez notre API

Configuration rapide

Pour une configuration de SillyTavern avec une clé API DeepSeek, une précision d'abord. Une clé émise par la plateforme officielle de DeepSeek est destinée à son endpoint. La clé que vous obtenez sur ce site appartient à un service distinct : une API indépendante compatible OpenAI exécutant un modèle à poids ouverts, optimisé pour répondre sans refus de contenu pour un usage adulte légal. Ce n'est pas l'API officielle de DeepSeek, utilisez donc la clé de ce site uniquement avec l'URL de base de ce site.

Les valeurs à saisir dans SillyTavern sont :

• Source : Chat Completion, puis Custom (compatible OpenAI)
• Endpoint Custom (URL de base) : https://api.deepseekapikey.com/v1
• Clé API : la clé issue de votre compte
• ID de modèle : uncensored

SillyTavern est mis à jour fréquemment et les libellés des menus peuvent légèrement varier entre les versions, donc adaptez-vous au sens si un nom diffère. Le reste de cette page détaille chaque étape et les paramètres importants pour les conversations longues avec des personnages.

Étape par étape dans l'interface

1. Obtenez une clé. Inscrivez-vous sur la page clé API avec Google ou avec e-mail et mot de passe. Les nouveaux utilisateurs peuvent obtenir 0,50 $ de crédit d'essai gratuit en un clic, valable 7 jours, un par personne, sans carte.
2. Ouvrez le panneau de connexion API. Dans SillyTavern, cliquez sur l'icône de prise en haut pour ouvrir les Connexions API.
3. Sélectionnez le type d'API. Choisissez Chat Completion dans le menu déroulant API. Les modes de complétion de texte sont destinés aux backends qui prennent des prompts bruts ; cette API utilise des messages de chat.
4. Sélectionnez la source. Dans la liste des sources Chat Completion, choisissez Custom (compatible OpenAI).
5. Saisissez l'endpoint. Collez https://api.deepseekapikey.com/v1 dans le champ endpoint personnalisé. SillyTavern ajoute lui-même le chemin chat completions, donc laissez-le de côté. Si vous obtenez une erreur 404 plus tard, essayez le chemin complet comme tentative secondaire.
6. Entrez la clé. Collez la clé dans le champ clé API personnalisé.
7. Saisissez le modèle. Tapez uncensored dans le champ ID de modèle. Si un menu déroulant de modèles se charge depuis l'endpoint GET /v1/models, vous pouvez le choisir à partir de là.
8. Établissez la connexion. Appuyez sur Connecter. Un statut vert et le nom du modèle signifient que l'appel a réussi. Envoyez un message à un personnage pour confirmer.

Si la connexion échoue, testez en dehors de SillyTavern dans un terminal. Cela isole le problème :

Copycurl https://api.deepseekapikey.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}'

Une réponse JSON normale signifie que la clé et l'URL sont valides et que le problème réside dans les champs de SillyTavern. Le guide de démarrage rapide propose plus d'exemples.

Taille du contexte et longueur de réponse

C'est là que les configurations de jeu de rôle fonctionnent bien ou gaspillent de l'argent. Le modèle dispose d'une fenêtre de contexte de 100 000 tokens, comptant le prompt et la réponse ensemble. SillyTavern dispose de son propre curseur Taille du contexte dans les paramètres d'échantillonnage, qui contrôle la quantité d'historique et de données de personnage qu'il inclut dans chaque requête.

Vous pouvez le régler aussi haut que 100 000, mais réfléchissez à ce que cela signifie. SillyTavern construit le prompt complet à chaque tour : prompt système, fiche personnage, entrées du lorebook, persona, puis autant d'historique de chat que possible. Un paramètre plus élevé signifie que le modèle voit plus de passé, et vous payez pour chacun de ces tokens à nouveau à chaque message.

Une méthode pratique pour choisir :

• 8 000 à 16 000 tokens : scènes courtes et chats rapides. Peu coûteux et rapides.
• 30 000 à 50 000 tokens : une longue histoire avec une fiche de personnage détaillée et un lorebook. Convient à la plupart des utilisateurs.
• Jusqu'à 100 000 tokens : de grands lorebooks ou des histoires très longues et continues. Laissez une marge pour que le prompt plus la réponse restent sous la fenêtre de contexte.

Pour la longueur de réponse, réglez la Longueur maximale de réponse entre 300 et 600 tokens pour une réponse de jeu de rôle typique. Le paramètre max_tokens est optionnel dans l'API, mais SillyTavern envoie une valeur, et une limite empêche une réponse trop longue de faire exploser la facture. Activez l'option streaming pour que le texte apparaisse au fur et à mesure de sa génération ; l'API prend en charge les événements envoyés par le serveur avec stream: true.

Le passage des pénalités et des valeurs d'échantillonnage fonctionne comme l'interface le suggère. Temperature, Top P, pénalité de fréquence et pénalité de présence sont envoyés au modèle, et les séquences d'arrêt et une graine fixe sont également transmises. Commencez avec une température d'environ 0,8 et ajustez : plus bas si le personnage perd le fil des faits, plus haut si les réponses semblent répétitives.

Coût du jeu de rôle

Le prix est de 0,15 $ par 1M de tokens d'entrée et 0,50 $ par 1M de tokens de sortie. L'entrée domine à cause de l'historique renvoyé. Exemples de calcul, avec une réponse de 400 tokens à chaque fois :

Vérifiez une ligne : 20 000 / 1 000 000 x 0,15 $ = 0,003 $, et 400 / 1 000 000 x 0,50 $ = 0,0002 $, ce qui donne 0,0032 $. À cette taille, le crédit d'essai de 0,50 $ couvre environ 156 messages. Les requêtes échouées ou refusées ne sont pas facturées, donc les nouvelles tentatives après une erreur n'ajoutent pas à la facture. Les swipes et les régénérations sont comptés, car chacun est une nouvelle requête complétée.

Le crédit est prépayé, n'expire jamais, et il n'y a pas d'abonnement. Rechargez un montant entier de 20 $ à 500 $, avec +5 % à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $. Par exemple, un rechargement de 100 $ donne 110 $ de crédit. Vous pouvez payer par crypto (USDT sur TRC20, USDC sur Base). La page tarifs contient la liste actuelle.

Chats de groupe, swipes et limites de débit

SillyTavern peut envoyer plusieurs requêtes proches les unes des autres : discussions de groupe où plusieurs personnages répondent séquentiellement, swipes, et extensions qui résument ou génèrent du contenu secondaire. 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.

Si vous voyez une erreur avec le code concurrency, trop de requêtes s'exécutaient en même temps. Attendez que le streaming actuel se termine avant de swiper à nouveau, car une requête en streaming garde son slot jusqu'à la fin du streaming. Une erreur avec le code rate_limited signifie trop de requêtes par minute. Une erreur 429 accompagnée de l'en-tête Retry-After: 5 est une surcharge temporaire qui se résout rapidement.

Pour les longues histoires, pensez à utiliser l'extension de résumé ou les entrées de lorebook pour transmettre les faits, afin de pouvoir maintenir une taille de contexte plus faible. Un court résumé des événements précédents en haut du prompt coûte beaucoup moins cher que le maintien de cinquante mille tokens d'historique brut.

Correction des problèmes courants

Connect indique non autorisé

La clé est incorrecte, contient un espace à la fin ou provient d'un autre service. Une clé émise par la plateforme DeepSeek ne fonctionne pas avec cette URL de base.

Connect indique introuvable

Vérifiez l'orthographe de l'endpoint. Il devrait se terminer par /v1 dans la configuration courante. Certaines versions s'attendent au chemin complet chat completions, donc si la forme courte échoue, essayez https://api.deepseekapikey.com/v1/chat/completions.

Les réponses sont courtes ou tronquées

Augmentez la longueur maximale de réponse. Si la troncature ne se produit que sur les longues conversations, votre prompt est peut-être proche de la limite de la fenêtre ; réduisez légèrement la taille du contexte pour laisser de la place à la réponse.

Le personnage oublie les événements précédents

C'est le paramètre de contexte qui agit. Augmentez-le, ou déplacez les faits clés dans la fiche du personnage, le persona ou une entrée de lorebook afin qu'ils soient présents dans chaque prompt.

La réponse est rejetée

Le modèle est ajusté pour éviter les refus de contenu pour une utilisation adulte légale, mais une règle ne change pas : pas de contenu sexuel impliquant des mineurs. Les personnages et scénarios dans ce domaine sont refusés. Le service étant uniquement textuel, la génération d'images dans SillyTavern nécessite un backend différent.

Les prompts envoyés via l'API ne sont pas utilisés pour l'entraînement. Vos fichiers de conversation restent dans le dossier de données de SillyTavern sur votre machine, sauf si vous les déplacez. Si vous souhaitez connaître les différences entre ce service et celui de DeepSeek, consultez DeepSeek API : mythes vs. faits.

Plus de guides

• Clé API DeepSeek dans Janitor AI : configuration avec notre API
• Clé API DeepSeek dans VS Code : configuration avec notre API
• API DeepSeek : mythes contre faits pour un accès sans censure