App di roleplay (RisuAI, Agnai, Chub, KoboldAI Lite, Janitor AI)

Le app di roleplay ti permettono di chattare con dei personaggi, e la maggior parte consente di usare un proprio modello di IA tramite una connessione compatibile con OpenAI. SpicyAPI parla quel protocollo, quindi puoi puntare queste app verso SpicyAPI, scegliere qualsiasi modello di testo e pagare dal tuo saldo SpicyAPI.

Questa pagina riguarda cinque app web e desktop: RisuAI, Agnai, Chub, KoboldAI Lite e Janitor AI. Per SillyTavern vedi SillyTavern. Le app sono realizzate da altri e cambiano le loro schermate; i nomi dei campi qui sotto vengono dal codice sorgente pubblicato e dalle pagine di aiuto di ciascuna app, e ogni sezione indica che cosa è stato verificato e che cosa no.

Cosa ti serve

• Un account SpicyAPI con un saldo. Vedi Configura il tuo account e Fatturazione.
• Una chiave API che inizia con sk-spicy-. Vedi Autenticazione.
• Un ID modello. I modelli di testo si chiamano <maker>/<model>/chat, qui scritto come MODEL_ID_FROM_CATALOG. MODEL_ID_FROM_CATALOG sta per l’ID di un modello di chat che copi dal catalogo in tempo reale (GET /api/v1/models); non digitare mai il segnaposto stesso. L’ID va scritto esattamente, compreso il /chat finale. L’elenco completo è su spicyapi.ai/models; con la tua chiave lo restituisce anche GET https://api.spicyapi.ai/v1/models, e gli ID di chat sono quelli che terminano con /chat. Vedi Catalogo dei modelli.

Quale app compila quale campo

La differenza tra l’indirizzo breve e quello completo conta. Le app che aggiungono da sole /chat/completions smettono di funzionare se lo includi, mentre Janitor AI lo vuole scritto per intero.

Scegli un modello

Per il roleplay serve un modello che resti nel personaggio, scriva risposte lunghe e non rifiuti le normali richieste narrative. La classifica roleplay e LLM ordina i modelli di testo di SpicyAPI su questi aspetti e mostra i prezzi attuali. Consultala invece di fidarti di un elenco scritto qui, perché modelli e classifiche cambiano.

Ogni pagina di modello mostra anche un’etichetta di policy dei contenuti (per esempio unrestricted, borderline o filtered). Quell’etichetta indica con quanta libertà risponde il modello; scegli un modello la cui etichetta si adatti alle storie che vuoi scrivere.

DeepSeek V4.1 Flash è un buon primo modello da provare: è tra i primi in classifica ed è uno dei più economici. Copia il suo ID (termina con /chat) dal catalogo in tempo reale su spicyapi.ai/models invece di scriverlo a memoria.

Due limiti da conoscere:

• Alcuni modelli accettano al massimo 256 messaggi per richiesta. In una chat molto lunga, un’app che invia l’intera cronologia può superarli. Cerca nell’app l’impostazione su quanta cronologia inviare, o la dimensione del contesto, e abbassala. La pagina del modello elenca i suoi limiti.
• L’input di immagini funziona solo con i modelli che leggono le immagini. Una normale chat di roleplay non ne ha bisogno.

Impostazioni di campionamento

Le app di roleplay inviano con ogni messaggio una serie di impostazioni di campionamento: temperature, top-p, top-k, min-p, top-a, frequency, presence e repetition penalty. I modelli differiscono per quali di queste accettano.

SpicyAPI ignora quelle che un modello non usa, invece di rifiutare il messaggio. Ignora anche n: 1, un elenco di stop vuoto e le stringhe di stop su un modello che non ne ha. Quando ignora qualcosa, la risposta contiene un header X-Spicy-Ignored-Params che nomina le impostazioni scartate, così puoi vedere esattamente che cosa non ha avuto effetto.

