Come utilizzare i modelli gratuiti di AIHubMix in JanitorAI: Configurazione del Proxy e errori comuni

JanitorAI può comunicare con qualsiasi API compatibile con OpenAI attraverso l'opzione Proxy, e AIHubMix è una di queste. L'intera configurazione consiste in quattro valori da inserire in un modulo:

Nome:       qualsiasi cosa tu voglia, ad esempio AIHubMix MiMo
URL Proxy:  https://aihubmix.com/v1/chat/completions
Chiave API: la tua chiave AIHubMix
Modello:    xiaomi-mimo-v2.6-pro-free

Lascia Custom prompt vuoto, premi Test, poi Add, e aggiorna la pagina. Questo è tutto.

La maggior parte dei fallimenti segnalati nella comunità di JanitorAI deriva da uno di quei quattro campi che è leggermente errato, o dal fatto che il piano gratuito si esaurisce prima del previsto. Questa guida illustra la configurazione una volta, poi copre ciascun errore che è probabile tu possa vedere e cosa fare al riguardo.

Prima di iniziare

Hai bisogno di tre cose:

1. Un account AIHubMix e una chiave API. Registrati, poi crea una chiave nella pagina delle chiavi API di AIHubMix. Copiala subito in un posto sicuro.
2. Un bot che consente i proxy. Un proxy funziona solo con bot che mostrano "proxy consentito" sopra il selettore della persona o il pulsante di avvio chat, come spiega questa guida ai proxy della comunità. I bot con definizioni di carattere visibili di solito lo consentono.
3. Un ID modello. Scegline uno dalla lista dei modelli gratuiti di AIHubMix e copia il suo ID esattamente. L'attuale preferito della comunità per il gioco di ruolo è xiaomi-mimo-v2.6-pro-free; la guida ai modelli in questa serie confronta le opzioni.

Una cosa da sapere prima del tuo primo messaggio: un nuovo account ottiene 10 chiamate di prova in totale, condivise tra tutti i modelli gratuiti. Dopo un ricarico una tantum di $1 o più, l'account passa a quote giornaliere (100 richieste al giorno, 10 al minuto, 1M token al giorno). La guida ai limiti in questa serie spiega fino a che punto si arriva in una lunga chat.

I quattro valori e dove le persone sbagliano

L'ID modello va nel campo Modello. È in minuscolo e mantiene il suo suffisso -free. "Xiaomi Mimo V2.6 Pro (free)" è il nome visualizzato e non funzionerà; xiaomi-mimo-v2.6-pro-free funzionerà.

Accanto all'etichetta URL Proxy c'è un pulsante Aggiungi /chat/completions. Esso aggiunge solo /chat/completions a qualsiasi cosa sia già presente nel campo. Se hai incollato l'URL completo sopra, non cliccarlo, altrimenti il percorso finisce due volte. Se hai incollato https://aihubmix.com/v1, un clic lo completa.

Il campo chiave API dice "(opzionale)". Compilalo comunque: senza una chiave, ogni richiesta viene rifiutata.

Custom prompt sovrascrive il prompt di sistema per questo proxy ed è inviato all'inizio di ogni richiesta mentre il proxy è attivo. AIHubMix non ne ha bisogno, quindi lascialo vuoto.

Configurarlo in JanitorAI

JanitorAI ha ridisegnato le sue impostazioni di chat il 19 luglio 2026, quindi i video più vecchi mostrano schermi diversi. I passaggi seguenti sono stati verificati rispetto alla versione web attuale nell'ottobre 2026:

1. Apri una chat con un bot che consente i proxy.
2. Apri il menu in alto a destra e scegli Impostazioni.
3. Sotto Fornitore, scegli Proxy.
4. Sotto Configurazioni Proxy, clicca + Nuovo.
5. Nella forma Nuova Configurazione, compila Nome, URL Proxy, Chiave API e Modello con i valori sopra. Lascia Custom prompt vuoto.
6. Clicca Test. Se la configurazione funziona, non appare nulla; un messaggio appare solo quando c'è qualcosa di sbagliato.
7. Clicca Aggiungi, poi aggiorna la pagina o riavvia la chat.

L'aggiornamento nel passaggio 7 è il passaggio che le persone saltano di più. Fino a quando la pagina non si ricarica, JanitorAI può continuare a inviare messaggi attraverso la vecchia impostazione.

Puoi salvare diverse configurazioni, ad esempio una per modello, il che rende veloce il passaggio quando un modello è occupato. Per aggiungere un backup, apri una configurazione salvata, clicca Duplica, e cambia solo il campo Modello.

Impostazioni per la tua prima chat

Apri di nuovo il menu → Impostazioni e guarda i controlli di generazione. Due di essi sono importanti per un primo utilizzo, secondo il tutorial di Arcanum RPGs sul pannello attuale:

