AIREITERUn proxy per Janitor AI non è, nella maggior parte dei casi, una VPN né uno strumento per nascondere l'indirizzo IP. È il percorso API verso un LLM: perché funzioni, endpoint, ID esatto del modello e chiave API devono appartenere allo stesso provider. Con un reverse proxy entra in gioco anche un server aggiuntivo, e quindi un ulteriore livello di fiducia.
Prima scegli il percorso, poi apri Janitor AI
Per la maggior parte degli utenti, la configurazione più semplice è un endpoint API diretto compatibile con OpenAI. Un aggregatore come OpenRouter è utile se vuoi accedere a più modelli da un unico account; un reverse proxy, invece, ha senso quando controlli il relay oppure devi adattare un backend privato o locale.
| Soluzione | Percorso della richiesta | Chi gestisce la richiesta? | Impegno di configurazione | Buon punto di partenza? |
|---|---|---|---|---|
| API diretta | Janitor AI → provider o gateway | Il gestore dell'endpoint e il provider del modello a monte | Basso | Sì, con una normale API esterna |
| Aggregatore | Janitor AI → aggregatore di modelli → modello scelto | L'aggregatore e il suo provider a monte | Da basso a medio | Sì, se ti serve scegliere tra più modelli |
| Reverse proxy | Janitor AI → tuo relay → provider o modello locale | Tu, chi ospita il relay e il provider a monte | Da medio ad alto | Solo se controlli il relay |
Non confondere un “proxy gratuito” condiviso con una connessione API diretta. Un relay condiviso può leggere il traffico che lo attraversa, sparire senza preavviso oppure chiedere credenziali che non dovrebbe mai ricevere. Usare una chiave del provider insieme all'endpoint dello stesso provider è un caso completamente diverso.
Cosa indicano davvero i campi Proxy di Janitor AI
Nel modulo Proxy di Janitor AI devi verificare tre valori legati allo stesso percorso: URL dell'endpoint, ID esatto del modello e chiave API. Tutti e tre devono provenire dal medesimo provider o relay.
| Campo di Janitor AI | Cosa inserire | Errore comune |
|---|---|---|
| Configuration Name | Un'etichetta a piacere, ad esempio AIReiter GPT-5.6 Luna | Modificare questa etichetta non cambia il modello |
| Model Name | L'ID attuale e preciso del modello fornito dal provider | Un nome commerciale, una differenza nelle maiuscole o un suffisso :free non più valido possono causare un errore sul modello |
| Other API/Proxy URL | Il formato endpoint richiesto dal percorso scelto | Un URL base può funzionare in un SDK, ma non nel campo proxy di Janitor AI |
| API Key | Una chiave creata per lo stesso endpoint o relay | Una chiave di un altro provider, revocata o con uno spazio aggiuntivo non funzionerà |
L'URL completo della richiesta e l'URL base di un SDK non sono necessariamente intercambiabili. Un SDK compatibile con OpenAI usa spesso una base come https://example.com/api/v1 e aggiunge autonomamente /chat/completions. Il campo proxy di Janitor AI può invece richiedere l'URL finale, https://example.com/api/v1/chat/completions: segui quindi le istruzioni specifiche per quel client.
Janitor AI prevede anche un'autorizzazione proxy a livello del personaggio. In un annuncio ufficiale di un moderatore, Janitor AI ha spiegato che selezionando Allow Proxy si consente l'uso del bot tramite proxy, poiché il proxy riceve le informazioni del bot. Un personaggio limitato alle opzioni OpenAI e JanitorAI non può essere usato attraverso un proxy esterno. Questa autorizzazione è indipendente dalla validità della chiave API.
Configurare Janitor AI in cinque minuti
Crea una configurazione, salvala, aggiorna la pagina e fai una prova con un prompt breve: è il modo più rapido per isolare eventuali errori di endpoint, ID modello o chiave.
1. Crea una chiave del provider
Genera una chiave API presso il provider o il gateway di cui incollerai l'URL in Janitor AI. Copiala quando il servizio la mostra, conservala come un segreto e non pubblicarla in screenshot, messaggi Discord, estensioni del browser o moduli di proxy condivisi.
Un modello contrassegnato come gratuito può comunque richiedere una chiave del provider. “Gratuito” descrive in genere il prezzo o la quota disponibile presso quel provider; non significa che Janitor AI possa chiamare il modello senza autenticazione.
2. Apri il pannello Proxy
Apri una chat con un personaggio in Janitor AI e individua API Settings. Seleziona Proxy, quindi Add Configuration o il comando equivalente. Per istruzioni aggiornate sul prodotto, consulta la categoria ufficiale dell'Help Center di Janitor AI dedicata ad account e configurazione, perché nomi e posizione delle voci possono cambiare.
Alcuni utenti hanno segnalato modifiche ai campi e l'obbligo di inserire il modello nell'interfaccia proxy di Janitor AI. (Esempio di segnalazione utente)
3. Compila, salva, aggiorna e prova
Inserisci soltanto valori forniti da un unico percorso. Non combinare l'endpoint di un servizio, l'ID modello copiato da un altro e una chiave appartenente a un terzo account.
- Assegna alla configurazione un nome riconoscibile.
- Incolla l'ID esatto del modello dalla pagina del modello attiva o dall'elenco modelli del provider.
- Incolla l'endpoint completo richiesto dal campo proxy di Janitor AI.
- Incolla la chiave API corrispondente.
- Salva la configurazione.
- Aggiorna o riapri la scheda di Janitor AI, quindi invia un breve messaggio di test.
Se il personaggio non è abilitato al proxy, passa a un personaggio che lo consente prima di analizzare l'endpoint. Una configurazione valida presso il provider non può aggirare la restrizione scelta dal creatore del personaggio.
Configurazione AIReiter: un percorso OpenAI-compatible verificato
Con AIReiter, nel campo Proxy URL di Janitor AI va inserito l'URL finale di Chat Completions, non l'URL base più breve destinato agli SDK. La guida di integrazione GPT-5.6 di AIReiter indica Chat Completions in /api/v1/chat/completions, usa gpt-5.6-luna come modello di esempio e distingue l'URL base del client dal percorso aggiunto dal client stesso.
Usa questa configurazione come punto di partenza:
| Campo di Janitor AI | Valore AIReiter |
|---|---|
| Configuration Name | AIReiter GPT-5.6 Luna |
| Model Name | gpt-5.6-luna |
| Other API/Proxy URL | https://aireiter.com/api/v1/chat/completions |
| API Key | La tua chiave API AIReiter |
La differenza tra gli endpoint è questa:
- Proxy URL di Janitor AI:
https://aireiter.com/api/v1/chat/completions - URL base dell'SDK OpenAI-compatible:
https://aireiter.com/api/v1 - Controllo dell'elenco modelli:
https://aireiter.com/api/v1/models
Non incollare /api/v1/models in Janitor AI: è un percorso diagnostico per verificare la disponibilità dell'ID modello. La guida AIReiter propone questo controllo:
curl -sS "https://aireiter.com/api/v1/models" \
-H "Authorization: Bearer $AIREITER_API_KEY"Se la risposta non contiene gpt-5.6-luna, usa l'ID esatto restituito dall'elenco e aggiorna la configurazione di Janitor AI. Quando stai verificando un problema di ID modello, lascia invariati endpoint e chiave.
AIReiter usa una fatturazione pay-as-you-go invece di un piano a livelli, quindi la chiave API deve comunque appartenere a un account con saldo utilizzabile. Prima di basarti su una tariffa visualizzata, consulta l'attuale pagina prezzi di AIReiter: il costo di una chat dipende dai token in input e output, non solo dal numero di messaggi.
OpenRouter e altri provider: cambia insieme tutti i dati del percorso
Passando a un altro provider, il modulo di Janitor AI resta identico, ma endpoint, chiave e ID modello devono essere aggiornati insieme. Il quickstart ufficiale di OpenRouter documenta la sua API compatibile con OpenAI, mentre il suo catalogo modelli aggiornato è il punto giusto da cui copiare un ID attivo.
| Campo | Schema OpenRouter |
|---|---|
| Model Name | Copia l'ID attuale ed esatto dal catalogo modelli di OpenRouter |
| Other API/Proxy URL | https://openrouter.ai/api/v1/chat/completions |
| API Key | Una chiave creata nel tuo account OpenRouter |
Considera un suffisso del modello come :free un'indicazione di disponibilità attuale, non un dato permanente della configurazione. I modelli gratuiti possono essere rimossi, soggetti a limiti di frequenza o rinominati: copia l'ID corrente subito prima di salvare la configurazione in Janitor AI.
Un thread ufficiale di un moderatore Janitor AI rimanda ai materiali di quickstart e troubleshooting per proxy/OpenRouter di Janitor, distinguendo però i problemi di integrazione Janitor dal supporto del provider per fatturazione e account. Per una connessione diretta a un provider, sostituisci tutti e tre i valori legati al percorso con endpoint, chiave e ID modello di quel provider.
Reverse proxy o API diretta: una scelta anche di sicurezza
Il percorso diretto è quello con meno componenti: provider o gateway gestiscono autenticazione, limiti, fatturazione, log e relativa privacy policy. Un reverse proxy aggiunge un relay che può ispezionare, trasformare, registrare o rifiutare il traffico prima che raggiunga il modello a monte.
Usa un reverse proxy solo se hai un motivo concreto per gestirlo, ad esempio per collegare un backend privato tramite un relay HTTPS autenticato o per normalizzare il protocollo di un provider. Un URL localhost privato funziona soltanto se il componente che effettua la richiesta gira sulla stessa macchina; se la richiesta parte dal server di Janitor AI, quel server non può raggiungere il localhost del tuo computer. Quando questa è l'architettura necessaria, utilizza un relay HTTPS pubblico correttamente autenticato.
Se controlli il relay, segui questa checklist:
- Richiedi HTTPS e un token di autenticazione separato per il relay.
- Conserva la chiave del provider a monte sul relay, invece di incollarla in un servizio condiviso sconosciuto.
- Disattiva i log dettagliati dei corpi delle richieste oppure imposta un periodo di conservazione breve e documentato.
- Limita host upstream e metodi di richiesta consentiti.
- Verifica se il relay inoltra header, cronologia della conversazione e dati del personaggio.
- Revoca e sostituisci le credenziali dopo una sospetta esposizione.
Un avviso di un utente reale mostra perché i relay anonimi meritano particolare cautela:
“if u use the moxxie proxy on janitor ai please stop using it !! whoever used that proxy your chats have gotten leaked and so has your ip address...” — @Ash3rz_c0m, avviso utente su X, giugno 2023 (fonte)
Si tratta di un incidente segnalato da un utente, non della prova che ogni reverse proxy sia dannoso. Non inserire una vera chiave del provider o conversazioni private in un relay di cui non puoi verificare operatore, criteri di conservazione dei dati e cronologia degli incidenti.
Individua il problema in base al punto in cui fallisce la richiesta
La maggior parte degli errori proxy di Janitor AI è più semplice da isolare se verifichi il percorso a livelli. Per prima cosa controlla che il modello integrato di Janitor AI risponda; poi verifica i valori di configurazione uno alla volta, prima di indagare su quote o disservizi del provider.
| Sintomo o stato | Livello probabile | Primo controllo |
|---|---|---|
400 o “invalid model” | Richiesta o selezione del modello | Copia l'ID modello attuale ed esatto; controlla maiuscole, prefisso del provider ed eventuali suffissi |
401 Unauthorized | Autenticazione | Revoca una chiave dubbia, creane una sostitutiva, elimina gli spazi e verifica che appartenga al provider dell'endpoint |
402 o messaggio su pagamento/quota | Saldo o autorizzazione dell'account | Controlla credito, stato della fatturazione e disponibilità gratuita attuale del provider |
404 o “model not found” | URL o percorso del modello | Confronta percorso completo dell'endpoint e ID modello con la documentazione aggiornata del provider |
429 | Limite di frequenza o utilizzo | Attendi, riduci la frequenza delle richieste, passa a un modello disponibile o aggiungi saldo quando necessario |
500, 502, 503 o timeout | Disponibilità dell'upstream o del relay | Riprova più tardi, controlla lo stato del provider e, se possibile, prova senza un relay personalizzato |
| “Failed to fetch” o errore di rete | Browser, endpoint, CORS o relay irraggiungibile | Ricontrolla HTTPS, URL completo e raggiungibilità pubblica del relay |
Il significato dei codici di stato varia in base al provider, quindi il corpo della risposta resta l'indizio prioritario. Un errore nel nome del modello non si risolve rigenerando la chiave, così come una chiave revocata non si ripara modificando la temperatura.
Le segnalazioni della community mostrano perché gli ID modello vanno sempre verificati di nuovo. In un thread per principianti di Janitor AI, u/Puzzleheaded-Town350 ha scritto:
“I get this message ‘proxy error 400 open-mistral-nemo-2407 is not a valid model’” — u/Puzzleheaded-Town350 in r/JanitorAI_Official
Quando una nuova configurazione non funziona, procedi in questo ordine:
- Prova il modello integrato di Janitor AI per distinguere un problema della piattaforma da uno del proxy.
- Verifica che il personaggio consenta i proxy.
- Verifica l'URL finale dell'endpoint, incluso
/chat/completionsse richiesto dal percorso. - Verifica l'ID modello esatto nell'elenco live del provider.
- Verifica che la chiave corrisponda all'endpoint e disponga ancora di autorizzazioni o saldo.
- Riprova con le impostazioni di generazione predefinite prima di modificare temperatura o limiti token.
Privacy e igiene dell'account
L'endpoint può ricevere prompt, cronologia delle conversazioni, dati sulla selezione del modello e talvolta informazioni sul personaggio. Esamina termini sulla privacy e impostazioni di conservazione dati del provider diretto, dell'aggregatore o del relay che scegli.
Se una chiave potrebbe essere stata esposta, revocala, creane una sostitutiva, rimuovi il vecchio valore dalle configurazioni Janitor AI e controlla la cronologia di utilizzo. Non verificare una chiave compromessa continuando a usarla.
FAQ su Janitor AI Proxy
Un proxy per Janitor AI è una VPN?
No. Instrada le richieste della chat verso un LLM esterno; una VPN modifica il routing di rete e non fornisce un modello linguistico.
Serve una chiave API anche per un modello gratuito?
Nella maggior parte dei casi sì. Un provider può non addebitare nulla per un modello o una quota, pur richiedendo una chiave legata all'account.
Devo incollare l'URL completo oppure solo /api/v1?
Usa l'URL finale richiesto dal campo Proxy di Janitor AI. Nell'esempio AIReiter è https://aireiter.com/api/v1/chat/completions; /api/v1 è l'URL base dell'SDK.
Perché un personaggio non vuole funzionare con un proxy?
Il creatore del personaggio potrebbe aver disabilitato l'uso del proxy. Una chiave esterna valida non può ignorare questa impostazione.
Janitor AI può chiamare direttamente localhost?
Solo se il componente che effettua la richiesta gira sulla stessa macchina del server locale. In caso contrario, usa un relay HTTPS pubblico adeguatamente protetto invece di esporre un servizio locale non autenticato.
Perché un ID modello che funzionava prima ha smesso di funzionare?
I provider modificano disponibilità dei modelli, alias, quote ed etichette dei piani gratuiti. Ricontrolla l'elenco modelli live e aggiorna prima il campo del modello.
Un proxy gratuito condiviso è sicuro?
Non darlo per scontato. Il gestore può potenzialmente leggere le richieste o acquisire le credenziali; è preferibile un collegamento diretto al provider o un reverse proxy che gestisci e puoi sottoporre a verifica.
Parti da una sola chiave privata, un ID modello esatto e un endpoint completo. L'API diretta è la scelta più semplice; un reverse proxy giustifica la manutenzione aggiuntiva solo se ti serve controllare il relay o la connessione upstream.