Quando un modello accetta un’impostazione ma non il valore che hai inviato, SpicyAPI usa il valore più vicino che accetta: una temperature sopra il massimo del modello diventa il massimo, e un elenco di stringhe di stop più lungo di quanto il modello consente tiene le prime. Queste modifiche sono elencate in un header X-Spicy-Adjusted-Params, per esempio temperature=1, stop=kept 1 of 3. Quindi puoi lasciare i tuoi preset abituali così come sono.

I campi che non sono impostazioni di campionamento sono un’altra cosa: se un’app invia qualcosa che il modello non conosce affatto, SpicyAPI risponde comunque con un errore 400 che nomina il campo.

Modelli con ragionamento e Max tokens

Alcuni modelli ragionano prima di rispondere. Il ragionamento usa token, e quei token contano nel limite di Max tokens (indicato anche come Max output, Response length o max_new_tokens, a seconda dell’app).

• Imposta Max tokens con generosità. Se è molto piccolo, per esempio 20 o 200, un modello con ragionamento può consumare tutto il budget pensando e non restituire alcun testo. Ricevi un errore upstream_failed che dice che il budget di output è stato speso nel ragionamento. Parti da 1.000 o più e aumenta se le risposte vengono troncate.
• Il ragionamento costa denaro e tempo. I token di ragionamento si pagano come qualsiasi altro output, e la prima parola arriva più tardi. Ad alcuni modelli si può chiedere di ragionare meno con l’impostazione reasoning_effort. I livelli cambiano da modello a modello; un livello che il modello non offre viene cambiato in quello più vicino che offre, e le impostazioni di ragionamento in stile OpenRouter (le invia Agnai) vengono tradotte in reasoning_effort. Le app che hanno un riquadro Additional Parameters o di parametri personalizzati possono passarlo, per esempio reasoning_effort con un valore più basso; la maggior parte delle app qui sotto non lo invia da sola.
• Alcune app mostrano il ragionamento nella chat. Janitor AI lo racchiude in tag <think>. Chub non lo mostra affatto.

Tieni sotto controllo la spesa

Le chat di roleplay sono lunghe e le app rinviano l’intera conversazione a ogni messaggio, quindi il costo per messaggio cresce con la chat.

Per ogni app crea una chiave dedicata nella console. Mentre la crei apri Advanced e imposta un tetto di spesa giornaliero (e uno mensile, se vuoi). Se l’app si comporta male, va in loop o la chiave trapela, il danno si ferma al tetto, e puoi revocare quella singola chiave senza toccare nient’altro. Una chiave può anche essere limitata a modelli specifici. Vedi Autenticazione.

Queste app conservano la tua chiave sui propri server o nel tuo browser. Il sito web di RisuAI, Agnai e Janitor AI fanno passare la tua chiave e la tua chat dai loro server; Chub e KoboldAI Lite inviano le richieste direttamente dal tuo browser. Una chiave separata e con tetto è la precauzione giusta in ogni caso.

RisuAI

RisuAI funziona su risuai.xyz, come app desktop o sul tuo server. Verificato sul codice sorgente di RisuAI (versione 2026.8.250).

Da dove partono le richieste. Su risuai.xyz, RisuAI di norma inoltra le richieste attraverso il proprio server, quindi la tua chiave e la tua chat passano da lì. L’app desktop e un server self-hosted inviano le richieste direttamente dalla tua macchina. Solo l’opzione «Force Plain Fetch» del sito web, nascosta tra le impostazioni sconsigliate, invia le richieste dal browser; SpicyAPI accetta anche quelle.

Campionamento. Le impostazioni predefinite di Custom API in RisuAI inviano frequency, presence e repetition penalty, min-p e top-a. SpicyAPI ignora quelle che il modello non usa, quindi le impostazioni predefinite funzionano.

Agnai

Agnai si trova su agnai.chat. Verificato sul codice sorgente di Agnai (branch dev, 2026-10-06). SpicyAPI non è nell’elenco dei provider integrati di Agnai, quindi lo aggiungi come connessione personalizzata compatibile con OpenAI.

Da dove partono le richieste. Con un provider aggiunto in questo modo, la richiesta la invia il server di Agnai, quindi la tua chiave viene conservata da Agnai.

