Réponse courte : la configuration en cinq étapes
Ce guide World Info SillyTavern commence par la partie que la plupart des gens veulent en premier. Pour utiliser World Info avec cette API, vous connectez SillyTavern à l'endpoint, augmentez la taille du contexte, puis créez des entrées adaptées à un budget en tokens.
- Créez une clé API sur la page clé.
- Dans SillyTavern, ouvrez le panneau des connexions API, choisissez Complétion de chat et sélectionnez la source Personnalisée (compatible OpenAI).
- Définissez l'URL de l'endpoint sur
https://api.uncensoredvideo.top/v1, collez la clé et saisissezuncensoredcomme ID de modèle. - Définissez la taille du contexte pour correspondre à la fenêtre de 100 000 tokens, en laissant de la place pour la réponse.
- Ouvrez World Info, créez un livre, attachez-le à votre personnage ou à votre discussion, et réglez les paramètres de budget décrits ci-dessous.
Les étiquettes du menu changent entre les versions de SillyTavern, considérez les noms ici comme une carte plutôt que comme le libellé exact. Le nom du site mentionne la vidéo, mais le service est une API textuelle : un seul modèle à poids ouverts, ajusté pour répondre sans refus de contenu pour un usage adulte légal, sans génération d'image, d'audio ou de vidéo. Le contenu sexuel impliquant des mineurs n'est pas autorisé.
Testez l'endpoint avant de toucher à SillyTavern
En cas d'échec de connexion, la cause est presque toujours une faute de frappe dans l'URL ou la clé. Un test en une ligne évite les suppositions. Voici les modèles disponibles :
curl https://api.uncensoredvideo.top/v1/models -H "Authorization: Bearer YOUR_KEY"Ensuite, envoyez une courte complétion de chat pour confirmer que la génération fonctionne :
curl https://api.uncensoredvideo.top/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}'Si les deux retournent du JSON, SillyTavern se connectera avec les mêmes valeurs. L'URL de base se termine par /v1 et n'inclut pas /chat/completions ; SillyTavern ajoute le chemin lui-même. Un 401 signifie une mauvaise clé. La référence complète de la requête se trouve dans la documentation API.
Pourquoi World Info nécessite une grande fenêtre de contexte
World Info, aussi appelé livre de lore, injecte des entrées dans le prompt lorsque leurs mots-clés apparaissent dans les messages récents. L'objectif est de garder un grand monde hors du prompt jusqu'à ce qu'il soit pertinent. Mais les entrées restent dans le prompt lorsqu'elles sont activées, à côté de la fiche personnage, de l'historique du chat et de votre prompt système. Sur une petite fenêtre, tout cela concurrence l'espace, et le livre de lore perd.
Une fenêtre de 100 000 tokens, qui couvre le prompt et la complétion, change l'équilibre. Vous pouvez vous permettre une longue fiche de personnage, 50 messages d'historique ou plus et plusieurs entrées de lore à la fois. La fenêtre ne signifie pas que vous devriez la remplir. Un prompt plus long est plus lent à traiter, coûte plus cher par message et donne au modèle plus à ignorer. L'objectif est un contexte pertinent, pas un contexte maximal.
Une répartition pratique pour une fenêtre de contexte de 100 000 tokens :
- Fiche de personnage et persona : 1 500 à 3 000 tokens
- Budget World Info : 4 000 à 10 000 tokens
- Historique du chat : tout ce qui reste, jusqu'à votre limite choisie
- Espace de réponse : 500 à 1 500 tokens
Ces chiffres sont des suggestions pour un jeu de rôle typique, pas des exigences de l'API. La plupart des sessions n'ont jamais besoin des limites supérieures.
Construire des entrées efficaces
Mots-clés et contenu
Chaque entrée a des mots-clés principaux qui la déclenchent et un champ de contenu qui est injecté. Écrivez les mots-clés comme les joueurs les disent réellement. Pour une ville, ajoutez le nom, un surnom et les noms des districts. Les entrées correspondent aux messages récents, donc un mot-clé qui n'apparaît que dans le texte du lore ne sera jamais activé.
Gardez le contenu court et factuel
Rédigez des entrées sous forme de déclarations compactes, pas de prose. Comparez ces deux exemples :
Harrow Quay : quartier portuaire, contrôlé par la Guilde du Sel. Contrebande tolérée, meurtre non. Couvre-feu à minuit, appliqué par des gardes embauchés.
Un paragraphe d'atmosphère pour le même endroit peut être quatre fois plus long et ajouter peu ce que le modèle ne peut pas inventer. Réservez les entrées longues aux faits que le modèle doit connaître exactement : noms, règles de magie, dettes entre personnages.
Entrées constantes, sélectives et récursives
- Les entrées constantes sont toujours injectées. Utilisez-les pour les règles qui s'appliquent à chaque scène, comme le ton du décor ou le fonctionnement de la magie, et gardez le total faible.
- Entrées sélectives utilisent des mots-clés secondaires comme filtre, donc "dragon" ne se déclenche que si "grotte" est également mentionné.
- L'analyse récursive permet au texte d'une entrée d'en déclencher d'autres. C'est puissant pour un univers lié, mais cela peut en inclure bien plus que vous ne l'espérez. Définissez une limite d'étapes de récursion.
Position et ordre
Les entrées peuvent être insérées avant ou après les définitions du personnage, ou à une profondeur définie dans le chat. Une profondeur proche de la fin de l'historique place le fait près du message le plus récent, où les modèles ont tendance à lui donner plus de poids. Les valeurs d'ordre décident quelles entrées survivent lorsque le budget est serré, donc donnez une priorité plus élevée au lore essentiel.
Paramètres qui contrôlent la dépense en tokens
Le panneau World Info dispose de quelques contrôles globaux. Les noms varient selon la version, mais ceux-ci existent dans les versions récentes.
| Paramètre | Ce qu'il fait | Valeur de départ |
|---|---|---|
| Profondeur de scan | Nombre de messages récents recherchés pour les mots-clés | 4 à 8 |
| Budget (pourcentage du contexte) | Part du contexte que World Info peut utiliser | 10 à 15 pour cent |
| Plafond de budget | Plafond dur en tokens pour World Info | 6 000 à 10 000 |
| Activations minimales | Continue de scanner plus profondément jusqu'à ce que suffisamment d'entrées s'activent | 0 sauf si vous en avez besoin |
| Étapes de récursion | Longueur maximale de la chaîne pour les déclencheurs récursifs | 2 à 3 |
Une profondeur de scan plus élevée capture le lore mentionné il y a quelques tours, au prix de plus de déclenchements faux. Avec 100 000 tokens disponibles, un plafond de budget sert surtout à contrôler les coûts plutôt qu'à remplir la fenêtre. Si vous voyez le modèle écrire soudainement sur quelque chose d'irrélevant, un mot-clé se déclenche trop largement ; passez-le à une entrée sélective.
Vérifiez également que le paramètre d'historique de chat dans SillyTavern ne coupe pas les messages plus tôt que vous ne le souhaitez. Le champ de taille de contexte est une limite sur ce que SillyTavern envoie, donc s'il reste à une valeur par défaut petite, la grande fenêtre n'est pas utilisée.
Combien coûte une session de jeu de rôle
La tarification est de 0,15 $ par 1M de tokens d'entrée et 0,50 $ par 1M de tokens de sortie. Le jeu de rôle est lourd en entrée, car SillyTavern renvoie la fiche de personnage, le lore et l'historique à chaque message.
Prenons un prompt de 12 000 tokens (fiche de personnage, quelques entrées de lore, historique) et une réponse de 400 tokens.
- Entrée : 12 000 / 1 000 000 x 0,15 $ = 0,0018 $
- Sortie : 400 / 1 000 000 x 0,50 $ = 0,0002 $
- Total : 0,002 $ par message
Cent messages coûtent 0,20 $. Le crédit d'essai de 0,50 $ couvre environ 250 messages à cette taille. Poussons le prompt à 40 000 tokens et la même réponse coûte 40 000 / 1 000 000 x 0,15 $ = 0,006 $ pour l'entrée plus 0,0002 $ pour la sortie, soit 0,0062 $ par message, et le crédit dure environ 80 messages (0,50 / 0,0062 est environ 80,6). C'est le coût d'un budget de lorebook très large et d'un long historique, et c'est l'argument pour des entrées serrées.
Le crédit d'essai est réclamé en un clic sur la page de clé API après l'inscription, ne nécessite pas de moyen de paiement, dure 7 jours et est accordé une fois par personne. Les recharges vont de 20 $ à 500 $ dans n'importe quel montant entier, avec +5 % à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $. Ce site n'accepte que la crypto : USDT sur TRC20 ou USDC sur Base. Le crédit n'expire jamais, et les requêtes échouées ou refusées ne sont pas facturées. Les détails complets sont sur la page tarification.
Dépannage et limites
Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute. La clé d'essai permet 2 et 60. SillyTavern peut dépasser deux requêtes simultanées avec des chats de groupe, des glissements déclenchés rapidement, ou un deuxième onglet, et une réponse en streaming occupe son slot jusqu'à sa fin. L'API répond alors HTTP 429 avec le code concurrency. Une surcharge de taux de requête retourne rate_limited, et une surcharge temporaire vient avec un en-tête Retry-After: 5. Attendre quelques secondes et réessayer suffit.
- Réponses coupées. Vérifiez la longueur maximale de réponse dans SillyTavern. Elle définit
max_tokens, qui est optionnel sur cette API. - Le lore ne se déclenche jamais. Augmentez la profondeur de scan et vérifiez l'orthographe du mot-clé par rapport à son apparition dans le chat.
- Les réponses ignorent le lore qui s'est déclenché. Déplacez l'entrée à une profondeur plus proche du bas de l'historique, ou raccourcissez-la pour qu'elle se distingue.
- Le prompt semble lent. Réduisez le plafond de budget et la longueur de l'historique du chat avant de blâmer l'endpoint.
Pour les personnages qui parlent dans un style fixe, réglez temperature autour de 0,8 à 1,0 et ajoutez une pénalité de fréquence légère si le modèle répète des phrases. Les prompts ne sont pas utilisés pour l'entraînement. Le modèle est un seul modèle à poids ouverts exécuté par un fournisseur indépendant, pas un routeur entre fournisseurs, donc la qualité dépend de ce modèle unique plutôt que d'un pool.
