Comment utiliser les modèles gratuits d'AIHubMix dans JanitorAI : configuration du proxy et erreurs courantes

JanitorAI peut communiquer avec n'importe quelle API compatible OpenAI grâce à son option Proxy, et AIHubMix en fait partie. La configuration complète nécessite quatre valeurs saisies dans un seul formulaire :

Nom :       tout ce que vous voulez, par exemple AIHubMix MiMo
URL du proxy :  https://aihubmix.com/v1/chat/completions
Clé API :    votre clé AIHubMix
Modèle :      xiaomi-mimo-v2.6-pro-free

Laissez le prompt personnalisé vide, appuyez sur Tester, puis sur Ajouter, et rafraîchissez la page. C'est tout.

La plupart des échecs signalés dans la communauté JanitorAI proviennent d'un des quatre champs étant légèrement incorrect, ou de l'épuisement prématuré du niveau gratuit. Ce guide passe en revue la configuration une fois, puis couvre chaque erreur que vous êtes susceptible de rencontrer et comment y remédier.

Avant de commencer

Vous avez besoin de trois choses :

Un compte AIHubMix et une clé API. Inscrivez-vous, puis créez une clé sur la page de clé API AIHubMix. Copiez-la immédiatement dans un endroit sûr.
Un bot qui autorise les proxies. Un proxy ne fonctionne qu'avec des bots qui affichent "proxy autorisé" au-dessus du sélecteur de persona ou du bouton de démarrage de chat, comme l'explique ce guide communautaire sur les proxies. Les bots avec des définitions de personnages visibles l'autorisent généralement.
Un ID de modèle. Choisissez-en un dans la liste des modèles gratuits d'AIHubMix et copiez son ID exactement. Le modèle actuellement préféré par la communauté pour le jeu de rôle est xiaomi-mimo-v2.6-pro-free; le guide des modèles dans cette série compare les options.

Une chose à savoir avant votre premier message : un nouveau compte obtient 10 appels d'essai au total, partagés entre tous les modèles gratuits. Après un rechargement unique de 1 $ ou plus, le compte passe à des quotas quotidiens (100 requêtes par jour, 10 par minute, 1M tokens par jour). Le guide des limites dans cette série explique jusqu'où cela va dans une longue conversation.

Les quatre valeurs, et où les gens se trompent

Champ	Ce qu'il faut entrer	Erreur courante
Nom	N'importe quelle étiquette	Aucune, c'est juste pour vous
URL du proxy	L'URL complète des complétions de chat	Coller seulement l'URL de base
Clé API	Votre clé AIHubMix	Une clé d'un autre fournisseur
Modèle	L'ID de modèle exact	Utiliser le nom d'affichage à la place

L'ID de modèle va dans le champ Modèle. Il est en minuscules et conserve son suffixe -free. "Xiaomi Mimo V2.6 Pro (gratuit)" est le nom d'affichage et ne fonctionnera pas ; xiaomi-mimo-v2.6-pro-free fonctionnera.

À côté de l'étiquette URL du proxy, il y a un bouton Ajouter /chat/completions. Il n'ajoute que /chat/completions à ce qui est déjà dans le champ. Si vous avez collé l'URL complète ci-dessus, ne cliquez pas dessus, sinon le chemin se retrouvera deux fois. Si vous avez collé https://aihubmix.com/v1, un clic le complétera.

Le champ de clé API indique "(optionnel)". Remplissez-le quand même : sans clé, chaque requête est rejetée.

Le prompt personnalisé remplace le prompt système pour ce proxy et est envoyé en haut de chaque requête tant que le proxy est actif. AIHubMix n'en a pas besoin, donc laissez-le vide.

Configurez-le dans JanitorAI

JanitorAI a redessiné ses paramètres de chat le 19 juillet 2026, donc les vidéos plus anciennes montrent des écrans différents. Les étapes ci-dessous ont été vérifiées par rapport à la version web actuelle en octobre 2026 :

Ouvrez un chat avec un bot autorisant le proxy.
Ouvrez le menu en haut à droite et choisissez Paramètres.
Sous Fournisseur, choisissez Proxy.
Sous Configurations de proxy, cliquez sur + Nouveau.
Dans le formulaire Nouvelle configuration, remplissez Nom, URL du proxy, Clé API et Modèle avec les valeurs ci-dessus. Laissez Prompt personnalisé vide.
Cliquez sur Tester. Si la configuration fonctionne, rien ne s'affiche ; un message apparaît seulement lorsqu'il y a un problème.
Cliquez sur Ajouter, puis rafraîchissez la page ou redémarrez le chat.

Le rafraîchissement à l'étape 7 est l'étape que les gens sautent le plus. Tant que la page ne se recharge pas, JanitorAI peut continuer à envoyer des messages via l'ancienne configuration.

Vous pouvez enregistrer plusieurs configurations, par exemple une par modèle, ce qui rend le changement rapide lorsque un modèle est occupé. Pour ajouter une sauvegarde, ouvrez une configuration enregistrée, cliquez sur Dupliquer, et changez uniquement le champ Modèle.

