SillyTavern

SillyTavern può usare SpicyAPI in due modi. Il primo è la normale connessione di chat: SillyTavern invia i tuoi messaggi a un modello di chat di SpicyAPI attraverso la sorgente Custom (OpenAI-compatible). Il secondo è l’estensione SpicyAPI, che aggiunge i comandi /spicy-img e /spicy-video e un pulsante Animate, così puoi creare immagini e brevi video senza uscire dalla chat.

Puoi usare l’uno o l’altra da soli. Entrambi usano lo stesso account, lo stesso saldo e gli stessi prezzi del resto di SpicyAPI, e paghi solo quello che esegui. L’estensione è gratuita e open source (MIT) su github.com/spicyapi-ai/sillytavern-spicyapi.

Prima di cominciare

• SillyTavern 1.19.0 o successivo. I passaggi di questa pagina sono stati verificati con la 1.19.0 il 2026-10-06. In altre versioni le voci di menu possono cambiare posizione.
• git sulla macchina che esegue SillyTavern, solo se vuoi l’estensione. SillyTavern lo usa per scaricare le estensioni.
• Una chiave API. Le chiavi iniziano con sk-spicy-. Per le restrizioni che puoi applicare a una chiave vedi Autenticazione; se non hai ancora un account, vedi Configura il tuo account.
• Un saldo. Ogni richiesta viene pagata con il tuo saldo prepagato in dollari statunitensi. Vedi Fatturazione.

Collega la chat di SillyTavern a SpicyAPI

La richiesta di chat la invia il server di SillyTavern, non il tuo browser, quindi da parte tua non serve configurare nient’altro.

Scegli un modello di chat

Gli ID dei modelli di chat terminano con /chat. Il menu a tendina Available Models viene riempito con l’elenco completo dei modelli di SpicyAPI, quindi mostra anche modelli di immagini, video e audio, che non possono chattare. I modelli di chat vengono per primi: scegline uno in cima all’elenco, oppure digita o incolla un ID /chat in Enter a Model ID.

Per vedere tutti i modelli di chat e che cosa accetta ciascuno, consulta i modelli di chat sul sito, oppure chiama GET https://api.spicyapi.ai/v1/models con la tua chiave (vedi Catalogo dei modelli). Ogni voce di chat ha context_length, max_output_tokens e supported_parameters.

Per il roleplay, la classifica roleplay ordina i modelli di chat per coerenza dei personaggi e libertà di scrittura. Alcuni modelli di chat sono senza censura e altri filtrano i contenuti; il catalogo indica il livello di policy di ogni modello.

Impostazioni consigliate

Le impostazioni di campionamento che il modello scelto non supporta, come temperature, top P, frequency penalty e presence penalty, vengono ignorate invece di essere rifiutate. SpicyAPI elenca quelle saltate nell’header di risposta X-Spicy-Ignored-Params. Puoi lasciare i cursori di SillyTavern dove sono.

Reasoning effort

Il menu Reasoning Effort di SillyTavern non viene inviato ai modelli di SpicyAPI. Se vuoi impostarlo, aggiungilo tu, e solo per un modello il cui supported_parameters elenca reasoning_effort:

1. Fai clic su Additional Parameters sotto il pulsante Connect.
2. In Include Body Parameters aggiungi una riga, per esempio:

reasoning_effort: low

I valori consentiti cambiano da modello a modello. Un livello che il modello non offre viene cambiato in quello più vicino che offre (indicato nell’header di risposta X-Spicy-Adjusted-Params), e su un modello senza livelli di ragionamento la riga viene ignorata. Controlla prima la voce del modello nell’elenco dei modelli. Se la risposta arriva vuota o troncata, aumenta Response (tokens) o abbassa l’effort.

Immagini nella chat

Quando Send inline media è attivo, SillyTavern allega le immagini della chat a ogni richiesta successiva. Un modello che non sa leggere le immagini rifiuta la richiesta con un 400, e poiché l’immagine resta nella chat, falliscono anche tutti i messaggi seguenti. Disattiva Send inline media per i modelli solo testo, oppure nascondi il messaggio che contiene l’immagine.

I video presenti nella chat non vengono inviati al modello.

Impostazioni che un modello rifiuta

Alcune impostazioni vengono comunque rifiutate quando un modello non le supporta, perché cambiano la risposta invece di limitarsi a regolarla: Multiple swipes per generation sopra 1 (n), i preset Logit Bias e Request token probabilities. Se una richiesta fallisce con un messaggio che nomina una di queste impostazioni, disattivala. Il testo dell’errore indica il campo.

Custom Stopping Strings funzionano su ogni modello. Un modello senza sequenze di stop (per esempio i modelli Grok) le ignora, e un modello che ne accetta meno di quante ne hai impostate tiene le prime; gli header di risposta X-Spicy-Ignored-Params e X-Spicy-Adjusted-Params dicono quali. Un valore dei cursori fuori dall’intervallo del modello, come una temperature di 1.5 su un modello che si ferma a 1, viene abbassato al limite allo stesso modo.

L’estensione SpicyAPI

L’estensione crea immagini e brevi video dall’interno di una chat. La installi una volta, aggiungi la chiave e scegli i modelli.

Comandi

Argomenti con nome che puoi aggiungere ai comandi:

• model=<id> usa un modello solo per questa esecuzione. Premi Tab dopo model= per l’elenco.
• edit=true apre l’editor del prompt anche se hai già digitato un prompt.
• quiet=true salva il risultato e ne restituisce il percorso senza pubblicarlo, per Quick Replies e STscript.
• avatar=true o avatar=false (solo immagini) sovrascrive l’impostazione «usa l’avatar del personaggio».

