Configurazione API SillyTavern: base URL, API key e lista modelli

Risposta rapida: le cinque impostazioni che contano

Apri il pannello API Connections (l'icona della spina) e imposta esattamente questo: API = Chat Completion. Chat Completion Source = Custom (compatibile OpenAI). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = la tua chiave sk-.... Clicca Connect, aspetta la luce verde e scegli un modello dal menu, per esempio deepseek-v4-flash. L'errore più comune in assoluto è incollare il percorso completo. SillyTavern aggiunge /chat/completions a qualsiasi cosa tu inserisca, quindi l'URL deve fermarsi a /v1. Se incolli https://api.apisrouter.com/v1/chat/completions, SillyTavern chiama /v1/chat/completions/chat/completions e la connessione fallisce con un 404. È l'opposto di JanitorAI, che vuole l'URL completo delle completions nella sua configurazione proxy. Stesso provider, convenzioni di campo diverse.

Perché l'URL API di SillyTavern si ferma a /v1

Ogni API compatibile OpenAI è un base URL più un insieme di percorsi fissi. GET /v1/models restituisce l'elenco degli ID modello che la tua chiave può usare. POST /v1/chat/completions esegue la vera richiesta di chat. SillyTavern conosce questi percorsi e li costruisce da solo, quindi ti chiede solo il base URL. Quando clicchi Connect, chiama /v1/models con la tua chiave e usa la risposta per popolare il menu dei modelli. Un menu vuoto significa quasi sempre che quella chiamata è fallita. Devi anche scegliere la modalità API giusta. Chat Completion invia messaggi strutturati con ruoli system, user e assistant, che è ciò che si aspetta ogni provider compatibile OpenAI ospitato. Text Completion invia un'unica stringa di prompt grezzo ed esiste soprattutto per backend locali come KoboldCpp e text-generation-webui. Per qualsiasi chiave API ospitata, usa Chat Completion. Se selezioni Text Completion contro un endpoint di chat ospitato otterrai errori o una formattazione senza senso, e diversi sampler mostrati in quella modalità comunque non si applicano.

Configurazione passo dopo passo

Se il menu resta vuoto dopo Connect, ricontrolla tre cose in ordine: l'URL finisce a /v1 senza percorso finale né spazi finali, la chiave è incollata senza virgolette o spazi, e la sorgente è Custom (compatibile OpenAI) e non OpenAI semplice. La sorgente OpenAI semplice ignora il tuo URL personalizzato in alcune versioni e parla con api.openai.com, dove la tua chiave non è valida.

• Ottieni una chiave. Su APIsRouter non c'è un modulo account: paghi su /topup e la chiave ti arriva via email. Qualsiasi chiave compatibile OpenAI funziona allo stesso modo in questi passaggi.
• In SillyTavern, clicca l'icona della spina per aprire API Connections.
• Imposta API su Chat Completion.
• Imposta Chat Completion Source su Custom (compatibile OpenAI).
• In Custom Endpoint (Base URL), inserisci https://api.apisrouter.com/v1 senza nulla dopo /v1.
• Incolla la tua chiave nel campo Custom API Key.
• Clicca Connect. Il pallino di stato diventa verde e il menu Available Models si popola da /v1/models.
• Seleziona un modello, apri una scheda personaggio e invia un breve messaggio di prova.

Verifica la connessione fuori da SillyTavern

Quando qualcosa fallisce, testa l'endpoint direttamente prima di dare la colpa a SillyTavern. Questa chiamata curl è esattamente ciò che fa il pulsante Connect. Se restituisce un array JSON di ID modello, la tua chiave e il tuo URL vanno bene e il problema è nei campi di SillyTavern. Se la lista dei modelli funziona ma le chat falliscono, esegui un vero completamento da Python con lo stesso base URL. Una risposta riuscita qui dimostra l'intera catena, e qualsiasi messaggio di errore che ricevi è il vero errore del provider e non quello generico di SillyTavern.

curl https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

Le basi di sampler e preset

Le sorgenti Chat Completion espongono un piccolo set di sampler: temperature, top P, frequency penalty e presence penalty, più la lunghezza della risposta e la dimensione del contesto. I sampler più sofisticati di cui hai forse letto (min P, mirostat, dynamic temperature) appartengono ai backend Text Completion e semplicemente non vengono inviati alle API di chat ospitate, quindi non cercarli qui. I preset in SillyTavern raggruppano due cose: i valori dei sampler e la struttura del prompt che il Prompt Manager assembla dalla scheda del personaggio, dalla persona e dal lorebook. Il preset Default integrato è un buon punto di partenza. Cambia un valore alla volta e rigenera la stessa scena per vedere cosa fa davvero. La dimensione del contesto merita attenzione: SillyTavern riempie la finestra di contesto con la cronologia della chat, quindi un contesto più grande significa più token di prompt inviati a ogni turno, il che migliora la memoria e alza il costo per messaggio allo stesso tempo.

Modelli consigliati per SillyTavern

La scelta del modello conta più della regolazione dei sampler. Il consenso della community, per quanto riguarda i resoconti approssimativi, mette la famiglia DeepSeek V4 al primo posto per il prezzo: deepseek-v4-flash è la scelta predefinita consigliata per le chat lunghe e deepseek-v4-pro tiene insieme meglio schede complesse e chat di gruppo. GLM-5, Kimi K2.6 e MiMo sono scelte solide per rapporto qualità-prezzo con voci di prosa distinte, da alternare quando una chat inizia a sembrare sempre uguale. Grok si distingue perché la policy pubblicata di xAI permette esplicitamente temi maturi in ambientazioni chiaramente di fiction, il che conta per trame più cupe. Claude scrive la prosa migliore di qualsiasi cosa in questa lista, ma la policy di Anthropic proibisce i contenuti espliciti, quindi considera Claude la scelta per la scrittura creativa SFW e le scene in stile letterario. Due note pratiche. Primo, SillyTavern è un software rivolto agli adulti, e ogni modello qui applica la propria policy sui contenuti indipendentemente dal tuo frontend, quindi mantieni schede e scene entro quelle regole. Secondo, poiché il menu si popola dal vivo da /v1/models, puoi cambiare modello a metà chat e confrontare le risposte allo stesso messaggio, il modo più veloce per trovare il tuo preferito.

Quanto costano davvero le chat di SillyTavern

I modelli ospitati fatturano per token, e il roleplay è pesante lato input: ogni turno reinvia la scheda del personaggio più la cronologia recente. Un turno che invia 8.000 token di prompt e riceve una risposta di 350 token costa circa un decimo di centesimo su deepseek-v4-flash, quindi pochi dollari coprono mesi di chat casuale. Lo stesso turno su claude-opus-4-7 costa circa 25 volte di più, motivo per cui la maggior parte delle persone usa un modello economico quotidiano e riserva i modelli premium alle scene a cui tiene davvero. Una singola chiave gateway copre tutta questa tabella. APIsRouter è un gateway compatibile OpenAI con fatturazione pay-as-you-go e nessun abbonamento: paghi su /topup senza creare un account, la chiave arriva via email, la tua prima ricarica aggiunge un corrispondente +100% al saldo, i modelli globali sono prezzati 20% sotto le tariffe ufficiali e i modelli cinesi stanno sotto i loro prezzi ufficiali.

Domande frequenti