Campionamento. Agnai invia sempre temperature e top-p, che alcuni modelli non accettano. SpicyAPI li ignora per quei modelli, quindi modelli come DeepSeek V4 e Kimi K3 funzionano.

Sconsigliato: le modalità dirette dal browser. Agnai ha anche un tipo di connessione Self-Host e un interruttore Use Local Requests nei preset più vecchi, che fanno chiamare l’indirizzo direttamente dal tuo browser. Dal codice sorgente risulta che queste modalità aggiungono un campo chiamato think che SpicyAPI non accetta, e SpicyAPI risponde 400 ai campi che non conosce. Non è stato provato con SpicyAPI. Se lì ottieni un 400, torna alla configurazione del provider descritta sopra.

Chub

Chub (chub.ai) invia le richieste direttamente dal tuo browser all’indirizzo che gli dai. Verificato sul codice front-end pubblicato da Chub (build del 2026-06-28); le schermate di Chub potrebbero essere cambiate da allora. La connessione dal browser funziona perché SpicyAPI consente le richieste dalle pagine web.

Chub avverte nella sua pagina delle impostazioni che il tuo IP e la cronologia della chat potrebbero essere registrati quando usi un reverse proxy. È un’avvertenza di Chub, non di SpicyAPI.

Cose che emergono dal codice sorgente e possono sorprenderti:

• Chub smette di leggere una risposta in streaming dopo 120 secondi. Un modello con ragionamento che pensa a lungo può essere interrotto; abbassa il suo reasoning effort o scegli un modello che risponde più in fretta.
• Chub non mostra il ragionamento di un modello, solo la sua risposta.

KoboldAI Lite

KoboldAI Lite è una singola pagina web su lite.koboldai.net. Verificato sul suo index.html pubblicato. Chiama l’indirizzo direttamente dal tuo browser, cosa che funziona perché SpicyAPI consente le richieste dalle pagine web.

Lascia disattivato «CORS Proxy». KoboldAI Lite ha un’opzione per instradare le richieste attraverso un proxy gestito dal suo autore. Con SpicyAPI non ti serve, e attivarla fa passare la tua chiave dal server di qualcun altro.

Campionamento. La sua impostazione di ripetizione viene inviata all’API come presence penalty. SpicyAPI la ignora per i modelli che non la usano.

Janitor AI

La funzione «proxy» di Janitor AI invia la tua chat a un indirizzo che scegli tu. Nel centro assistenza di Janitor, i campi si trovano nell’icona a ingranaggio della pagina di chat, sotto API Settings, poi Add Configuration.

Se Janitor mostra un errore di rete o di connessione come «A network error occurred», probabilmente la pagina di Janitor sta bloccando le richieste verso indirizzi diversi da quello di OpenAI. La pagina web di Janitor ha una security policy che consente richieste dirette a un solo indirizzo di IA di terze parti, quello di OpenAI. Quando Janitor invia la richiesta dal tuo browser, il browser la rifiuta prima che SpicyAPI veda qualcosa, e SpicyAPI non può cambiare la situazione. Se la tua chiave non mostra alcun utilizzo nella console mentre compare questo errore, la causa è questa.

Se ti capita, usa invece SillyTavern o RisuAI.

Altri fatti dal centro assistenza e dal codice della pagina di Janitor:

• Alcuni bot di Janitor hanno i proxy disattivati dai loro autori, quindi un bot può rifiutarsi di chattare tramite proxy qualunque cosa tu inserisca.
• Janitor mostra il ragionamento di un modello racchiuso in tag <think>. Usa un Max tokens più grande o un reasoning effort più basso per tenerlo breve.
• Janitor limita la lunghezza di un singolo messaggio che digiti.

Risoluzione dei problemi

I codici di errore sono spiegati in Errori. Ogni errore termina con un request_id; comunicalo al supporto e la richiesta si potrà trovare con precisione. Le tue richieste compaiono anche sotto Logs nella console, che è il modo più rapido per capire se una richiesta sia arrivata a SpicyAPI.