Paramètres pour votre premier chat

Ouvrez le menu → Paramètres à nouveau et regardez les contrôles de génération. Deux d'entre eux sont importants pour un premier essai, selon le guide d'Arcanum RPGs sur le panneau actuel :

Taille du contexte. Avec un modèle externe, le curseur va jusqu'à 128 000 tokens. Commencez entre 16 000 et 32 000. L'info-bulle de JanitorAI dit de la réduire si les réponses ne se génèrent pas.
Max tokens. 0 laisse le modèle choisir la longueur de la réponse. Tout autre nombre est un arrêt net, donc une valeur basse peut couper les réponses en plein milieu d'une phrase.

Appuyez sur Enregistrer ; rien ne s'applique tant que vous ne le faites pas.

La taille du contexte est importante pour plus que la qualité. Chaque tour renvoie tout le contexte à nouveau, et tous les modèles gratuits partagent un pool de 1M tokens par jour. Une fois qu'une conversation remplit un contexte de 32 000 tokens, ce pool couvre environ 30 réponses, bien en dessous du plafond de 100 requêtes. Le guide des limites dans cette série passe en revue les chiffres.

Optionnel : testez votre clé en dehors de JanitorAI

Si vous êtes à l'aise avec un terminal, cette requête sépare "ma clé est incorrecte" de "ma configuration JanitorAI est incorrecte". Elle utilise le même point de terminaison que le démarrage rapide d'AIHubMix documente, et utilise une requête (un de vos 10 appels d'essai si vous n'avez pas rechargé).

export AIHUBMIX_API_KEY="collez-votre-clé-ici"

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": "Dites bonjour en cinq mots."}]}'

Une réponse avec du texte signifie que la clé et l'ID du modèle sont corrects, et que le problème se trouve dans les champs de JanitorAI ou le rafraîchissement manquant.

Erreurs courantes et comment les corriger

"Erreur réseau" ou "Échec de la récupération"

Le test affiche "Erreur réseau. Réessayez plus tard !", ou le chat montre "Une erreur réseau s'est produite, vous êtes peut-être limité par le taux ou avez des problèmes de connexion : Échec de la récupération".

Pourquoi : La requête n'a jamais atteint AIHubMix, ou la réponse n'est jamais revenue à votre navigateur. Malgré le libellé, "Échec de la récupération" indique un problème de connexion, pas un quota. La cause habituelle est un VPN ou un proxy qui bloque ou redirige mal aihubmix.com ; une extension de navigateur qui filtre les requêtes peut faire de même. Dans le test d'AIHubMix de ce guide, un VPN était la cause.
Correction : Désactivez le VPN, changez de serveur, ou assurez-vous qu'il laisse passer aihubmix.com. Mettez en pause les extensions de blocage de publicité ou de confidentialité sur janitorai.com. Ensuite, appuyez à nouveau sur Tester.

Le test affiche une erreur, ou le bot ne répond jamais

Pourquoi : L'URL du proxy est incomplète (URL de base ou page d'accueil seulement), contient une faute de frappe, ou se termine par /chat/completions deux fois parce que le bouton Ajouter /chat/completions a été cliqué après avoir collé l'URL complète. AIHubMix répond à un mauvais chemin par "Le point de terminaison API demandé n'existe pas."
Correction : Collez https://aihubmix.com/v1/chat/completions exactement, sans espace à la fin.

"Modèle non trouvé" ou une erreur de modèle

Pourquoi : Le champ Modèle contient un nom d'affichage, a une lettre majuscule, ou a perdu son suffixe -free.
Correction : Copiez à nouveau l'ID de la liste des modèles gratuits et collez-le tel quel.

"Clé invalide" ou une erreur d'authentification

Pourquoi : La clé appartient à un autre service, a été supprimée, contient un espace superflu, ou le champ est vide. AIHubMix renvoie "aucune clé fournie" pour une clé vide et "clé invalide" pour une clé incorrecte.
Correction : Créez une nouvelle clé sur la page de clé AIHubMix et collez-la à nouveau.

Vous avez changé les paramètres mais rien n'a changé

Pourquoi : JanitorAI utilise toujours la configuration qu'il a chargée auparavant.
Correction : Rafraîchissez la page ou redémarrez le chat, et vérifiez que la bonne configuration est sélectionnée.

La "réponse" du bot est un avis que votre essai est épuisé

Pourquoi : Les 10 appels d'essai sont épuisés. AIHubMix continue de répondre avec une note au lieu d'une erreur, donc dans JanitorAI, cela apparaît probablement comme un message dans le chat.
Correction : Rechargez 1 $ ou plus une fois ; le compte passe à des quotas quotidiens pour les modèles gratuits. Le guide de rechargement dans cette série couvre les étapes.

Erreur 429

Une 429 a deux causes courantes :