• Dimensione del contesto. Con un modello esterno, il cursore arriva fino a 128.000 token. Inizia tra 16.000 e 32.000. Il tooltip di JanitorAI stesso dice di abbassarlo se le risposte non vengono generate.
• Token massimi. 0 consente al modello di scegliere la lunghezza della risposta. Qualsiasi altro numero è un fermo, quindi un valore basso può interrompere le risposte a metà frase.

Premi Salva; nulla si applica finché non lo fai.

La dimensione del contesto è importante per più di qualità. Ogni turno invia di nuovo l'intero contesto, e tutti i modelli gratuiti condividono un unico pool di 1M token al giorno. Una volta che una chat riempie un contesto di 32.000 token, quel pool copre circa 30 risposte, ben al di sotto del limite di 100 richieste. La guida ai limiti in questa serie analizza i numeri.

Opzionale: testa la tua chiave al di fuori di JanitorAI

Se ti senti a tuo agio con un terminale, questa richiesta separa "la mia chiave è errata" da "la mia configurazione di JanitorAI è errata". Utilizza lo stesso endpoint documentato nel quick start di AIHubMix, e consuma una richiesta (una delle tue 10 chiamate di prova se non hai ricaricato).

export AIHUBMIX_API_KEY="incolla-la-tua-chiave-qui"

curl https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "xiaomi-mimo-v2.6-pro-free", "messages": [{"role": "user", "content": "Dì ciao in cinque parole."}]}'

Una risposta con del testo significa che la chiave e l'ID modello sono a posto, e il problema è nei campi di JanitorAI o nel mancato aggiornamento.

Errori comuni e come risolverli

"Errore di rete" o "Impossibile recuperare"

Il test mostra "Errore di rete. Riprova più tardi!", oppure la chat mostra "Si è verificato un errore di rete, potresti essere limitato o avere problemi di connessione: Impossibile recuperare".

• Perché: La richiesta non ha mai raggiunto AIHubMix, o la risposta non è mai tornata al tuo browser. Nonostante la formulazione, "Impossibile recuperare" indica un problema di connessione, non una quota. La causa abituale è un VPN o proxy che blocca o devia aihubmix.com; un'estensione del browser che filtra le richieste può fare lo stesso. Nel test di AIHubMix di questa guida, un VPN è stata la causa.
• Correzione: Disattiva il VPN, passa a un altro server, o assicurati che lasci passare aihubmix.com. Metti in pausa le estensioni di blocco degli annunci o di privacy su janitorai.com. Poi premi di nuovo Test.

Il test mostra un errore, o il bot non risponde mai

• Perché: L'URL Proxy è incompleto (solo URL di base o homepage), ha un errore di battitura, o termina in /chat/completions due volte perché è stato cliccato il pulsante Aggiungi /chat/completions dopo aver incollato l'URL completo. AIHubMix risponde a un percorso errato con "L'endpoint API richiesto non esiste."
• Correzione: Incolla https://aihubmix.com/v1/chat/completions esattamente, senza spazi finali.

"Modello non trovato" o un errore di modello

• Perché: Il campo Modello contiene un nome visualizzato, ha una lettera maiuscola, o ha perso il suo suffisso -free.
• Correzione: Copia di nuovo l'ID dalla lista dei modelli gratuiti e incollalo così com'è.

"Chiave non valida" o un errore di autenticazione

• Perché: La chiave appartiene a un altro servizio, è stata eliminata, ha uno spazio in più, o il campo è vuoto. AIHubMix restituisce "nessuna chiave fornita" per una chiave vuota e "chiave non valida" per una errata.
• Correzione: Crea una nuova chiave nella pagina delle chiavi di AIHubMix e incollala di nuovo.

Hai cambiato le impostazioni ma nulla è cambiato

• Perché: JanitorAI sta ancora utilizzando la configurazione che ha caricato in precedenza.
• Correzione: Aggiorna la pagina o riavvia la chat, e controlla che la configurazione giusta sia selezionata.

La "risposta" del bot è un avviso che la tua prova è esaurita

• Perché: Le 10 chiamate di prova sono esaurite. AIHubMix continua a rispondere con una nota invece di un errore, quindi in JanitorAI appare probabilmente come un messaggio nella chat.
• Correzione: Ricarica $1 o più una volta; l'account passa a quote giornaliere per i modelli gratuiti. La guida al ricarico in questa serie copre i passaggi.

Errore 429

Un 429 ha due cause comuni:

• Hai raggiunto un limite. Superato il tuo limite per minuto o per giorno, l'API restituisce 429 fino all'inizio del minuto o del giorno successivo. Alcuni modelli hanno limiti inferiori rispetto ai 100 al giorno e 10 al minuto standard (ad esempio, qwen3.6-plus-preview-free consente 50 al giorno e 5 al minuto), e il pool condiviso di 1M token può esaurirsi prima nelle lunghe chat.
• Il modello è occupato. La capacità gratuita su alcuni modelli è limitata, e il changelog di AIHubMix ha avvisato che gli errori 429 "possono verificarsi" su un modello gratuito per questo motivo. Quando molte persone si affollano su un modello popolare contemporaneamente, questa è la causa abituale.

