Risposta breve: la configurazione in cinque passaggi
Questa guida a SillyTavern parte da ciò che la maggior parte vuole sapere subito. Per usare World Info con questa API, colleghi SillyTavern all'endpoint, aumenti la dimensione del contesto e poi crei voci che si adattano a un budget di token.
- Crea una chiave API nella pagina chiavi.
- In SillyTavern, apri il pannello delle connessioni API, scegli Chat Completion e seleziona la sorgente Custom (OpenAI-compatible).
- Imposta l'URL dell'endpoint su
https://api.uncensoredvideo.top/v1, incolla la chiave e inserisciuncensoredcome ID del modello. - Imposta la dimensione del contesto per corrispondere alla finestra da 100.000 token, lasciando spazio per la reply.
- Apri World Info, crea un libro, collegalo al tuo personaggio o alla chat e regola le impostazioni del budget descritte di seguito.
Le etichette del menu variano tra le versioni di SillyTavern, quindi considera i nomi qui come una mappa e non come testo esatto. Il nome del sito menziona il video, ma il servizio è un'API testo: un modello a pesi aperti, ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale, senza generazione di immagini, audio o video. I contenuti sessuali che coinvolgono minori non sono consentiti.
Testa l'endpoint prima di toccare SillyTavern
Quando una connessione fallisce, la causa è quasi sempre un errore di battitura nell'URL o nella chiave. Un test di una riga evita di indovinare. Questo elenca il modello disponibile:
curl https://api.uncensoredvideo.top/v1/models -H "Authorization: Bearer YOUR_KEY"Poi invia una breve chat completion per confermare che la generazione funzioni:
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}'Se entrambi restituiscono JSON, SillyTavern si connetterà con gli stessi valori. L'URL base termina con /v1 e non include /chat/completions; SillyTavern aggiunge il percorso da solo. Un 401 indica una chiave errata. Il riferimento completo alla richiesta è nella documentazione API.
Perché World Info ha bisogno di una finestra grande
World Info, chiamato anche libro di ambientazione, inietta voci nel prompt quando le loro parole chiave appaiono nella chat recente. L'obiettivo è mantenere un grande mondo fuori dal prompt finché non diventa rilevante. Ma le voci rimangono comunque nel prompt quando si attivano, accanto alla scheda personaggio, alla cronologia della chat e al tuo system prompt. Su una finestra piccola, tutto compete per lo spazio e il libro di ambientazione perde.
Una finestra da 100.000 token, che copre prompt più completamento, cambia l'equilibrio. Puoi permetterti una scheda personaggio lunga, 50 o più messaggi di cronologia e diverse voci di ambientazione contemporaneamente. La finestra non significa che tu debba riempirla. Un prompt più lungo è più lento da elaborare, costa di più per messaggio e dà al modello più da ignorare. L'obiettivo è contesto rilevante, non contesto massimo.
Una ripartizione pratica per una finestra da 100.000 token:
- Scheda del personaggio e personalità: 1.500-3.000 token
- Budget World Info: 4.000-10.000 token
- Cronologia chat: tutto ciò che rimane, fino al tuo limite scelto
- Spazio di risposta: 500-1.500 token
Queste cifre sono suggerimenti per un gioco di ruolo tipico, non requisiti API. La maggior parte delle sessioni non ha mai bisogno dei limiti superiori.
Costruire voci che funzionano
Parole chiave e contenuto
Ogni voce ha parole chiave primarie che la attivano e un campo contenuto che viene iniettato. Scrivi le parole chiave nel modo in cui i giocatori le usano davvero. Per una città, aggiungi il nome, un soprannome e i nomi dei distretti. Le voci corrispondono ai messaggi recenti, quindi una parola chiave che appare solo nel testo dell'ambientazione non si attiverà mai.
Mantieni il contenuto breve e fattuale
Scrivi le voci come dichiarazioni compatte, non come prosa. Confronta queste due:
Harrow Quay: distretto portuale, controllato dalla Gilda del Sale. Contrabbando tollerato, omicidio no. Coprifuoco a mezzanotte, applicato da guardie assoldate.
Un paragrafo di atmosfera per lo stesso luogo può essere quattro volte più lungo e aggiungere poco che il modello non possa inventare. Riserva voci lunghe per i fatti che il modello deve conoscere bene: nomi, regole magiche, debiti.
Voci costanti, selettive e ricorsive
- Voci costanti sono sempre iniettate. Usale per regole che si applicano a ogni scena, come il tono dell'ambientazione o il funzionamento della magia, e mantieni il totale piccolo.
- Voci selettive usano parole chiave secondarie come filtro, quindi "dragon" si attiva solo quando viene menzionato anche "cave".
- Scansione ricorsiva permette al testo di una voce di attivarne altre. È potente per l'ambientazione collegata e può includere molto più di quanto ti aspetti. Imposta un limite ai passaggi di ricorsione.
Posizione e ordine
Le voci possono essere inserite prima o dopo le definizioni del personaggio, o a una profondità fissa nella chat. Una profondità vicina alla fine della cronologia mette il fatto vicino all'ultimo messaggio, dove i modelli tendono a pesarlo di più. I valori di ordine decidono quali voci sopravvivono quando il budget è stretto, quindi dai all'ambientazione essenziale una priorità più alta.
Impostazioni che controllano la spesa in token
Il pannello World Info ha alcuni controlli globali. I nomi variano per versione, ma esistono nelle versioni recenti.
| Impostazione | Cosa fa | Valore iniziale |
|---|---|---|
| Profondità di scansione | Quanti messaggi recenti vengono cercati per le keyword | 4-8 |
| Budget (percentuale del contesto) | Quota del contesto che World Info può utilizzare | 10-15 percent |
| Limite di budget | Un tetto rigido di token per World Info | 6,000-10,000 |
| Attivazioni minime | Continua a scandire più a fondo finché non si attivano abbastanza voci | 0 a meno che tu non ne abbia bisogno |
| Passaggi di ricorsione | Lunghezza massima della catena per gli attivatori ricorsivi | Da 2 a 3 |
Una profondità di scansione maggiore cattura il lore menzionato qualche turno fa, al prezzo di più falsi trigger. Con 100.000 token disponibili, un limite di budget è più per il controllo dei costi che per adattarsi alla finestra. Se vedi il modello scrivere improvvisamente di qualcosa di irrilevante, una parola chiave si sta attivando troppo ampiamente; passala a una voce selettiva.
Controlla anche che l'impostazione della cronologia delle chat in SillyTavern non tronchi i messaggi prima di quanto intendi. Il campo delle dimensioni del contesto è un limite su ciò che SillyTavern invia, quindi se rimane su un valore predefinito piccolo, la finestra grande non viene utilizzata.
Quanto costa una sessione di roleplay
I prezzi sono $0,15 per 1M token di input e $0,50 per 1M token di output. Il roleplay è input-heavy, perché SillyTavern rispedisce la scheda personaggio, lore e cronologia ad ogni messaggio.
Prendi un prompt di 12.000 token (scheda personaggio, alcune voci di lore, cronologia) e una risposta di 400 token.
- Input: 12.000 / 1.000.000 x $0,15 = $0,0018
- Output: 400 / 1.000.000 x $0,50 = $0,0002
- Totale: $0,002 per messaggio
Un centinaio di messaggi costano $0,20. Il credito di prova da $0,50 copre circa 250 messaggi con queste dimensioni. Aumenta il prompt a 40.000 token e la stessa risposta costa 40.000 / 1.000.000 x $0,15 = $0,006 per l'input più $0,0002 per l'output, quindi $0,0062 per messaggio, e il credito dura circa 80 messaggi (0,50 / 0,0062 è circa 80,6). Questo è il costo di un budget di lorebook molto grande e una cronologia lunga, ed è l'argomento per voci compatte.
Il credito di prova si ottiene con un clic nella pagina della chiave API dopo la registrazione, non richiede un metodo di pagamento, dura 7 giorni ed è uno a persona. Le ricariche vanno da $20 a $500 in qualsiasi importo intero, con +5% da $50, +10% da $100 e +15% da $200. Questo sito accetta solo cripto: USDT su TRC20 o USDC su Base. Il credito non scade mai e le richieste fallite o rifiutate non vengono addebitate. Tutti i dettagli sono nella pagina prezzi.
Risoluzione dei problemi e limiti
Una chiave completa permette 8 richieste parallele e 300 richieste al minuto. La chiave di prova ne permette 2 e 60. SillyTavern può superare due richieste parallele con chat di gruppo, swipe eseguiti rapidamente o una seconda scheda, e una risposta in streaming mantiene la sua slot fino alla fine. L'API risponde quindi con HTTP 429 e il codice concurrency. Un superamento del rate limit restituisce rate_limited, e un sovraccarico temporaneo include l'intestazione Retry-After: 5. Aspettare qualche secondo e riprovare è sufficiente.
- Risposte troncate. Controlla la lunghezza massima della risposta in SillyTavern. Imposta
max_tokens, che è facoltativo su questa API. - L'ambientazione non si attiva mai. Aumenta la profondità di scansione e verifica l'ortografia della parola chiave rispetto a come appare nella chat.
- Le risposte ignorano il lore che si è attivato. Sposta la voce a una profondità più vicina alla fine della cronologia, o accorciala in modo che risalti.
- Il prompt sembra lento. Riduci il limite di budget e la lunghezza della cronologia delle chat prima di dare la colpa all'endpoint.
Per personaggi che parlano in uno stile fisso, imposta temperature intorno a 0,8-1,0 e aggiungi una leggera penalità di frequenza se il modello ripete frasi. I prompt non sono usati per l'addestramento. Il modello è un singolo modello a pesi aperti gestito da un provider indipendente, non un router tra fornitori, quindi la qualità dipende da quel singolo modello piuttosto che da un insieme.
