Guida all'integrazione API di SillyTavern: Connetti GPTProto e inizia a giocare di ruolo

Passaggio 1: Installa e avvia SillyTavern

SillyTavern esegue l'interfaccia di chat, le schede dei personaggi e le impostazioni dei prompt sul tuo computer. Un modello connesso genera le risposte. La documentazione ufficiale del progetto lo descrive come un frontend open-source gratuito.

Prepara Node.js LTS, Git, un account GPT Proto con saldo API disponibile e un ID modello. L'inferenza cloud tramite GPT Proto non richiede il download dei pesi del modello o l'esecuzione di un modello sulla tua GPU.

Installazione su macOS

Scarica la versione LTS dalla pagina di download di Node.js, seleziona macOS e utilizza il suo programma di installazione se preferisci un'installazione grafica.

Scegli la versione LTS corrente per il tuo sistema operativo.

Apri il Terminale e controlla Git:

git --version

Installa Git se necessario, quindi esegui:

cd ~
git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern
bash start.sh

Il primo avvio installa le dipendenze. Tieni aperto il terminale mentre utilizzi SillyTavern e apri l'indirizzo locale visualizzato se il browser non si avvia automaticamente. Questi comandi seguono le istruzioni ufficiali di installazione per macOS.

Il primo avvio scarica le dipendenze necessarie.

Per avviarlo di nuovo in seguito:

cd ~/SillyTavern
bash start.sh

Installazione su Windows

Installa Node.js LTS e Git for Windows. Crea una cartella come C:\AI, aprila in Esplora file, digita cmd nella barra degli indirizzi e premi Invio. Esegui:

git clone https://github.com/SillyTavern/SillyTavern -b release

Apri la cartella SillyTavern scaricata e fai doppio clic su Start.bat. Lascia la console aperta mentre chatti. La guida ufficiale per Windows consiglia di evitare cartelle controllate da Windows come Program Files e di eseguire il file di avvio senza privilegi di amministratore.

Passaggio 2: Connetti SillyTavern a GPT Proto

Accedi a GPT Proto e apri la pagina del modello GLM-5.3. La sezione Utilizzo API fornisce l'identificativo del modello e una voce per creare una chiave API. Crea o seleziona la tua chiave, controlla la tariffa corrente e assicurati di avere un saldo sufficiente per un breve test.

In SillyTavern, apri Connessioni API, utilizzando l'icona della spina nella barra superiore. Inserisci:

Incolla la chiave nel campo dedicato. Non aggiungere Bearer, virgolette o un'intestazione HTTP completa.

Le istruzioni ufficiali per l'endpoint personalizzato specificano un URL di base senza /chat/completions; SillyTavern aggiunge quel suffisso. Per questa connessione, il campo dell'endpoint dovrebbe terminare con /v1.

Se hai seguito in precedenza la nostra guida alla configurazione dell'API di Janitor AI, nota questa differenza: l'URL del proxy di Janitor utilizza l'indirizzo completo https://gptproto.com/v1/chat/completions. Copiare quell'indirizzo completo nel campo URL di base di SillyTavern fornirebbe un input errato.

Abbina l'origine, l'URL di base, la chiave e l'ID modello ai campi sopra indicati.

Fai clic su Connetti, quindi su Messaggio di test. Puoi anche inviare Ciao dalla schermata di benvenuto. La procedura guidata ha prodotto la risposta mostrata di seguito.

Un messaggio di base conferma che la connessione è in grado di generare una risposta.

Un elenco di modelli disponibili vuoto non significa necessariamente che la generazione non sia disponibile. Inserisci l'ID esatto manualmente quando il rilevamento del modello non è disponibile. Per cambiare modello in seguito, utilizza un altro ID modello di testo supportato da GPT Proto e riprova; le funzionalità del modello e i parametri accettati possono variare.

Passaggio 3: Importa una scheda personaggio o creane una tua

Una connessione API funzionante fornisce il modello. La scheda del personaggio fornisce l'identità, la voce e la situazione iniziale.

Importa una scheda personaggio esistente

Apri Personaggi → Importa personaggio, seleziona il file della scheda scaricato e scegli il personaggio importato per iniziare a chattare. Puoi anche sfogliare i personaggi tramite Estensioni → Scarica estensioni e risorse.

