Configurazione API Janitor AI: la config proxy esatta, campo per campo
Updated 2026-07-15
Nelle impostazioni API di JanitorAI, scegli Proxy e compila cinque campi: un nome per la configurazione, un ID modello esatto come deepseek-v4-flash, l'endpoint completo https://api.apisrouter.com/v1/chat/completions, la tua chiave API e un prompt personalizzato opzionale. L'errore più comune è incollare un URL base che si ferma a /v1, perché JanitorAI non aggiunge mai il percorso al posto tuo.
Risposta rapida: i cinque valori che JanitorAI richiede
La configurazione proxy di JanitorAI ha esattamente cinque campi, e quattro sono copia-incolla. Apri una chat qualsiasi, vai su API Settings, scegli Proxy come tipo di API, poi crea una nuova configurazione con questi valori:
Configuration name: APIsRouter-deepseek (etichetta libera, la vedi solo tu)
Model name: deepseek-v4-flash (ID modello esatto, senza spazi)
Proxy URL: https://api.apisrouter.com/v1/chat/completions
API key: sk-... (incolla senza spazi iniziali o finali)
Custom prompt: (opzionale, lascia vuoto per usare la scheda personaggio così com'è)Cosa fa davvero ciascun campo
Mantieni il custom prompt breve e meccanico. Usi validi: limitare la lunghezza della risposta, imporre la terza persona, vietare azioni scritte per il tuo personaggio. Usi da evitare: incollare una seconda scheda personaggio o una guida di stile di mille parole, che gonfia ogni richiesta e spinge la cronologia più vecchia fuori dal contesto prima del previsto. Dopo il salvataggio, usa il pulsante check proxy se la tua build ne mostra uno, poi invia un breve messaggio di test. Se non torna nulla, ripercorri la tabella degli errori qui sotto prima di cambiare modello.
- Configuration name: un'etichetta locale. Non viene mai inviata all'API. Chiamala come il modello, tipo APIsRouter-deepseek o APIsRouter-glm, così puoi tenere una config salvata per modello e cambiare in due tap.
- Model name: inviato come parametro model in ogni richiesta. Deve essere l'ID esatto, minuscolo con trattini: deepseek-v4-flash funziona, "DeepSeek V4 Flash" no.
- Proxy URL: l'endpoint completo di chat completions. JanitorAI invia le richieste esattamente all'URL che digiti. SillyTavern prende un URL base che finisce in /v1 e aggiunge il percorso da solo, e popola automaticamente la lista modelli da /v1/models. JanitorAI non fa nessuna delle due cose, ed è per questo che un URL che si ferma a /v1 qui restituisce un 404 anche se funziona benissimo in SillyTavern.
- API key: inviata come header Authorization: Bearer solo al proxy URL. Non incollarla mai in un messaggio di chat o in uno screenshot.
- Custom prompt: un'istruzione opzionale a livello di sistema aggiunta accanto alla scheda personaggio, non un sostituto. Viene reinviata a ogni messaggio, quindi ogni parola costa token di input per tutta la vita della chat.
Quale nome modello inserire, e perché
Il proxy URL e la chiave API restano identici tra le configurazioni. L'unico valore che cambia per modello è il nome del modello, quindi la mossa pratica è una configurazione salvata per ogni modello che usi davvero. Per il roleplay, la famiglia DeepSeek V4 è il favorito approssimativo della community sui forum di JanitorAI: forte aderenza alla scheda personaggio ai prezzi per token più bassi di questa tabella. GLM-5, Kimi K2.6 e MiMo sono ottime scelte di valore con policy che accolgono contenuti fictional. Grok 4.5 è una scelta comune per temi fictional più cupi o maturi perché la policy pubblicata di xAI li permette esplicitamente nella fiction. Claude Sonnet 4.6 e Opus 4.7 scrivono la prosa migliore di tutti questi, ma la policy d'uso di Anthropic vieta i contenuti espliciti, quindi tratta Claude come un'opzione di scrittura creativa strettamente SFW. Due regole di base indipendentemente dal modello. JanitorAI è una piattaforma 18+ e i suoi ToS si applicano anche in modalità proxy, così come la content policy di qualsiasi provider di modello verso cui instradi. Scegliere un modello con una policy flessibile sulla fiction non sospende nessuna delle due.
| Nome modello (incolla esattamente) | Punti di forza su JanitorAI | Note sulla content policy |
|---|---|---|
| deepseek-v4-flash | Favorito della community; miglior valore per chat lunghe | Policy flessibile per contenuti fictional |
| deepseek-v4-pro | Migliore coerenza e memoria nelle chat lunghe | Stessa famiglia, tariffa più alta |
| glm-5 | Dialogo naturale a budget contenuto | Accoglie la fiction |
| kimi-k2.6 | Contesto lungo; scelta di valore | Accoglie la fiction |
| grok-4.5 | Voce distintiva; finestra di contesto da 500K | La policy xAI permette temi fictional maturi |
| claude-sonnet-4-6 | Miglior qualità di prosa per dollaro | Solo scrittura creativa SFW per policy Anthropic |
| claude-opus-4-7 | Caratterizzazione più profonda | Solo scrittura creativa SFW |
| gemini-3.5-flash | Tuttofare veloce di fascia media | Si applica la policy standard di Google |
Testa prima la chiave fuori da JanitorAI
Quando una config fallisce, hai tre sospettati: l'URL, la chiave e il nome del modello. La superficie di errore di JanitorAI è sottile, quindi testa tutti e tre insieme con curl prima di toccare di nuovo l'app:
curl https://api.apisrouter.com/v1/chat/completions \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-flash",
"messages": [{"role": "user", "content": "Say ready."}],
"max_tokens": 20
}'Risolvere 401, 404 e model not found
Se il test curl restituisce un completamento JSON, il tuo URL, la chiave e il nome del modello sono tutti validi, e il problema rimanente vive dentro JanitorAI: di solito una config non salvata, una configurazione selezionata non aggiornata, o un'estensione del browser che blocca la richiesta. Se curl fallisce, il codice di stato ti dice quale campo correggere.
| Errore | Causa abituale | Fix |
|---|---|---|
| 401 Unauthorized | Chiave incollata con uno spazio finale o un a capo, una chiave revocata, o il campo svuotato in silenzio dopo un aggiornamento dell'app | Reincolla la chiave senza spazi bianchi, conferma che inizi con sk-, salva di nuovo la config |
| 404 Not Found | L'URL proxy si ferma a /v1 o ha un errore di battitura nel percorso | Usa l'endpoint completo che termina in /chat/completions |
| Model not found / invalid model | Nome visualizzato invece di ID, maiuscole errate, o un ID deprecato | Incolla l'ID esatto minuscolo, es. deepseek-v4-flash; verifica contro l'output di /v1/models sopra |
| Network error / nessuna risposta | Config non salvata, config sbagliata selezionata, o un ad blocker che interferisce | Salva di nuovo, ricarica a fondo, conferma la config attiva, prova un profilo browser pulito |
| La risposta si interrompe a metà frase | Max new tokens impostato troppo basso nelle impostazioni di generazione di JanitorAI | Alza max new tokens a 300 o più e rigenera |
Quanto costa davvero un mese di chat
JanitorAI reinvia la scheda personaggio più la cronologia recente a ogni messaggio, quindi i token di input dominano la bolletta. Una config tipica con una scheda dettagliata gira intorno a 4.000-6.000 token di input e 200-400 di output per messaggio. La tabella assume 5.000 in ingresso e 300 in uscita su 1.000 messaggi, un mese pesante per la maggior parte degli utenti. Prendi questi come stime: la dimensione della tua scheda e la profondità della cronologia spostano i numeri. Queste sono le tariffe del catalogo APIsRouter. APIsRouter è un gateway compatibile OpenAI con fatturazione pay-as-you-go e nessun abbonamento; i modelli globali sono listati al 20% in meno del prezzo ufficiale e i modelli cinesi sotto le tariffe ufficiali. Non c'è un modulo di iscrizione: paghi sulla pagina di ricarica, la chiave arriva via email, e la tua prima ricarica aggiunge un bonus di saldo del 100%. Questo rende un test da $5 di DeepSeek o GLM un esperimento lungo mesi invece di un impegno mensile.
| Modello | Prezzo per 1M token (in / out) | Costo stimato per 1.000 messaggi |
|---|---|---|
| deepseek-v4-flash | $0.126 / $0.252 | ~$0.71 |
| deepseek-v4-pro | $0.3915 / $0.783 | ~$2.19 |
| glm-5 | $0.514 / $2.314 | ~$3.26 |
| gemini-3.5-flash | $1.20 / $7.20 | ~$8.16 |
| grok-4.5 | $1.60 / $4.80 | ~$9.44 |
| claude-sonnet-4-6 | $2.40 / $12.00 | ~$15.60 |
| claude-opus-4-7 | $4.00 / $20.00 | ~$26.00 |
| gpt-5.5 | $4.00 / $24.00 | ~$27.20 |
Domande frequenti
Quale API usa Janitor AI?
Di default JanitorAI gira sul suo modello integrato. La modalità Proxy ti permette di collegare invece qualsiasi API di chat completions compatibile OpenAI: fornisci l'URL completo dell'endpoint, un ID modello esatto e una chiave API, e JanitorAI invia le tue chat lì.
Come ottengo una chiave API per Janitor AI?
Da qualsiasi provider compatibile OpenAI. Le chiavi tipicamente hanno la forma sk- seguito da una lunga stringa. La chiave va nel campo API key e viene inviata solo al proxy URL che hai configurato. Alcuni gateway saltano del tutto la creazione dell'account: paghi prima e la chiave arriva via email.
Perché continuo a ricevere un errore 401 su Janitor AI?
Quasi sempre la chiave stessa: uno spazio finale o un a capo da un copia-incolla, una chiave revocata o esaurita, o una config che ha perso il campo in silenzio. Reincollala senza spazi bianchi e salva di nuovo. Se una richiesta curl con la stessa chiave ha successo, la chiave è a posto e la config salvata è obsoleta.
Qual è il miglior modello per il roleplay su Janitor AI?
Il consenso della community favorisce la famiglia DeepSeek V4: Flash per il valore, Pro per la coerenza nelle chat lunghe. GLM-5 e Kimi K2.6 sono ottime scelte economiche. Claude scrive la prosa migliore ma la policy Anthropic vieta i contenuti espliciti, quindi si adatta solo a chat creative SFW.
Il custom prompt sostituisce la mia scheda personaggio?
No. È un'istruzione extra a livello di sistema inviata insieme alla scheda a ogni messaggio. Poiché viene reinviata costantemente, tienila sotto poche frasi: regole di formattazione, lunghezza della risposta, prospettiva. Custom prompt lunghi gonfiano i costi di input e affollano la cronologia della chat.
L'uso dell'API di Janitor AI è gratuito?
Il modello integrato è gratuito con code nei momenti di picco. Le API esterne fatturano per token, ma i modelli entry-level costano una frazione di centesimo a messaggio, e alcuni provider offrono livelli gratuiti pesantemente limitati. Per chattare in modo costante, i modelli pay-as-you-go economici battono i tier gratuiti in affidabilità.