Chiave API DeepSeek in SillyTavern: connetti la nostra API

Configurazione rapida

Per una configurazione della chiave API DeepSeek in SillyTavern, una precisazione iniziale. Una chiave emessa dalla piattaforma ufficiale di DeepSeek è per l'endpoint di DeepSeek. La chiave che ottieni su questo sito appartiene a un servizio separato: un'API indipendente e compatibile con OpenAI che esegue un modello a pesi aperti, ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale. Non è l'API ufficiale di DeepSeek, quindi usa la chiave di questo sito solo con l'URL di base di questo sito.

I valori da inserire in SillyTavern sono:

• Origine: Chat Completion, poi Custom (compatibile con OpenAI)
• Endpoint Custom (URL di base): https://api.deepseekapikey.com/v1
• Chiave API: la chiave dal tuo account
• ID modello: uncensored

SillyTavern si aggiorna spesso e le etichette del menu possono cambiare leggermente tra le release, quindi fai riferimento al significato se un nome è diverso. Il resto di questa pagina illustra ogni passaggio e le impostazioni rilevanti per le chat lunghe con i personaggi.

Passo per passo nell'interfaccia

1. Ottieni una chiave. Registrati nella pagina della chiave API con Google o con email e password. I nuovi utenti possono richiedere $0,50 di credito di prova con un clic, valido per 7 giorni, uno per persona, senza carta.
2. Apri il pannello di connessione API. In SillyTavern, clicca l'icona della spina in alto per aprire le Connessioni API.
3. Seleziona il tipo di API. Seleziona Chat Completion dal menu a discesa API. Le modalità di completamento del testo sono pensate per backend che accettano prompt grezzi; questa API utilizza messaggi di chat.
4. Seleziona l'origine. Nell'elenco delle origini Chat Completion, scegli Custom (compatibile con OpenAI).
5. Inserisci l'endpoint. Incolla https://api.deepseekapikey.com/v1 nel campo dell'endpoint custom. SillyTavern aggiunge il percorso di completamento chat da solo, quindi lascialo fuori. Se ottieni un 404 in seguito, prova il percorso completo come tentativo secondario.
6. Inserisci la chiave. Incolla la chiave nel campo della chiave API custom.
7. Inserisci il modello. Digita uncensored nel campo ID modello. Se un menu a discesa dei modelli si carica dall'endpoint GET /v1/models, puoi sceglierlo da lì.
8. Connetti. Premi Connetti. Uno stato verde e il nome del modello significano che la chiamata è andata a buon fine. Invia un messaggio a un personaggio per confermare.

Se Connetti fallisce, testa al di fuori di SillyTavern in un terminale. Questo isola il problema:

Copycurl https://api.deepseekapikey.com/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}'

Una risposta JSON normale indica che la chiave e l'URL sono validi e il problema è nei campi di SillyTavern. La guida rapida elenca altri esempi.

Dimensioni del contesto e lunghezza della risposta

Qui le configurazioni di roleplay funzionano bene o sprecano denaro. Il modello ha una finestra di contesto di 100.000 token, contando prompt e risposta insieme. SillyTavern ha il proprio slider Dimensioni del contesto nelle impostazioni di campionamento, che controlla quanto della cronologia e dei dati del personaggio viene impacchettato in ogni richiesta.

Puoi impostarlo fino a 100.000, ma pensa a cosa significa. SillyTavern costruisce il prompt completo a ogni turno: prompt di sistema, scheda personaggio, voci del lorebook, persona, poi tutta la cronologia della chat che riesce a contenere. Un'impostazione più grande significa che il modello vede più del passato e paghi per ogni token di nuovo su ogni messaggio.

Un modo pratico per scegliere:

• 8.000-16.000 token: scene brevi e chat veloci. Economico e veloce.
• 30.000-50.000 token: una storia lunga con una scheda personaggio dettagliata e un lorebook. Buono per la maggior parte degli utenti.
• Fino a 100.000 token: grandi lorebook o storie molto lunghe continue. Lascia un margine in modo che il prompt più la risposta rimangano sotto la finestra.

Per la lunghezza della risposta, imposta Lunghezza massima della risposta a 300-600 token per una risposta di roleplay tipica. Il parametro max_tokens è opzionale nell'API, ma SillyTavern invia un valore e un limite impedisce a una risposta troppo lunga di far crescere il conto. Attiva l'opzione streaming in modo che il testo appaia mentre viene generato; l'API supporta server-sent events con stream: true.