Per le schede PNG, scarica il file originale. Un normale ritratto o screenshot non contiene alcuna definizione di personaggio utilizzabile a meno che tali dati non siano stati incorporati nell'immagine. Le FAQ ufficiali spiegano le importazioni PNG non valide, inclusi i casi in cui il salvataggio o l'elaborazione di un'immagine rimuove i dati incorporati.

Crea Noah Bennett dal testo

Scegli Crea nuovo personaggio. Inizia con Nome, Descrizione e Primo messaggio; potrai aggiungere campi avanzati in seguito. La descrizione spiega al modello chi è il personaggio. Il primo messaggio stabilisce la scena iniziale e dimostra lo stile che desideri. La guida alla creazione del personaggio spiega entrambi i campi.

Usa l'editor dei personaggi per l'identità e la scena iniziale dell'IA.

Imposta Nome su Noah Bennett. Incolla questo esempio originale in Descrizione. {{char}} si riferisce al personaggio e {{user}} all'identità utente selezionata.

Stai interpretando il ruolo di {{char}}, Noah Bennett, un uomo di 25 anni con un fisico muscoloso, un sorriso facile e una personalità calda e affettuosa.

ASPETTO
Noah è alto 188 cm, con spalle larghe, braccia forti, un petto definito e gambe robuste costruite attraverso anni di allenamento della forza. Ha capelli castano scuro leggermente arruffati, caldi occhi color nocciola, una leggera barba incolta e una fossetta che appare quando sorride. I suoi vestiti abituali sono magliette aderenti, comodi pantaloni da jogging e scarpe da ginnastica. La sua voce è bassa e calda, e ride facilmente.

PERSONALITÀ
Noah è un tesoro con una sicurezza giocosa. È premuroso, fisicamente espressivo e a suo agio nel mostrare affetto. Gli piace far sorridere {{user}} attraverso prese in giro gentili, gesti premurosi e complimenti sinceri. Il suo fascino deriva dalla combinazione della sua corporatura imponente e del suo cuore sorprendentemente tenero.

Ha le sue opinioni, amicizie, ambizioni e occasionali giornate no. A volte nasconde il nervosismo dietro una battuta e si confonde in modo adorabile quando {{user}} lo coglie mentre è sentimentale. Sa ammettere gli errori e ridere di se stesso.

BACKGROUND
Noah lavora come preparatore atletico e spera di aprire una piccola palestra di quartiere. Fuori dal lavoro, ama cucinare, fare escursioni, guardare terribili commedie romantiche e sperimentare ricette per i pancake. Prende l'allenamento sul serio ma non giudica mai le persone per il loro corpo o il loro livello di forma fisica.

RELAZIONE CON {{user}}
Noah e {{user}} sono vicini di casa amichevoli che hanno iniziato a passare più tempo insieme di recente. È attratto da {{user}} e rende evidente il suo interesse attraverso attenzioni, flirt giocosi e inviti a fare cose ordinarie insieme. Lascia che la loro vicinanza si sviluppi attraverso interazioni reali.

STILE DI FLIRT
Il suo modo di flirtare è caldo, specifico e leggermente sfacciato. Potrebbe mantenere il contatto visivo un po' più a lungo, ricordare una bevanda preferita o ammettere di aver trovato una scusa per passare a trovarti. Nota le risposte di {{user}} e si adatta naturalmente. L'affetto dovrebbe sembrare gradito e reciproco.

STILE DI GIOCO DI RUOLO
Rimani nel personaggio di Noah durante la storia. Usa dialoghi naturali, piccoli gesti fisici e dettagli concreti invece di lunghe spiegazioni sulla personalità.
Scrivi le azioni tra *asterischi* e i dialoghi tra virgolette.
Di solito rispondi in uno-tre brevi paragrafi, lasciando spazio a {{user}} per partecipare.
Controlla solo il discorso, le azioni e i pensieri di Noah. Lascia i dialoghi, le decisioni e i sentimenti di {{user}} all'utente.
Mantieni i dettagli stabiliti e rispondi direttamente a ciò che è appena accaduto.
Usa un inglese naturale a meno che {{user}} non richieda un'altra lingua.

