API LLM senza censura per SillyTavern: passaggi di configurazione

Cosa ti serve prima di iniziare

Ti servono tre cose: un'installazione di SillyTavern in esecuzione, una chiave API e i dettagli dell'endpoint. SillyTavern è un'interfaccia chat self-hosted per conversazioni di personaggi e roleplay, e può comunicare con qualsiasi servizio che segua il formato chat OpenAI. Questo sito offre un servizio per uso adulto legale: finzione, roleplay e app per adulti. Non produrrà contenuti sessuali che coinvolgono minorenni e nessuna impostazione cambia questo.

Raccogli questi valori:

• URL base: https://api.ornith.top/v1
• ID modello: uncensored
• Chiave API: creata nella pagina della chiave API dopo aver effettuato l'accesso con Google o con email e password.

I nuovi account possono richiedere $0,50 di credito di prova con un clic in quella pagina. Non serve una carta, è uno per persona e dura 7 giorni. È più che sufficiente per testare una scheda personaggio, perché un turno di chat tipico costa una frazione di centesimo (il calcolo è più avanti).

Testa la chiave con curl prima

Prima di toccare SillyTavern, invia una richiesta da un terminale. Se funziona, qualsiasi errore successivo è un'impostazione del front-end; se fallisce, il problema è la chiave o la rete.

Copycurl https://api.ornith.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in one short sentence."}]
  }'

Dovresti ricevere JSON con un array choices. Guarda anche le intestazioni di risposta: X-Balance-USD mostra il tuo credito rimanente, e X-Request-Id è ciò che citare se contatti il supporto. Puoi anche elencare i modelli con GET /v1/models:

Copycurl https://api.ornith.top/v1/models \
  -H "Authorization: Bearer $API_KEY"

L'elenco mostra l'ID del modello da usare in SillyTavern, che è uncensored.

Collega SillyTavern passo dopo passo

1. Apri SillyTavern e clicca l'icona a forma di spina in alto per aprire Connessioni API.
2. Nel menu a tendina API scegli Completamento Chat.
3. Nel menu a tendina Chat Completion Source scegli Custom (OpenAI-compatible).
4. In Endpoint personalizzato (URL base) inserisci https://api.ornith.top/v1. Fermati a /v1. Non aggiungere /chat/completions, perché il client aggiunge quel percorso da solo.
5. Incolla la tua chiave nel campo Custom API Key.
6. In ID modello digita uncensored.
7. Premi Connetti. Uno stato verde con il nome del modello significa che il handshake è riuscito.

Le etichette del menu variano leggermente tra le versioni di SillyTavern; se un nome è diverso nella tua versione, cerca la stessa funzione: una sorgente personalizzata compatibile con OpenAI, un campo endpoint, un campo chiave e un campo modello. Se la connessione fallisce, ripeti il test curl. Un errore di autenticazione da curl indica una chiave errata; un curl funzionante con una connessione fallita indica solitamente un errore di battitura nell'URL, come la mancanza di /v1 o un percorso finale.

Una volta connesso, apri qualsiasi scheda personaggio e invia un messaggio. Se vedi una risposta, l'integrazione funziona. Il resto è la messa a punto.

Impostazioni importanti per il roleplay

Dimensione del contesto

Il modello ha una finestra di contesto da 100.000 token, che conta prompt e risposta insieme. In SillyTavern, il cursore delle dimensioni del contesto controlla quanto storico, scheda personaggio e testo del lorebook vengono inviati ogni turno. Valori più alti significano che il personaggio ricorda di più e ogni richiesta costa di più, perché paghi per i token di input ogni turno. Un buon punto di partenza è un valore moderato come 16.000 o 32.000 token, aumentato solo se le tue chat sono abbastanza lunghe da richiederlo. L'impostazione della lunghezza della risposta corrisponde a max_tokens, che è opzionale in questa API; imposta un valore se vuoi risposte più brevi.

