Documentazione

SillyTavern

La sorgente Custom (OpenAI-compatible) di SillyTavern richiede un URL di base e una chiave. Se la configuri con Kunavo, Claude e GPT compaiono entrambi nello stesso menu a discesa dei modelli.

Per connettere SillyTavern a Kunavo, apri API Connections, imposta API su Chat Completion e Chat Completion Source su Custom (OpenAI-compatible), quindi compila due campi: Custom Endpoint = https://api.kunavo.com/v1 e Custom API Key = la tua chiave sk-kn-…. Premi Connect; SillyTavern chiama GET /v1/models e popola il menu a discesa dei modelli con la risposta.

Campo di SillyTavern	Valore
API	Completamento chat
Origine del completamento chat	Personalizzato (compatibile con OpenAI)
Endpoint personalizzato (URL di base)	`https://api.kunavo.com/v1`
Chiave API personalizzata	`sk-kn-…`
Modelli disponibili	Si compila automaticamente dopo Connect: seleziona un qualsiasi id

Il suffisso /v1 deve essere incluso in questo campo. La sorgente personalizzata di SillyTavern segue la convenzione OpenAI e aggiunge solo il percorso; quindi, se https://api.kunavo.com non include /v1, la connessione non riuscirà e l’elenco dei modelli resterà vuoto.

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
In SillyTavern, apri l’icona della spina (API Connections) nella barra superiore.
Imposta API → Chat Completion, quindi Chat Completion Source → Custom (OpenAI-compatible).
Incolla https://api.kunavo.com/v1 in Custom Endpoint e la chiave in Custom API Key.
Premi Connect. Se lo stato è verde e il menu a discesa Available Models è popolato, la connessione è riuscita.
Seleziona un id del modello dal menu a discesa e avvia una chat. In seguito, per cambiare modello non è necessario riconnettersi.

Il riferimento di SillyTavern per questa schermata è la pagina delle connessioni API Chat Completions.

Verifica prima di eseguire il debug dell’interfaccia

Una richiesta basta a stabilire se il problema riguarda l’endpoint, la chiave o SillyTavern. Se restituisce un elenco JSON di id dei modelli, lo stesso URL e la stessa chiave popoleranno il menu a discesa.

# Confirms the key and the endpoint before you touch SillyTavern.
# A JSON list of model ids means the same URL will populate the dropdown.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quali modelli scegliere

Tutti i modelli testuali su Kunavo sono accessibili dallo stesso menu a discesa: l’elenco completo è nella pagina dei modelli e viene restituito in tempo reale da GET /v1/models. Le tariffe sono in USD per 1M di token, input/output.

ID del modello	Kunavo ingresso / uscita	Ideale per
`claude-haiku-4-5`	$0.70 / $3.50	Claude più economico — sessioni lunghe in cui conta soprattutto il costo per turno
`claude-sonnet-5`	$1.40 / $7.00	Il miglior equilibrio tra qualità e prezzo
`claude-opus-5`	$3.50 / $17.50	La fascia Claude di qualità più elevata
`claude-fable-5`	$7.00 / $35.00	Ragionamento all’avanguardia con una finestra di contesto da 1M di token: la scelta giusta quando il problema è la cronologia stessa della chat

La lunghezza del contesto è il primo limite che si fa sentire in una lunga sessione di SillyTavern: l’intera cronologia viene inviata di nuovo a ogni turno, quindi la spesa in token cresce con la conversazione invece di restare costante. Kunavo addebita i costi per token su un saldo prepagato senza canone mensile, quindi un mese di inattività non costa nulla. I dettagli sono nella sezione fatturazione; la memorizzazione nella cache dei prompt è il fattore più importante quando si ripete lo stesso contesto.

Risoluzione dei problemi

Sintomo	Causa	Correzione
La connessione non riesce e l’elenco dei modelli resta vuoto	Manca `/v1` in Custom Endpoint	Usa `https://api.kunavo.com/v1`. Verifica con il comando curl qui sopra.
401 / chiave non valida	Chiave incollata con spazi, oppure revocata	Copiala di nuovo da `/app/keys`; consulta 401 e 403
Le risposte arrivano tutte insieme, senza streaming	Un proxy davanti alla connessione memorizza gli eventi inviati dal server prima di inoltrarli	Lo streaming è supportato dall’endpoint: errori di streaming
Id del modello rifiutato	L’endpoint non fornisce questo id	Scegli un id dal menu a discesa oppure consulta model_not_found
Errori solo nelle chat lunghe	La cronologia supera la finestra di contesto del modello	Riduci la cronologia o passa a un modello con una finestra di contesto più ampia: context_length_exceeded

Due note sincere

Nessuna affiliazione

SillyTavern è un progetto open source indipendente e non è affiliato a Kunavo. Questa pagina descrive una configurazione funzionante perché SillyTavern supporta endpoint arbitrari compatibili con OpenAI: nessuno dei due prodotti prevede comportamenti speciali per questa configurazione.

La politica sui contenuti si applica comunque

Le richieste inviate tramite Kunavo raggiungono i provider upstream e ciascun provider applica la propria politica di utilizzo ai contenuti ricevuti. Un gateway non elimina questi limiti; qualsiasi pagina affermi il contrario sta cercando di venderti qualcosa. I termini di Kunavo sono disponibili nella politica di utilizzo accettabile.

Domande frequenti

Come si connette SillyTavern a un endpoint API personalizzato?

In SillyTavern, apri la scheda API Connections (icona della spina), imposta API su Chat Completion e Chat Completion Source su Custom (OpenAI-compatible). Inserisci l’URL di base compatibile con OpenAI del gateway in Custom Endpoint — per Kunavo è https://api.kunavo.com/v1 — inserisci la chiave in Custom API Key e premi Connect. SillyTavern invia quindi una richiesta GET /v1/models all’endpoint e popola il menu a discesa dei modelli con i dati della risposta.

SillyTavern è compatibile con i modelli Claude tramite un endpoint compatibile con OpenAI?

Sì. La sorgente Custom (OpenAI-compatible) di SillyTavern richiede solo un endpoint che implementi POST /v1/chat/completions; pertanto, i modelli Claude forniti in questo formato funzionano senza ricorrere alla sorgente Anthropic separata di SillyTavern. Su Kunavo, gli id dei modelli Claude e GPT compaiono tutti nello stesso menu a discesa dietro un’unica chiave; per passare da un modello all’altro non è necessario riconnettersi.

Lo streaming funziona in SillyTavern con un endpoint personalizzato?

Lo streaming funziona se l’endpoint implementa gli eventi inviati dal server su /v1/chat/completions, come fa Kunavo. Se le risposte arrivano solo come blocco completo, la causa più comune è un proxy davanti alla connessione che memorizza i dati del flusso prima di inoltrarli, non l’endpoint stesso.

Perché l’elenco dei modelli di SillyTavern è vuoto dopo la connessione?

Un menu a discesa dei modelli vuoto in SillyTavern significa che la chiamata GET /v1/models non è riuscita; il problema riguarda l’endpoint o la chiave, non SillyTavern. Le due cause più comuni sono un URL di base privo del suffisso /v1 e una chiave non valida per quell’endpoint. Eseguire curl su /v1/models con la stessa chiave riproduce l’errore fuori da SillyTavern e permette di capire quale delle due cause lo determina.