Incolla questo nel Primo messaggio:

*Noah è in piedi fuori dalla tua porta con una borsa da palestra su una spalla larga e un piccolo sacchetto di carta in mano. I suoi capelli scuri sono ancora leggermente umidi e la sua maglietta grigia aderente presenta una leggera spolverata di farina vicino all'orlo.*

"Prima che tu dica qualcosa: sì, so cucinare cose che non siano pollo e riso."

*Solleva il sacchetto di carta, una fossetta appare mentre sorride.*

"Girelle alla cannella. Ne ho fatte troppe." *Una breve pausa.* "Okay, ne ho fatte di più perché speravo di vederti."

"Allora… sei libero per un caffè?"

Completa la creazione del personaggio, quindi seleziona Noah. Mantieni le istruzioni principali nella Descrizione e l'apertura nel Primo Messaggio. Le Note del Creatore forniscono metadati per chi legge la scheda e non vengono utilizzate per costruire il prompt del modello.

La scheda completata di Noah separa la sua identità continua dal suo saluto iniziale.

Imposta la tua Persona

I personaggi definiscono l'identità dell'IA. Le Persona definiscono la tua. Apri Gestione Persona, crea e seleziona una persona e, facoltativamente, aggiungi un nome, un avatar e una descrizione, seguendo le istruzioni ufficiali sulle Persona.

Per questa scena immaginaria, una breve descrizione è sufficiente:

{{user}} è un adulto che si è trasferito da poco nel quartiere. Noah e {{user}} sono vicini amichevoli che stanno imparando a conoscersi. {{user}} decide autonomamente i propri discorsi, azioni, scelte e sentimenti.

Usa dettagli immaginari che vuoi che il personaggio conosca; non è necessario inserire la tua vera biografia. Per ulteriori idee sulla scrittura dei personaggi, vedi come creare il tuo personaggio IA con un'API.

Passaggio 4: Inizia la tua prima conversazione di gioco di ruolo

Apri la chat di Noah e leggi il saluto. Nello screenshot, l'utente risponde sì e Noah risponde: “Sì? Okay. Fantastico.” Continua poi l'invito al caffè con azioni e dialoghi. Quella continuazione generata è l'utile verifica della connessione.

Per un prompt più specifico da provare tu stesso, invia:

"Quindi i cinnamon roll erano solo una scusa per vedermi?"
*Lancio un'occhiata al sacchetto di carta, poi torno a guardarlo.*

Verifica se la risposta segue la personalità di Noah, risponde al tuo ultimo input e lascia a te le decisioni. Se lo stile ha bisogno di miglioramenti, modifica una parte della scheda e prova una nuova chat. Evita di cambiare contemporaneamente modello, prompt del personaggio e diverse impostazioni; avrai meno informazioni su cosa ha aiutato.

Opzionale: Aggiungi informazioni sul mondo al tuo personaggio

Le Informazioni sul mondo (World Info), chiamate anche lorebook, aggiungono informazioni sull'ambientazione al prompt in condizioni configurate. Per un primo esperimento, aggiungi una posizione dalla scena di Noah.

Apri World Info, crea un lorebook e aggiungi una voce abilitata utilizzando la strategia basata su parole chiave. Usa questi valori di esempio:

Nel pannello del personaggio di Noah, usa Altro… → Collega World Info, o il pulsante del globo del lore del personaggio, per associare il lorebook a lui. Poi chiedi: Com'è il Corner Cafe?

La documentazione di World Info spiega che il Contenuto della voce è ciò che entra nel prompt; il solo titolo non fornisce i fatti. L'attivazione dipende anche dalle impostazioni e dal budget disponibile, e il modello potrebbe non utilizzare ogni dettaglio fornito. Inizia con una voce concisa e verifica il suo comportamento prima di aggiungere un mondo vasto.

Quanto costa SillyTavern con GPT Proto?

GLM-5.3 è il modello utilizzato per questa guida. Scegli il tuo modello in base al budget, alla naturalezza del dialogo, all'espressione emotiva, alla coerenza del personaggio e alla velocità di risposta. Confronta i candidati con la stessa scheda e la stessa scena iniziale. Per le chat quotidiane, includi nel budget i costi del contesto conservato; per le scene basate sulla narrazione, verifica se la voce sembra credibile e se il modello ti lascia libero nelle tue scelte.

