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.

MiMo è disponibile anche nel catalogo come scelta di roleplay economica; controlla la pagina modelli per il suo ID attuale.
Nome modello (incolla esattamente)Punti di forza su JanitorAINote sulla content policy
deepseek-v4-flashFavorito della community; miglior valore per chat lunghePolicy flessibile per contenuti fictional
deepseek-v4-proMigliore coerenza e memoria nelle chat lungheStessa famiglia, tariffa più alta
glm-5Dialogo naturale a budget contenutoAccoglie la fiction
kimi-k2.6Contesto lungo; scelta di valoreAccoglie la fiction
grok-4.5Voce distintiva; finestra di contesto da 500KLa policy xAI permette temi fictional maturi
claude-sonnet-4-6Miglior qualità di prosa per dollaroSolo scrittura creativa SFW per policy Anthropic
claude-opus-4-7Caratterizzazione più profondaSolo scrittura creativa SFW
gemini-3.5-flashTuttofare veloce di fascia mediaSi 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.

ErroreCausa abitualeFix
401 UnauthorizedChiave incollata con uno spazio finale o un a capo, una chiave revocata, o il campo svuotato in silenzio dopo un aggiornamento dell'appReincolla la chiave senza spazi bianchi, conferma che inizi con sk-, salva di nuovo la config
404 Not FoundL'URL proxy si ferma a /v1 o ha un errore di battitura nel percorsoUsa l'endpoint completo che termina in /chat/completions
Model not found / invalid modelNome visualizzato invece di ID, maiuscole errate, o un ID deprecatoIncolla l'ID esatto minuscolo, es. deepseek-v4-flash; verifica contro l'output di /v1/models sopra
Network error / nessuna rispostaConfig non salvata, config sbagliata selezionata, o un ad blocker che interferisceSalva di nuovo, ricarica a fondo, conferma la config attiva, prova un profilo browser pulito
La risposta si interrompe a metà fraseMax new tokens impostato troppo basso nelle impostazioni di generazione di JanitorAIAlza 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.

grok-4.5 è fatturato a token con tariffe da ammiraglia; la sua finestra di contesto da 500K tiene le chat molto lunghe dentro un'unica finestra, ma il volume di input continua a guidare la bolletta.
ModelloPrezzo 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à.