/spicy-img a lighthouse on a cliff at dusk, wide shot
/spicy-video waves rolling onto a beach at sunrise
/spicy-video image=last slow push-in, hair moving in the wind

Il menu della bacchetta accanto al campo della chat contiene SpicyAPI picture, SpicyAPI video e SpicyAPI: animate last picture.

Animate

Ogni immagine nella chat ha un’icona a forma di pellicola tra i suoi controlli, e i messaggi con un’immagine hanno la stessa icona nel menu .... Trasforma quell’immagine in un clip video con il tuo modello da immagine a video e aggiunge il clip allo stesso messaggio.

Prompt

Se non scrivi un prompt, il modello di chat a cui sei collegato ne scrive uno a partire dalla scena corrente. Con Let me read and edit the prompt before generating attivo (l’impostazione predefinita), si apre una finestra che mostra il modello, il prezzo esatto e il prompt così com’è scritto. Puoi aspettare, scriverne uno tuo o premere di nuovo Write from the scene. L’estensione non include prompt, preset o stili: le parole vengono da te o dal tuo modello di chat.

Con i modelli che accettano un’immagine di riferimento puoi usare l’avatar del personaggio, così l’immagine somiglia al personaggio.

Lascia che l’IA mostri immagini

Disattivato per impostazione predefinita. Attivalo da Let the AI show pictures nel pannello SpicyAPI, poi scegli come il modello di chat chiede un’immagine. Puoi usare l’uno o l’altro metodo, oppure entrambi:

Le immagini automatiche hanno limiti propri, oltre a quelli per esecuzione descritti più sotto:

• al massimo un’immagine ogni qualche risposta per chat (3 per impostazione predefinita); anche una richiesta rifiutata o fallita fa partire l’attesa;
• un limite giornaliero per le immagini automatiche in questo browser ($0.50 per impostazione predefinita);
• oltre il tuo importo di conferma, vale Ask me first (predefinito, mostra la descrizione e il prezzo) oppure Skip the picture.

Le esecuzioni automatiche creano solo immagini, mai video, e le immagini restano nascoste all’IA come ogni altro risultato. Finché lo strumento è attivo, la sua definizione viene inviata con ogni richiesta di chat, il che costa qualche token sulla tua API di chat. Il comportamento completo è descritto nel README dell’estensione.

Prezzi e limiti

Prima di ogni esecuzione l’estensione chiede un preventivo a SpicyAPI e lo mostra in dollari statunitensi. I preventivi sono gratuiti.

Il pannello mostra anche quanto ha speso questa sessione del browser. Per un limite rigido che vale ovunque, imposta un tetto di spesa giornaliero sulla chiave stessa. Vedi Autenticazione.

Un’esecuzione continua su SpicyAPI anche se premi Stop waiting o chiudi la pagina, e viene addebitata se ha successo. Recuperala più tardi con /spicy-task <task id>. Le esecuzioni fallite non vengono addebitate, tranne che sui pochi modelli la cui pagina dice che le richieste rifiutate sono a pagamento. Vedi Fatturazione.

Dove sono salvati la chiave e i file

• La tua chiave è salvata in chiaro nel file delle impostazioni di SillyTavern, sulla macchina che esegue SillyTavern (data/<user>/settings.json, sotto extension_settings.spicyapi). Le altre estensioni di SillyTavern possono leggerla. Se usi Connect chat, la chiave viene salvata anche nel file dei segreti di SillyTavern come chiave dell’endpoint Custom. Per questo conviene creare una chiave separata con un tetto di spesa.
• I risultati vengono scaricati e salvati nella cartella immagini di SillyTavern (data/<user>/user/images/<character>/spicyapi_<task id>.png oppure .mp4), poi allegati alla chat. I nuovi risultati sono nascosti all’IA per impostazione predefinita, così la richiesta di chat successiva non invia un’immagine a un modello che non può leggerla. Attiva Let the AI see generated pictures and videos per cambiarlo.
• Cosa lascia la tua macchina: il prompt, le impostazioni del modello e l’eventuale immagine di riferimento vanno a api.spicyapi.ai. Quando è il tuo modello di chat a scrivere il prompt, il contesto della chat va a qualunque API di chat sia collegata a SillyTavern, come per ogni altro messaggio.
• SpicyAPI conserva i file generati per un tempo limitato. Vedi Conservazione e distruzione.

Se cambi chat mentre qualcosa è in generazione, il risultato viene salvato ma non aggiunto alla chat, e l’estensione ti dice dove si trova.

Percorso di connessione

Per impostazione predefinita l’estensione parla con https://api.spicyapi.ai direttamente dal tuo browser. Se la tua rete o il tuo browser lo bloccano, apri Connection nel pannello e scegli Auto (prova direttamente, poi ripiega sul proxy CORS di SillyTavern) oppure Through SillyTavern's CORS proxy.

Il proxy è disattivato per impostazione predefinita. Attivalo impostando enableCorsProxy: true nel config.yaml di SillyTavern (oppure avvia SillyTavern con --corsProxy) e riavvia. Non si può combinare con l’autenticazione di base di SillyTavern (basicAuthMode), che rifiuta le richieste che contengono una chiave API. In quel caso usa il percorso diretto.

Risoluzione dei problemi

Gli errori di SpicyAPI terminano con un request_id o un ID attività. Comunicalo al supporto e la richiesta si potrà trovare con precisione. I codici di errore sono spiegati in Errori.