Il passaggio delle penalità e dei valori di campionamento funziona come suggerisce l'interfaccia. Temperature, Top P, penalità di frequenza e penalità di presenza vengono inviate al modello, e le sequenze di stop e un seed fisso vengono passati attraverso. Inizia con temperature intorno a 0,8 e regola: più bassa se il personaggio perde il filo dei fatti, più alta se le risposte sembrano ripetitive.

Quanto costa il roleplay

Il prezzo è $0,15 per 1M di token in input e $0,50 per 1M di token in output. L'input domina a causa della cronologia reinviata. Esempi pratici, con una risposta di 400 token ogni volta:

Verifica una riga: 20.000 / 1.000.000 × $0,15 = $0,003, e 400 / 1.000.000 × $0,50 = $0,0002, che dà $0,0032. A questa dimensione il credito di prova da $0,50 copre circa 156 messaggi. Le richieste fallite o rifiutate non vengono addebitate, quindi i tentativi dopo un errore non aumentano il conto. Gli swipe e le rigenerazioni contano, perché ciascuno è una nuova richiesta completa.

Il credito è prepagato, non scade mai e non c'è abbonamento. Ricarica qualsiasi importo intero da $20 a $500, con +5% da $50, +10% da $100 e +15% da $200. Ad esempio, $100 diventano $110. Puoi pagare con cripto (USDT su TRC20, USDC su Base). La pagina prezzi ha l'elenco aggiornato.

Chat di gruppo, swipe e limiti di richieste

SillyTavern può inviare diverse richieste ravvicinate: chat di gruppo in cui più personaggi rispondono in sequenza, swipe ed estensioni che riassumono o generano contenuti secondari. Una chiave completa permette 8 richieste concorrenti e 300 richieste al minuto. Una chiave di prova permette 2 concorrenti e 60 al minuto.

Se vedi un errore con codice concurrency, troppe richieste erano in esecuzione contemporaneamente. Attendi che lo streaming corrente termini prima di fare di nuovo swipe, perché una richiesta in streaming mantiene la sua posizione fino alla fine dello streaming. Un errore con codice rate_limited significa troppe richieste al minuto. Un 429 accompagnato dall'intestazione Retry-After: 5 è un sovraccarico temporaneo che si risolve rapidamente.

Per storie lunghe, considera l'estensione di riassunto o le voci del lorebook per trasmettere i fatti in avanti, così puoi mantenere la dimensione del contesto più bassa. Un breve riassunto degli eventi precedenti all'inizio del prompt costa molto meno che mantenere cinquantamila token di cronologia grezza.

Risolvere problemi comuni

Connect dice non autorizzato

La chiave è errata, ha uno spazio alla fine o proviene da un altro servizio. Una chiave emessa dalla piattaforma di DeepSeek non funziona con questo URL di base.

Connect dice non trovato

Controlla l'ortografia dell'endpoint. Dovrebbe terminare con /v1 nella configurazione comune. Alcune build si aspettano il percorso completo di completamento chat, quindi se la forma breve fallisce, prova https://api.deepseekapikey.com/v1/chat/completions.

Le risposte sono brevi o troncate

Aumenta la lunghezza massima della risposta. Se il taglio avviene solo nelle chat lunghe, il tuo prompt potrebbe essere vicino al limite della finestra; riduci leggermente le dimensioni del contesto per lasciare spazio alla risposta.

Il personaggio dimentica gli eventi precedenti

Questo è il contesto in azione. Aumentalo, oppure sposta i fatti chiave nella scheda del personaggio, nella persona o in una voce del lorebook in modo che rimangano in ogni prompt.

La risposta viene rifiuta

Il modello è ottimizzato per evitare il rifiuto dei contenuti per uso adulto legale, ma una regola non cambia: nessun contenuto sessuale che coinvolga minorenni. I personaggi e gli scenari in quell'area vengono rifiutati. Il servizio è solo testo, quindi la generazione di immagini in SillyTavern richiede un backend diverso.

I prompt inviati tramite l'API non vengono utilizzati per l'addestramento. I tuoi file di chat rimangono nella cartella dei dati di SillyTavern sul tuo dispositivo a meno che non li sposti. Se vuoi il contesto su come questo servizio differisce da quello di DeepSeek, vedi API DeepSeek: miti vs. fatti.

Altre guide

• Chiave API DeepSeek in Janitor AI: configurazione con la nostra API
• Chiave API DeepSeek in VS Code: configurazione con la nostra API
• API DeepSeek: miti vs. realtà per l'accesso senza censura