Correzione: Aspetta un minuto e riprova, invia messaggi meno frequentemente, o passa a una seconda configurazione salvata con un modello diverso. Se il problema è il limite giornaliero, la quota si ripristina una volta al giorno.

Un 404 che menziona model_retired

• Perché: Il modello è stato rimosso. Dal 1 settembre 2026, i modelli ritirati restituiscono un esplicito model_retired 404.
• Correzione: Scegli un altro modello dalla lista gratuita e aggiorna il campo Modello.

I modelli gratuiti hanno smesso di funzionare dopo aver utilizzato quelli a pagamento

• Perché: Quando il saldo di un account scende sotto -$1, i modelli gratuiti non possono essere chiamati fino a quando l'account non viene ricaricato di nuovo.
• Correzione: Ricarica per riportare il saldo sopra quella soglia.

Ancora bloccato?

La pagina di contatto di AIHubMix elenca il server Discord ufficiale, l'email di supporto (feedback@aihubmix.com), e la pagina di stato. La pagina di stato tiene traccia dei servizi come le Chat Completions, non dei singoli modelli, quindi un modello occupato non apparirà lì.

Per ottenere una risposta rapida, includi:

• l'orario della richiesta e il tuo fuso orario
• l'ID modello e l'endpoint (l'URL Proxy)
• lo stato HTTP o il testo di errore, e un ID di traccia se ne è stato mostrato uno
• cosa ti aspettavi e cosa è successo invece

Lascia fuori la tua chiave API. Il supporto non ne ha bisogno, e chiunque la possieda può spendere la tua quota.

FAQ

È gratuito utilizzare AIHubMix in JanitorAI?
Ogni nuovo account ottiene 10 chiamate di prova tra tutti i modelli gratuiti. Dopo un ricarico una tantum di $1 o più, i modelli gratuiti passano a quote giornaliere: 100 richieste al giorno, 10 al minuto, e 1M token al giorno condivisi tra di essi.

Cosa va esattamente nel campo URL Proxy?
https://aihubmix.com/v1/chat/completions, l'indirizzo completo. Se incolli solo https://aihubmix.com/v1, clicca il pulsante Aggiungi /chat/completions una volta per completarlo.

Perché non vedo l'opzione proxy per alcuni bot?
Solo i bot contrassegnati come "proxy consentito" funzionano con un proxy. Altri bot rimangono sul modello di JanitorAI.

Quale ID modello dovrei iniziare a utilizzare?
Qualsiasi ID dalla lista dei modelli gratuiti funziona se copiato esattamente. Molti utenti di JanitorAI iniziano con xiaomi-mimo-v2.6-pro-free; la guida ai modelli in questa serie confronta le alternative.

Devo aggiornare dopo aver cambiato il modello?
Sì. Salva la configurazione, poi aggiorna la pagina o riavvia la chat affinché JanitorAI prenda il cambiamento.

Perché continuo a ricevere errori 429?
O hai superato un limite per minuto o per giorno, o il modello è occupato. Aspetta un minuto, rallenta, o passa a un'altra configurazione salvata con un modello diverso.

Posso condividere la mia chiave API con gli amici?
No. I Termini di Servizio vietano la condivisione di un account AIHubMix, e chiunque utilizzi la tua chiave spende la tua quota giornaliera.

Continua a leggere: la serie AIHubMix per JanitorAI

• La tua configurazione funziona, ma quanti messaggi ti darà effettivamente al giorno? La matematica dei token è qui: Limiti dei modelli gratuiti di AIHubMix per JanitorAI: 10 chiamate di prova, il sblocco di $1 e il limite di token
• Se l'avviso di prova è già apparso nella tua chat, questa guida illustra come sbloccare le quote giornaliere: Come pagare su AIHubMix con Alipay
• Non sei sicuro che l'ID modello che hai incollato sia quello giusto per il gioco di ruolo? Confronta le opzioni gratuite: Quale modello gratuito di AIHubMix utilizzare per il gioco di ruolo in JanitorAI
• Prima della tua prima lunga chat, scopri come la zero retention dei dati impedisce che i tuoi messaggi vengano memorizzati su AIHubMix: AIHubMix supporta la chat di gioco di ruolo di JanitorAI, con zero retention dei dati attivata per impostazione predefinita

Fonti

• Modelli AI gratuiti (AIHubMix)
• Guida rapida (Documenti AIHubMix)
• Changelog (Documenti AIHubMix)
• custom-proxy-for-janitorai (GitHub)
• Impostazioni di generazione di Janitor AI (2026) (Arcanum RPGs)