Impostazioni API di SillyTavern: configura un'API compatibile con OpenAI
Le impostazioni API di SillyTavern sono veloci da configurare se hai pronti quattro valori: origine, base URL, chiave e nome del modello. Qui trovi cosa inserire, come scegliere contesto e lunghezza della risposta e come risolvere gli errori.


Punti chiave
- Inserisci un'origine compatibile con OpenAI, la base URL, la chiave API e il nome del modello uncensored.
- La dimensione del contesto nel client deve adattarsi alla finestra API da 100.000 token e al tuo budget.
- Le cause comuni di errore sono una base URL errata o un errore di battitura nella chiave.
- Il roleplay costa frazioni di centesimo per messaggio perché la cronologia viene inviata ogni volta.
I quattro valori di cui hai bisogno
SillyTavern è un frontend per chat e roleplay con carte personaggio. Può connettersi a diverse origini di testo, inclusi endpoint che parlano il formato OpenAI. Per la connessione ti servono esattamente quattro informazioni:
- Origine: un'origine chat-completion compatibile con OpenAI o personalizzata
- Base URL:
https://api.unzensiertesllm.com/v1 - Chiave API: La tua chiave dalla pagina Ottieni chiave API
- Nome del modello:
uncensored
I nomi dei menu e dei campi possono variare tra le versioni di SillyTavern. Fai riferimento ai termini sopra e, in caso di differenze, leggi la documentazione di SillyTavern stessa.
Connessione passo dopo passo
- Accedi a noi (Google o email con password) e genera la chiave. Dopo l'accesso ottieni con un clic $0,50 di credito di prova: una volta per persona, valido 7 giorni, senza dati di pagamento.
- In SillyTavern apri la sezione per le connessioni API.
- Seleziona come tipo API la variante chat-completion e come origine l'entry personalizzata compatibile con OpenAI (i nomi esatti dipendono dalla tua versione).
- Inserisci la base URL con il suffisso
/v1. - Inserisci la chiave senza spazi all'inizio o alla fine.
- Indica come modello
uncensoredo selezionalo dall'elenco, se il client interroga i modelli. - Connetti e invia un breve messaggio di test.
Se il client mostra un elenco modelli, chiama GET /v1/models. Se compare uncensored, indirizzo e chiave sono corretti.
Verifica la connessione al di fuori di SillyTavern
Se qualcosa non funziona, verifica indirizzo e chiave separatamente dal client. Questo risparmia indovinelli.
curl https://api.unzensiertesllm.com/v1/models \
-H "Authorization: Bearer DEIN_SCHLUESSEL"
curl https://api.unzensiertesllm.com/v1/chat/completions \
-H "Authorization: Bearer DEIN_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "messages": [{"role": "user", "content": "Sag kurz Hallo."}], "max_tokens": 30}'Se curl risponde, il problema è nel client. Se curl non risponde, il problema è nella chiave, nell'indirizzo o nella rete. Il saldo residuo lo vedi nell'header di risposta X-Balance-USD.
Scegli correttamente dimensione del contesto e lunghezza della risposta
Due regolatori determinano quanto viene inviato e generato per messaggio:
- Dimensione del contesto: Quanti token di cronologia, descrizione personaggio e informazioni mondiali viaggiano insieme. L'API permette fino a 100.000 token per prompt e risposta insieme. Non devi sfruttarlo al massimo. Per molti roleplay bastano poche migliaia di token, e ogni token di contesto costa di nuovo per ogni messaggio.
- Lunghezza della risposta: Corrisponde a
max_tokens. L'indicazione è opzionale nell'API; nel client impostala per evitare che le risposte si allunghino troppo.
Una regola pratica: scegli la dimensione del contesto in modo che la scheda personaggio, le note importanti e l'ultima dozzina di messaggi entrino. Tutto ciò che è più vecchio può essere scartato dal client, oppure puoi riassumerlo.
Valori del sampler
L'API inoltra temperature, top_p, stop, seed e i parametri di penalità. Inizia con valori moderati, ad esempio una temperatura intorno a 0,8, e modifica sempre un'impostazione alla volta. Altri sampler che SillyTavern offre per origini specifiche potrebbero non essere supportati da questa interfaccia; rimangono senza effetto. Verifica nella documentazione.
Quanto costa una sessione di roleplay
Prezzi: $0,15 per 1M token input, $0,50 per 1M token output. Supponendo che ogni messaggio invii 8.000 token di contesto e riceva 350 token di risposta:
- Input: 8.000 / 1.000.000 × $0,15 = $0,0012
- Output: 350 / 1.000.000 × $0,50 = $0,000175
- Totale: $0,001375 per messaggio
Una sessione con 200 messaggi costa quindi $0,275. Il credito di prova di $0,50 basta per circa 363 messaggi di questo tipo (0,50 / 0,001375 ≈ 363,6). Raddoppiando il contesto a 16.000 token, la quota input sale a $0,0024 e il messaggio a $0,002575.
Puoi ricaricare ogni importo intero da $20 a $500 con USDT su TRC20 o USDC su Base. Da $50 c'è un bonus del +5%, da $100 +10%, da $200 +15%. Il credito non scade mai. La scala è nella pagina prezzi.
Errori tipici e la loro soluzione
| Messaggio o sintomo | Causa | Soluzione |
|---|---|---|
| 401 o errore di autenticazione | Chiave errata, troncata o con spazi | Inserisci di nuovo, verifica con curl |
| 404 o modello non trovato | Manca /v1 o nome del modello errato | Inserisci la Base URL con /v1, modello uncensored |
429 con concurrency | Troppe richieste simultanee (chiave di test: 2, chiave completa: 8) | Chat di gruppo in sequenza invece che in parallelo, chiusura delle schede streaming |
429 con rate_limited | Troppe richieste al minuto (60 oppure 300) | Non generare di nuovo con troppa frequenza |
429 con Retry-After: 5 | Sovraccarico temporaneo | Attendi 5 secondi e invia di nuovo |
| La risposta si interrompe a metà frase | Lunghezza della risposta troppo piccola nel client | Aumentare la lunghezza della risposta |
| Errore per contesto troppo lungo | La cronologia da sola non entra nella finestra di contesto da 100.000 token (la risposta viene limitata allo spazio disponibile) | Ridurre la dimensione del contesto nel client, accorciare i messaggi più vecchi |
Una chiamata in streaming occupa il suo spazio nel limite di richieste parallele fino alla fine dello streaming. Questo spiega alcuni messaggi 429 sorprendenti quando hai aperte più chat.
Note su contenuti e privacy
Il modello è ottimizzato per servire scenari di finzione, roleplay e compagni per adulti senza rifiuto di contenuti. Si tratta di un singolo modello a pesi aperti di un fornitore indipendente, non dell'API ufficiale di un grande produttore. I contenuti sessuali con i minorenni sono esclusi senza eccezioni. L'API fornisce solo testo, non genera immagini o audio. I prompt non vengono utilizzati per l'addestramento.
Per saperne di più sulla selezione dei modelli senza censura, consulta il confronto delle IA senza censura.
Altre guide
Domande frequenti
Quale URL di base inserisco in SillyTavern?
Inserisci https://api.unzensiertesllm.com/v1, con il suffisso /v1. Come modello, specifica uncensored.
Quale dimensione del contesto è ragionevole?
L'API consente fino a 100.000 token per prompt e risposta combinati. Per il roleplay bastano spesso poche migliaia; valori superiori aumentano il costo per messaggio.
Perché ricevo un errore 429?
Il codice di errore indica la causa: rate_limited significa troppe richieste al minuto, concurrency troppe simultanee. Con la chiave di test valgono 60 al minuto e 2 simultanee.
Quanto costa una sessione con 200 messaggi?
Con 8.000 token di contesto e 350 token di risposta circa $0,275. Con più contesto il prezzo aumenta.
La tua chiave è a un clic di distanza
Crea l'account, copia la chiave, imposta l'URL di base. Fatto.
Ottieni la chiave API