Vous avez atteint un plafond. Au-delà de votre limite par minute ou par jour, l'API renvoie 429 jusqu'à ce que la minute ou le jour suivant commence. Certains modèles ont des plafonds plus bas que les 100 par jour et 10 par minute standard (par exemple, qwen3.6-plus-preview-free autorise 50 par jour et 5 par minute), et le pool partagé de 1M tokens peut s'épuiser en premier dans de longues conversations.
Le modèle est occupé. La capacité gratuite sur certains modèles est limitée, et le journal des modifications d'AIHubMix a averti que des erreurs 429 "peuvent survenir" sur un modèle gratuit pour cette raison. Lorsque de nombreuses personnes se connectent à un modèle populaire en même temps, c'est généralement la cause.

Correction : Attendez une minute et réessayez, envoyez des messages moins souvent, ou passez à une deuxième configuration enregistrée avec un modèle différent. Si le plafond quotidien est le problème, le quota se réinitialise une fois par jour.

Une 404 qui mentionne model_retired

Pourquoi : Le modèle a été retiré. Depuis le 1er septembre 2026, les modèles retirés renvoient un explicite model_retired 404.
Correction : Choisissez un autre modèle dans la liste gratuite et mettez à jour le champ Modèle.

Les modèles gratuits ont cessé de fonctionner après que vous ayez utilisé des modèles payants

Pourquoi : Lorsque le solde d'un compte tombe en dessous de -1 $, les modèles gratuits ne peuvent pas être appelés jusqu'à ce que le compte soit rechargé à nouveau.
Correction : Rechargez pour ramener le solde au-dessus de cette limite.

Toujours bloqué ?

La page de contact d'AIHubMix répertorie le serveur Discord officiel, l'email de support (feedback@aihubmix.com), et la page de statut. La page de statut suit les services tels que les complétions de chat, pas les modèles individuels, donc un modèle occupé n'y apparaîtra pas.

Pour obtenir une réponse rapide, incluez :

l'heure de la requête et votre fuseau horaire
l'ID du modèle et le point de terminaison (l'URL du proxy)
le statut HTTP ou le texte d'erreur, et un ID de trace si un a été affiché
ce que vous attendiez et ce qui s'est passé à la place

Ne laissez pas votre clé API. Le support n'en a pas besoin, et quiconque l'a peut dépenser votre quota.

FAQ

AIHubMix est-il gratuit à utiliser dans JanitorAI ?
Chaque nouveau compte obtient 10 appels d'essai sur tous les modèles gratuits. Après un rechargement unique de 1 $ ou plus, les modèles gratuits passent à des quotas quotidiens : 100 requêtes par jour, 10 par minute, et 1M tokens par jour partagés entre eux.

Que doit-on exactement mettre dans le champ URL du proxy ?
https://aihubmix.com/v1/chat/completions, l'adresse complète. Si vous collez seulement https://aihubmix.com/v1, cliquez sur le bouton Ajouter /chat/completions une fois pour le compléter.

Pourquoi ne vois-je pas l'option proxy pour certains bots ?
Seuls les bots marqués "proxy autorisé" fonctionnent avec un proxy. Les autres bots restent sur le modèle propre à JanitorAI.

Quel ID de modèle devrais-je commencer à utiliser ?
Tout ID de la liste des modèles gratuits fonctionne s'il est copié exactement. De nombreux utilisateurs de JanitorAI commencent avec xiaomi-mimo-v2.6-pro-free ; le guide des modèles dans cette série compare les alternatives.

Dois-je rafraîchir après avoir changé de modèle ?
Oui. Enregistrez la configuration, puis rafraîchissez la page ou redémarrez le chat pour que JanitorAI prenne en compte le changement.

Pourquoi reçois-je toujours des erreurs 429 ?
Soit vous avez dépassé un plafond par minute ou par jour, soit le modèle est occupé. Attendez une minute, ralentissez, ou passez à une autre configuration enregistrée avec un modèle différent.

Puis-je partager ma clé API avec des amis ?
Non. Les conditions de service interdisent le partage d'un compte AIHubMix, et quiconque utilisant votre clé dépense votre quota quotidien.

Continuez à lire : la série AIHubMix pour JanitorAI

Votre configuration fonctionne, mais combien de messages vous donnera-t-elle réellement par jour ? Les calculs des tokens sont ici : Limites des modèles gratuits d'AIHubMix pour JanitorAI : 10 appels d'essai, le déverrouillage à 1 $, et le plafond de tokens
Si l'avis d'essai est déjà apparu dans votre chat, cela explique comment déverrouiller les quotas quotidiens : Comment payer sur AIHubMix avec Alipay
Vous n'êtes pas sûr que l'ID de modèle que vous avez collé soit le bon pour le jeu de rôle ? Comparez les options gratuites : Quel modèle gratuit d'AIHubMix utiliser pour le jeu de rôle dans JanitorAI
Avant votre première longue conversation, voyez comment la non-rétention des données empêche vos messages d'être stockés sur AIHubMix : AIHubMix prend en charge le chat de jeu de rôle JanitorAI, avec une non-rétention des données activée par défaut

Sources

Modèles AI gratuits (AIHubMix)
Démarrage rapide (Docs AIHubMix)
Journal des modifications (Docs AIHubMix)
custom-proxy-for-janitorai (GitHub)
Paramètres de génération de Janitor AI (2026) (Arcanum RPGs)