Streaming

Attiva lo streaming nelle impostazioni di Completamento Chat. L'API supporta SSE con stream: true, quindi il testo appare mentre viene generato e puoi interrompere una risposta errata in anticipo. L'utilizzo viene riportato alla fine dello stream.

Campionamento

Temperatura, top_p, sequenze di stop, seed e le penalità di frequenza e presenza vengono passate al modello. Per chat creativa, una temperatura intorno a 0,8-1,0 con top_p vicino a 0,9 è un punto di partenza comune. Se le risposte divagano o si ripetono, abbassa leggermente la temperatura e aggiungi una piccola penalità di frequenza. Cambia un'impostazione alla volta per vederne l'effetto.

Il tuo system prompt e scheda

Il modello è ottimizzato per rispondere senza rifiuti di contenuto, quindi la qualità della scena dipende dal tuo prompt e dalla scheda personaggio. Un ruolo chiaro, un'impostazione, un tono e poche righe di esempio di dialogo fanno più di qualsiasi modifica del campionamento. Se scrivi per un pubblico adulto, mantieni l'impostazione esplicita sull'età: ogni personaggio dovrebbe essere un adulto.

Costo per messaggio, calcolato

La tariffazione è $0,15 per 1M di token di input e $0,50 per 1M di token di output, da credito prepagato senza abbonamento. Poiché SillyTavern rispedisce la scheda e la cronologia ad ogni turno, l'input domina.

Supponiamo che un turno di chat invii 6.000 token di contesto e riceva 400 token indietro:

• Input: 6.000 a $0,15 per 1M è $0,0009.
• Output: 400 a $0,50 per 1M è $0,0002.
• Totale: $0,0011 per turno.

Una sessione da 200 turni costa $0,22. Il credito di prova da $0,50 copre circa 450 turni di questo tipo. Le richieste fallite o rifiutate non vengono addebitate. Quando aggiungi credito, qualsiasi importo intero da $20 a $500 funziona, con +5% da $50, +10% da $100 e +15% da $200, con carta (Visa, Mastercard, Apple Pay, Google Pay) o cripto (USDT su TRC20, USDC su Base). Il credito non scade mai. La pagina dei prezzi ha i dettagli.

Correzione degli errori comuni

Sintomo	Causa probabile	Soluzione
La connessione fallisce subito	URL base o chiave errati	Usa https://api.ornith.top/v1 senza percorso finale; ripeti il test curl
HTTP 429, codice rate_limited	Troppe richieste al minuto	Rallenta; le chiavi di prova permettono 60 al minuto, quelle complete 300
HTTP 429, codice concurrency	Troppe richieste contemporaneamente	Attendi che la risposta in corso termini; le chiavi di prova permettono 2 simultanee, le chiavi complete 8
HTTP 429 con Retry-After: 5	Sovraccarico temporaneo	Riprova dopo 5 secondi
Richiesta troppo grande	Corpo oltre 8 MB	Abbassa la dimensione del contesto o riduci il lorebook
Contesto troppo lungo	Prompt più risposta oltre 100.000 token	Abbassa la dimensione del contesto o la lunghezza della risposta

Un dettaglio coglie di sorpresa le persone nelle chat di gruppo e con funzionalità che eseguono chiamate extra in background: una richiesta in streaming mantiene il suo slot di concorrenza fino alla fine dello stream. Se SillyTavern invia una risposta, un riepilogo e un lavoro di generazione didascalie nello stesso momento, una chiave di prova con 2 slot rifiuterà la terza. Una chiave completa permette 8. Disabilita le extra che non ti servono, oppure distanziale.

Per tutti i parametri e le esatte forme di errore, leggi la documentazione API.

Altre guide

• Uncensored LLM: cosa significa e come usarne uno
• Miglior LLM senza censura da eseguire localmente con Ollama
• Guida API LLM open source: configurazione, costi e alternative