SillyTavern in sé è gratuito. La generazione dei modelli GPT Proto utilizza il tuo saldo API. Al momento della stesura di questa guida, GLM-5.3 è inferiore del 15% rispetto alle tariffe ufficiali di input e output su GPT Proto:

Tariffe verificate il 3 novembre 2026. Consulta il pannello dei prezzi di GLM-5.3 per le tariffe attuali ed eventuali costi di cache applicabili.

Una richiesta illustrativa con 8.000 token di input non memorizzati nella cache e 500 token di output fatturabili costa:

(8.000 ÷ 1.000.000 × $1.19) + (500 ÷ 1.000.000 × $3.74)
= $0.01139

Questo è un esempio di calcolo, non la fattura misurata per la conversazione dello screenshot. L'output fatturabile non è un conteggio di parole; utilizza l'utilizzo riportato dal provider, inclusi eventuali token di ragionamento fatturati come output.

L'input può includere istruzioni del personaggio, Persona, lore selezionata e cronologia della conversazione conservata. Come spiega la panoramica della connessione API, SillyTavern li assembla nel prompt. Un contesto conservato più lungo può aumentare il costo di una risposta anche quando il tuo messaggio più recente è solo sì.

Perché scegliere GPT Proto per la tua API di SillyTavern?

GPT Proto offre modelli di provider ufficiali con tariffe scontate su modelli selezionati, incluso GLM-5.3. Una chiave e un saldo condiviso coprono più provider. In SillyTavern, mantieni le tue schede personaggio e la connessione personalizzata, passa a un altro ID modello di chat supportato e confronta le sue risposte.

Per garantire l'affidabilità, i modelli principali utilizzano canali upstream ridondanti e failover automatico per ridurre le interruzioni quando un canale diventa non disponibile. Puoi scegliere tra modelli con prezzi e stili conversazionali diversi mantenendo la tua configurazione.

Prima di una sessione lunga, controlla la disponibilità del modello, i costi di input/output, la velocità di risposta e la gestione dei dati. Inizia con un piccolo test e controlla l'utilizzo. La pagina dei modelli di SillyTavern ti consente di esplorare le opzioni e confrontare i costi.

Problemi comuni dell'API di SillyTavern e soluzioni

Inizia con una chat nuova e un messaggio breve. Quindi abbina il sintomo al controllo successivo:

I modelli di ragionamento richiedono particolare attenzione. La guida ufficiale al ragionamento spiega che il pensiero può consumare token di risposta, anche quando è nascosto. Un limite troppo piccolo per quel modello può lasciare una risposta visibile vuota o incompleta. Controlla la Lunghezza massima della risposta rispetto ai requisiti del modello invece di applicare lo stesso limite ridotto a ogni modello.

Una discussione della community su lorebook e risposte vuote descrive un utente che ha risolto dopo aver rimosso un preset e aumentato il limite di risposta. Entrambe le modifiche sono state fatte insieme, quindi il rapporto non isola una singola causa. Supporta un ordine di risoluzione dei problemi pratico: fai funzionare una chat semplice, quindi aggiungi preset e lore una modifica alla volta.

Opzionale: testa l'API al di fuori di SillyTavern

Con la tua chiave memorizzata privatamente nella variabile d'ambiente GPTPROTO_API_KEY, questo comando shell per macOS/Linux invia una richiesta diretta utilizzando il formato Chat Completions della pagina del modello:

curl --request POST "https://gptproto.com/v1/chat/completions" \
  --header "Authorization: Bearer $GPTPROTO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "glm-5.3",
    "messages": [
      {"role": "user", "content": "Reply with: API connection works."}
    ]
  }'

Verifica la presenza di una risposta corretta contenente testo generato, non solo un indicatore di connessione. Se questo funziona mentre SillyTavern fallisce, confronta i campi del client e i parametri aggiunti. Se entrambi falliscono, indaga sull'autenticazione restituita, sul saldo, sul modello o sull'errore del servizio. Non condividere chiavi reali in post pubblici di risoluzione dei problemi.