Come usare l'API DeepSeek in SillyTavern: endpoint personalizzato

Configurazione in cinque passaggi

La domanda su come usare l'API DeepSeek in SillyTavern si riduce a un fatto: SillyTavern può comunicare con qualsiasi endpoint compatibile con OpenAI, quindi fornisci solo un URL, una chiave e un ID del modello. Nota che questo servizio non è l'API ufficiale DeepSeek. Ospita un modello a pesi aperti con ID uncensored, gestito da un provider indipendente e ottimizzato per rispondere senza rifiuti sui contenuti per uso adulto legale.

1. Crea un account e apri la pagina della chiave API. Copia una chiave. I nuovi utenti possono richiedere $0,50 di credito di prova con un clic, senza carta, valido per 7 giorni.
2. In SillyTavern, apri la scheda Connessioni API (l'icona della presa nella barra in alto).
3. Imposta il tipo di API su Chat Completion. Poi imposta la Fonte Chat Completion su Custom (compatibile con OpenAI).
4. Nel campo endpoint personalizzato inserisci https://api.deepseekapi.top/v1. Incolla la tua chiave nel campo Chiave API. Nel campo ID modello inserisci uncensored.
5. Premi Connetti. Una spia di stato verde e un nome del modello indicano che il collegamento funziona.

I nomi delle etichette cambiano leggermente tra le versioni di SillyTavern, ma l'idea resta la stessa: modalità Chat Completion, fonte Custom, endpoint, chiave, modello. Ottieni la chiave dalla pagina della chiave API.

Se la connessione fallisce

Verifica questi elementi in ordine. La maggior parte degli errori è uno di questi.

• Forma dell'URL errata. L'endpoint termina con /v1. Non aggiungere /chat/completions.
• Fonte errata. La modalità Text Completion utilizza un formato di richiesta diverso. Questa API serve POST /v1/chat/completions e GET /v1/models, quindi usa Chat Completion.
• Chiave incollata con spazi. Incollala di nuovo e controlla la presenza di uno spazio finale.
• Il server non raggiunge internet. Se esegui SillyTavern su un server domestico o in un container, la macchina ha bisogno di accesso HTTPS in uscita.

Per distinguere un problema di SillyTavern da un problema della chiave, testa la chiave da un terminale:

Copycurl https://api.deepseekapi.top/v1/models   -H "Authorization: Bearer YOUR_KEY" | grep uncensored

Un elenco JSON con uncensored al suo interno significa che la chiave è valida. Per verificare il percorso della chat stesso:

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

Impostazioni importanti per il roleplay

Streaming

Attiva lo streaming nel pannello Chat Completion. L'API invia i token tramite SSE man mano che vengono prodotti, quindi le risposte appaiono mentre vengono scritte. Una richiesta in streaming occupa uno dei tuoi slot di concorrenza fino alla fine dello stream. Una chiave completa permette 8 richieste simultanee, una chiave di prova ne permette 2.

Dimensione del contesto

Il modello ha una finestra di 100.000 token, prompt più completamento. Non devi usarla tutta. SillyTavern invia la scheda del personaggio, la personalità, le voci del lorebook e tutta la cronologia delle chat che si adatta al limite che imposti, su ogni singolo messaggio. Un limite più piccolo significa un conto più basso e risposte più veloci. Per la maggior parte delle chat 16k-32k token sono più che sufficienti.

Lunghezza massima della risposta

Imposta il limite di risposta a qualcosa di ragionevole, come 400-600 token, così una risposta non può trasformarsi in un saggio. L'API non richiede max_tokens, ma un limite protegge il tuo credito da output incontrollati.

Campionamento

Temperatura, top_p, sequenze di stop, seed e le penalità vengono passati al modello. Un punto di partenza comune per la chat con personaggi è temperatura 0,8-1,0 e top_p intorno a 0,9. Cambia un valore alla volta. Se un personaggio ripete frasi, aumenta leggermente la penalità di frequenza o presenza piuttosto che la temperatura.

Sequenze di stop

Se il modello inizia a scrivere anche le righe dell'utente, aggiungi il nome dell'utente seguito dai due punti come sequenza di stop. Questo viene passato al modello.

Una checklist per il primo avvio

Prima di caricare un personaggio preferito, avvia una breve chat di test per sapere che la connessione è sana.

1. Crea un personaggio vuoto o usa la scheda assistente predefinita.
2. Invia "Rispondi con la parola ready." La risposta dovrebbe arrivare in un secondo o due e arrivare in streaming man mano che viene prodotta.
3. Apri la console di SillyTavern o il log di rete se non appare nulla. Un 401 significa che la chiave è errata, un 404 significa che l'URL o l'ID modello sono errati, e un 429 significa che è stato raggiunto un limite.
4. Controlla il tuo saldo. Ogni risposta include un'intestazione X-Balance-USD, così puoi verificare che il credito scenda di una piccola quantità per messaggio.
5. Solo allora carica la tua scheda personaggio reale e il lorebook.

Se la risposta è vuota o tagliata a metà frase, controlla prima l'impostazione della lunghezza della risposta. Un limite impostato troppo basso interrompe la risposta anticipatamente e la frase incompleta non è un difetto del modello.

Passare tra le configurazioni

SillyTavern mantiene le configurazioni di campionamento separate dal profilo di connessione. Vale la pena salvare una configurazione per la scrittura narrativa, con una temperatura più alta, e una per brevi risposte fattuali, con una più bassa. Il passaggio alla configurazione non tocca l'endpoint o la chiave.

Quanto costa una sessione di roleplay

Il prezzo è $0,15 per 1M di token di input e $0,50 per 1M di token di output, dal credito prepagato senza abbonamento. Poiché la cronologia viene reinviata, l'input è la parte maggiore. Esegui una chat con un prompt di 20.000 token per messaggio e una risposta di 400 token:

• Input: 20.000 × $0,15 / 1.000.000 = $0,003
• Output: 400 × $0,50 / 1.000.000 = $0,0002
• Totale: $0,0032 per messaggio

Quindi 100 messaggi costano $0,32. Ora confronta un contesto ridotto di 8.000 token con la stessa risposta: 8.000 × $0,15 / 1.000.000 = $0,0012, più $0,0002, per un totale di $0,0014 per messaggio e $0,14 per 100. Tagliare il contesto costa meno della metà per lo stesso numero di turni.

Il credito di prova da $0,50 copre circa 156 messaggi alla dimensione maggiore (0,50 / 0,0032 = 156,25) o circa 357 alla dimensione minore (0,50 / 0,0014 = 357,1). Le richieste fallite o rifiutate non vengono addebitate e il credito non scade mai. Consulta la pagina dei prezzi per importi di ricarica, bonus e metodi di pagamento; sono accettati sia carta (Visa, Mastercard, Apple Pay, Google Pay) che cripto (USDT su TRC20, USDC su Base).

Personaggi, sicurezza e l'unica regola ferrea

Il modello è ottimizzato per narrativa, roleplay e app companion per adulti. Non è un filtro di sicurezza generale e non decide cosa è adatto a te. Questo è compito tuo: mantieni le tue schede e le chat per uso adulto legale.

L'unico limite fisso è che i contenuti sessuali che coinvolgono minorenni non sono consentiti e nessun prompt cambia questo. Mantieni le età dei personaggi chiaramente adulte nelle tue schede.

Alcune abitudini pratiche aiutano la qualità di una chat:

• Posiziona i fatti principali sul personaggio nella parte superiore della scheda, non sepolti alla fine.
• Usa un prompt di sistema breve che definisca lo stile del narratore e la lunghezza delle risposte.
• Riassumi le parti precedenti della chat con la funzione di riepilogo di SillyTavern invece di mantenerle per sempre.
• Mantieni brevi le voci del lorebook e attivatele tramite parole chiave, in modo che entrino nel prompt solo quando necessario.

I prompt non vengono utilizzati per l'addestramento. Consulta la documentazione quickstart per le intestazioni di risposta, tra cui X-Balance-USD, che mostra il tuo saldo residuo.

Utilizzo di un personaggio come backend per un'app companion

Alcuni utenti usano SillyTavern come interfaccia front-end per un personaggio companion a lungo termine per adulti. Si applicano le stesse regole di qualsiasi chat. Mantieni la coerenza del personaggio scrivendolo come un blocco fisso e breve, e lascia che la funzione di riepilogo gestisca gli eventi più vecchi. Le lunghe pause tra le sessioni non costano nulla, perché il credito non scade mai e non c'è abbonamento.

Se in futuro creerai la tua app invece di usare SillyTavern, puoi chiamare lo stesso endpoint dal codice. La documentazione quickstart mostra esempi con curl, Python e Node con lo stesso URL di base e ID modello, quindi un prompt che funziona in SillyTavern può essere spostato direttamente.

Limiti di richiesta in una chat affollata

Una singola chat raramente supera i limiti. Chat di gruppo, swipe e diverse schede aperte possono farlo. Il servizio risponde con HTTP 429 e il codice rate_limited quando superi il limite di richieste al minuto (60 su una chiave di prova, 300 su una chiave completa) e concurrency quando ci sono troppe richieste in corso (2 su prova, 8 su completa).

In caso di sovraccarico breve ricevi anche un 429 con l'intestazione Retry-After: 5. Aspettare cinque secondi e inviare di nuovo è la risposta corretta. Se vedi questi messaggi su una chiave di prova, chiudi le schede extra o interrompi uno swipe prima di avviarne un altro.

Altre guide

• Come usare l'API DeepSeek in Cursor: configurazione del Base URL personalizzato
• Esempio API DeepSeek in Python: Chat, streaming, strumenti
• Chiave API DeepSeek: Accesso API LLM senza censura