Configurazione proxy Janitor AI: formato URL, modelli e fix per il 429

Risposta rapida: i tre campi che JanitorAI richiede

La configurazione proxy di JanitorAI richiede esattamente tre valori: un URL proxy, un nome di modello e una chiave API. L'URL proxy deve essere l'endpoint completo di chat completions, non un URL base. Se il tuo provider ti dà un URL base che finisce in /v1, aggiungi /chat/completions prima di incollarlo in JanitorAI. Questo singolo dettaglio causa più configurazioni fallite di tutto il resto messo insieme. Inserisci l'ID del modello esattamente come lo scrive il provider, minuscolo e trattini inclusi, poi salva e invia un breve messaggio di test. Se torna una risposta, hai finito. Se ottieni invece un codice di errore, salta alla tabella degli errori qui sotto. Ogni codice comune ha una causa specifica e un fix specifico.

Proxy URL:  https://api.apisrouter.com/v1/chat/completions
Model:      deepseek-v4-flash
API Key:    sk-...   (incolla esattamente, senza virgolette, senza spazi finali)

Cosa significa "proxy" nella community di JanitorAI

La parola è fuorviante. Nello slang di JanitorAI, un proxy non è un proxy di rete o una VPN. È qualsiasi endpoint API compatibile OpenAI a cui il sito invia le tue richieste di chat invece che al suo backend predefinito. La community ha adottato il termine anni fa quando la gente ha iniziato a instradare le chat attraverso reverse proxy delle API dei provider, e il nome è rimasto anche se oggi la maggior parte delle configurazioni parla direttamente con un provider o un gateway. Le persone usano un proxy per tre motivi. Primo, la scelta del modello: scegli esattamente quale LLM scrive i tuoi personaggi invece di accettare qualsiasi cosa il sito imposti di default. Secondo, la qualità: modelli come DeepSeek V4 o Claude scrivono scene più lunghe e coerenti di un tier gratuito integrato. Terzo, il controllo dei costi: con una chiave a pagamento per token vedi esattamente quanto costa ogni chat invece di pagare per un abbonamento che magari non usi appieno. Ci sono tre tipi di endpoint che vedrai condividere nella community. Le API ufficiali dei provider (OpenAI, Anthropic, xAI, DeepSeek) richiedono un account con ciascun fornitore. I gateway aggregano molti modelli dietro un unico URL e una chiave compatibili OpenAI. I "proxy gratuiti" della community sono chiavi condivise che qualcun altro paga, ed è per questo che sono instabili e pesantemente rate-limited. Un'altra cosa da dire chiaramente: qualunque endpoint tu usi, la content policy del provider del modello a monte si applica comunque a ogni risposta, e i termini di JanitorAI, compreso il suo requisito solo per adulti, governano comunque la piattaforma. Conoscere entrambe le policy prima di scegliere un modello ti risparmia rifiuti a metà scena.

Configurazione completa: dalla chiave API alla prima risposta

Se vuoi una sola chiave che copra DeepSeek, GLM, Kimi, Claude, Gemini e Grok insieme, un gateway compatibile OpenAI come APIsRouter è la strada a basso attrito: il checkout su /topup non richiede registrazione account, la chiave arriva via email, e l'URL proxy per JanitorAI è https://api.apisrouter.com/v1/chat/completions. Una sfumatura se usi anche SillyTavern: SillyTavern vuole l'URL base che finisce a /v1 e popola automaticamente la sua lista modelli da /v1/models con la tua chiave, mentre JanitorAI vuole il percorso completo incluso /chat/completions. Stesso endpoint, quantità diversa dell'URL. Confondere i due formati è la causa principale degli errori 404 in entrambe le app.

• Ottieni una chiave API da un provider o gateway compatibile OpenAI. Ti servono la stringa della chiave e l'URL dell'endpoint documentato.
• Apri una chat con un personaggio qualsiasi su JanitorAI, poi apri API Settings e seleziona l'opzione Proxy.
• Incolla l'URL completo dell'endpoint che termina in /chat/completions nel campo proxy URL.
• Digita l'ID del modello esattamente come documentato, per esempio deepseek-v4-flash o glm-5.
• Incolla la chiave API, salva le impostazioni, e ricarica la pagina se il salvataggio non si registra.
• Invia un messaggio di test di una riga. Una risposta normale significa che tutta la catena funziona.

Testa l'endpoint con curl prima di dare la colpa a JanitorAI

Quando un proxy si comporta male, testa l'endpoint fuori da JanitorAI per primo. Una chiamata curl di 10 secondi ti dice se il problema è l'endpoint, la chiave, o il modo in cui hai configurato il sito. Esegui questo in qualsiasi terminale, con la tua chiave e il tuo modello:

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": "Reply with one short sentence."}]
  }'

Errore 429: perché i proxy gratuiti fanno rate limit nei picchi

Una risposta 429 significa "troppe richieste". È di gran lunga l'errore proxy più segnalato nella community di JanitorAI, e il pattern dietro di esso è prevedibile. Un proxy gratuito o condiviso è un'unica chiave API che serve centinaia o migliaia di utenti. I provider applicano limiti per chiave su richieste al minuto e token al minuto, quindi quando il traffico serale statunitense raggiunge il picco, tutti confluiscono nella stessa quota e la chiave inizia a rifiutare richieste. Non sei preso di mira personalmente. Il secchio è semplicemente vuoto, e si riempie più lentamente esattamente quando più persone vogliono chattare. I proxy gratuiti hanno una seconda modalità di guasto: la chiave stessa muore. Le chiavi condivise vengono revocate per violazioni di policy o saldi esauriti, e a quel punto lo stesso URL inizia a restituire 401 o 404 invece, spesso senza alcun annuncio. Gli endpoint a pagamento evitano strutturalmente il muro delle ore di picco. La tua chiave ha una quota tutta sua invece di condividere un secchio con una folla, la fatturazione è per token quindi il provider non ha motivo di limitarti verso un tier ad abbonamento, e la capacità è provisionata per il traffico pagante. Se vedi un 429 su una chiave personale a pagamento, è quasi sempre un limite di burst breve: aspetta qualche secondo e riprova, o rallenta le rigenerazioni a raffica. I 429 persistenti su una chiave personale meritano un ticket di supporto, non un workaround.

Tabella errori proxy JanitorAI: 429, 401, 404, timeout

Confronta il codice che JanitorAI ti mostra con questa tabella. La colonna del fix assume che tu abbia già confermato che l'endpoint funziona con il test curl sopra; se curl fallisce nello stesso modo, il problema è lato endpoint, non in JanitorAI.

Quale modello far girare dietro il tuo proxy Janitor AI

La scelta del modello conta più di qualsiasi ritocco alle impostazioni di generazione. Il consenso della community è stabile: la famiglia DeepSeek V4 è la favorita per il roleplay perché scrive risposte lunghe e coerenti col personaggio a prezzi dove il costo smette di essere una considerazione. GLM-5, Kimi K2.6 e MiMo sono le scelte di valore da alternare quando vuoi una voce diversa. Grok 4.5 viene elencato tra le opzioni a policy flessibile perché la policy pubblicata da xAI permette temi maturi in contesti chiaramente fictional per utenti adulti. Claude Sonnet 4.6 scrive la prosa più forte del catalogo e si adatta alla scrittura creativa SFW; la policy di Anthropic vieta i contenuti espliciti, quindi tienilo su chat guidate dalla storia e non esplicite. Tutti i prezzi di catalogo sotto sono pay-as-you-go senza abbonamento. I modelli globali sono prezzati il 20% sotto le tariffe ufficiali e i modelli cinesi sotto il prezzo ufficiale, e una prima ricarica raddoppia il tuo saldo iniziale.

Domande frequenti