Un proxy Janitor AI n’est généralement ni un VPN ni un outil destiné à masquer votre adresse IP. Il s’agit d’une route vers une API de LLM : pour fonctionner, l’endpoint, l’ID exact du modèle et la clé API doivent provenir du même fournisseur. Avec un reverse proxy, vous ajoutez aussi un serveur intermédiaire et une décision de confiance supplémentaire.
Choisir sa route avant de configurer Janitor AI
Dans la plupart des cas, l’option la plus simple consiste à relier Janitor AI directement à une API compatible OpenAI. Un agrégateur tel qu’OpenRouter convient si vous voulez accéder à plusieurs modèles depuis un seul compte. Le reverse proxy, lui, se justifie surtout si vous administrez vous-même le relais ou devez adapter un backend privé ou local.
| Route | Cheminement de la requête | Qui traite la requête ? | Complexité de configuration | Bon point de départ ? |
|---|---|---|---|---|
| API directe | Janitor AI → fournisseur ou passerelle | L’opérateur de l’endpoint et son fournisseur de modèle en amont | Faible | Oui, pour une API externe classique |
| Agrégateur | Janitor AI → agrégateur de modèles → modèle sélectionné | L’agrégateur et son fournisseur en amont | Faible à moyenne | Oui, si vous avez besoin de choisir parmi plusieurs modèles |
| Reverse proxy | Janitor AI → votre relais → fournisseur ou modèle local | Vous, l’hébergeur du relais et le fournisseur en amont | Moyenne à élevée | Seulement si vous contrôlez le relais |
Ne confondez pas un « proxy gratuit » partagé avec une connexion API directe. Un relais partagé peut lire le trafic qui le traverse, disparaître sans prévenir ou réclamer des identifiants qu’il ne devrait jamais recevoir. Utiliser la clé d’un fournisseur avec l’endpoint de ce même fournisseur est une situation très différente.
À quoi correspondent vraiment les champs Proxy de Janitor AI
Dans le formulaire Proxy de Janitor AI, trois valeurs doivent toujours correspondre à la même route : l’URL de l’endpoint, l’ID exact du modèle et la clé API. Elles doivent venir du même fournisseur ou du même relais.
| Champ Janitor AI | Valeur à saisir | Erreur fréquente |
|---|---|---|
| Configuration Name | Le libellé de votre choix, par exemple AIReiter GPT-5.6 Luna | Modifier ce libellé ne change pas le modèle utilisé |
| Model Name | L’ID exact et actuel du modèle chez le fournisseur | Un nom commercial, une différence de casse ou un suffixe :free obsolète peut provoquer une erreur de modèle |
| Other API/Proxy URL | Le format d’endpoint attendu pour cette route | Une URL de base peut être acceptée par un SDK, mais pas par le champ proxy de Janitor AI |
| API Key | Une clé créée pour cet endpoint ou ce relais précis | Une clé d’un autre fournisseur, révoquée ou contenant un espace supplémentaire échouera |
L’URL complète de la requête et l’URL de base d’un SDK ne sont pas toujours interchangeables. Un SDK compatible OpenAI utilise couramment une base telle que https://example.com/api/v1, puis ajoute lui-même /chat/completions. Le champ proxy de Janitor AI peut, lui, exiger l’URL finale, https://example.com/api/v1/chat/completions. Suivez donc les consignes propres au client indiquées par l’endpoint.
Janitor AI propose également une autorisation de proxy au niveau du personnage. Dans une annonce officielle d’un modérateur, Janitor AI explique que l’option Allow Proxy permet d’utiliser un bot via des proxies, car le proxy reçoit les informations du bot. Un personnage limité aux options OpenAI et JanitorAI ne peut pas être utilisé via un proxy externe. Cette autorisation est indépendante de la validité de votre clé API.
Configurer Janitor AI en cinq minutes
Créez une configuration, enregistrez-la, actualisez la page puis faites un essai avec un message court. Cette méthode permet d’isoler rapidement une erreur d’endpoint, d’ID de modèle ou de clé.
1. Créer une clé chez le fournisseur
Créez une clé API auprès du fournisseur ou de la passerelle dont vous allez coller l’URL dans Janitor AI. Copiez-la au moment où le service l’affiche, conservez-la comme un secret et ne la publiez jamais dans des captures d’écran, messages Discord, extensions de navigateur ou formulaires de proxy partagés.
Un modèle marqué comme gratuit peut tout de même exiger une clé fournisseur. « Gratuit » décrit généralement le tarif ou le quota actuel de ce modèle chez ce fournisseur ; cela ne signifie pas que Janitor AI peut l’appeler sans authentification.
2. Ouvrir le panneau Proxy
Ouvrez une conversation avec un personnage dans Janitor AI, puis recherchez API Settings. Sélectionnez Proxy, puis Add Configuration ou le contrôle équivalent. Consultez les pages officielles du Help Center de Janitor AI consacrées au compte et à la configuration pour les indications produit à jour : les libellés et leur emplacement peuvent évoluer.
Des utilisateurs signalent que certains champs et la saisie obligatoire du modèle ont changé dans l’interface proxy de Janitor AI. (Exemple de retour utilisateur)
3. Saisir les valeurs, enregistrer, actualiser et tester
Renseignez uniquement des valeurs fournies par une même route. Ne mélangez pas l’endpoint d’un service, l’ID de modèle copié depuis un autre et une clé issue d’un troisième compte.
- Donnez un nom facilement reconnaissable à la configuration.
- Collez l’ID exact du modèle depuis la page du modèle ou la liste de modèles en direct du fournisseur.
- Collez l’endpoint complet attendu par le champ proxy de Janitor AI.
- Collez la clé API correspondante.
- Enregistrez la configuration.
- Actualisez ou rouvrez l’onglet Janitor AI, puis envoyez un court message de test.
Si le personnage n’est pas autorisé à utiliser un proxy, basculez vers un personnage qui l’accepte avant de diagnostiquer l’endpoint. Une configuration fournisseur valide ne peut pas contourner la restriction définie par le créateur.
Configurer AIReiter : une route compatible OpenAI vérifiée
Avec AIReiter, saisissez l’URL finale Chat Completions dans le champ Proxy URL de Janitor AI, et non l’URL de base plus courte destinée au SDK. Le guide d’intégration GPT-5.6 d’AIReiter indique l’endpoint Chat Completions /api/v1/chat/completions, donne gpt-5.6-luna comme exemple de modèle et distingue l’URL de base client du chemin ajouté par le client.
Utilisez cette configuration comme point de départ :
| Champ Janitor AI | Valeur 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 | Votre clé API AIReiter |
La différence entre les endpoints est la suivante :
- Proxy URL Janitor AI :
https://aireiter.com/api/v1/chat/completions - URL de base du SDK compatible OpenAI :
https://aireiter.com/api/v1 - Vérification de la liste des modèles :
https://aireiter.com/api/v1/models
Ne collez pas /api/v1/models dans Janitor AI : c’est une route de diagnostic permettant de vérifier la disponibilité de l’ID du modèle. Le guide AIReiter propose ce contrôle :
curl -sS "https://aireiter.com/api/v1/models" \
-H "Authorization: Bearer $AIREITER_API_KEY"
Si la réponse ne contient pas gpt-5.6-luna, utilisez l’ID exact renvoyé par la liste et mettez à jour la configuration Janitor AI. Lors d’un test lié à l’ID du modèle, laissez l’endpoint et la clé inchangés.
AIReiter fonctionne avec une facturation à l’usage plutôt qu’avec un niveau d’abonnement : la clé API doit donc être associée à un compte disposant d’un solde utilisable. Consultez la page tarifaire actuelle d’AIReiter avant de vous fier à un tarif affiché ; le coût d’une conversation dépend des tokens en entrée et en sortie, pas seulement du nombre de messages.
OpenRouter et les autres fournisseurs : adapter la même configuration
Le formulaire Janitor AI ne change pas lorsque vous passez à un autre fournisseur, mais l’endpoint, la clé et l’ID du modèle doivent être modifiés ensemble. Le quickstart officiel d’OpenRouter documente son API compatible OpenAI, tandis que son catalogue de modèles actuel est l’endroit où récupérer un ID de modèle valide.
| Champ | Modèle OpenRouter |
|---|---|
| Model Name | Copiez l’ID exact et actuel depuis le catalogue de modèles d’OpenRouter |
| Other API/Proxy URL | https://openrouter.ai/api/v1/chat/completions |
| API Key | Une clé créée dans votre compte OpenRouter |
Considérez un suffixe de modèle tel que :free comme un indicateur de disponibilité en temps réel, pas comme une donnée de configuration permanente. Les modèles gratuits peuvent être retirés, limités en débit ou renommés ; copiez l’ID actuel juste avant d’enregistrer la configuration Janitor AI.
Un fil officiel d’un modérateur Janitor AI renvoie vers les ressources de démarrage rapide et de dépannage consacrées au proxy/OpenRouter, tout en distinguant les problèmes d’intégration Janitor des questions de facturation ou de compte chez le fournisseur. Pour une connexion directe à un fournisseur, remplacez les trois valeurs propres à la route par son endpoint, sa clé et son ID de modèle.
API directe ou reverse proxy : le choix de sécurité
Une connexion directe comporte le moins d’intermédiaires : le fournisseur ou la passerelle gère l’authentification, les limites, la facturation, la journalisation et sa politique de confidentialité. Un reverse proxy ajoute un relais pouvant inspecter, modifier, journaliser ou rejeter le trafic avant son arrivée au modèle en amont.
N’utilisez un reverse proxy que si vous avez une raison de l’exploiter, par exemple pour connecter un backend privé au travers d’un relais HTTPS authentifié ou pour normaliser le protocole d’un fournisseur. Une URL localhost privée ne fonctionne que si le composant qui émet la requête s’exécute sur la même machine ; si la requête est faite par le serveur de Janitor AI, ce serveur ne peut pas atteindre le localhost de votre ordinateur. Lorsque cette architecture est nécessaire, utilisez un relais HTTPS public correctement authentifié.
Si vous contrôlez le relais, appliquez cette liste de vérification :
- Imposez HTTPS et un jeton d’authentification distinct pour le relais.
- Conservez la clé du fournisseur en amont sur le relais plutôt que de la coller dans un service partagé inconnu.
- Désactivez les logs détaillés des corps de requête, ou définissez une durée de rétention courte et documentée.
- Limitez les hôtes en amont et les méthodes de requête autorisés.
- Vérifiez si le relais transmet les en-têtes, l’historique des conversations et les données des personnages.
- Révoquez et remplacez les identifiants en cas de suspicion d’exposition.
Un avertissement d’utilisateur réel illustre pourquoi les relais anonymes méritent une attention particulière :
« 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, avertissement d’utilisateur sur X, juin 2023 (source)
Il s’agit d’un incident rapporté par un utilisateur, et non d’une preuve que tous les reverse proxies sont malveillants. Ne transmettez pas une vraie clé fournisseur ni une conversation privée à un relais dont vous ne pouvez pas vérifier l’opérateur, la rétention des données et l’historique d’incidents.
Diagnostiquer les erreurs selon l’étape en échec
La plupart des erreurs de proxy Janitor AI deviennent plus simples à isoler lorsque vous testez la route par couches. Vérifiez d’abord que le modèle intégré de Janitor AI répond, puis contrôlez les valeurs de configuration une par une avant d’enquêter sur les quotas ou une panne côté fournisseur.
| Symptôme ou statut | Couche probablement concernée | Premier contrôle |
|---|---|---|
400 ou « invalid model » | Requête ou sélection du modèle | Copiez l’ID actuel exact du modèle ; vérifiez la casse, le préfixe fournisseur et les éventuels suffixes |
401 Unauthorized | Authentification | Révoquez une clé douteuse, créez-en une nouvelle, retirez les espaces et vérifiez qu’elle appartient au fournisseur de l’endpoint |
402 ou message de paiement/quota | Solde ou droit d’accès du compte | Vérifiez le crédit, l’état de la facturation et l’allocation gratuite actuelle du fournisseur |
404 ou « model not found » | URL ou route du modèle | Comparez le chemin complet de l’endpoint et l’ID du modèle avec la documentation actuelle du fournisseur |
429 | Limite de débit ou d’utilisation | Attendez, réduisez la fréquence des requêtes, passez à un modèle disponible ou ajoutez du solde si nécessaire |
500, 502, 503 ou expiration du délai | Disponibilité du fournisseur en amont ou du relais | Réessayez plus tard, vérifiez le statut du fournisseur et testez sans relais personnalisé si possible |
| « Failed to fetch » ou erreur réseau | Navigateur, endpoint, CORS ou relais inaccessible | Revérifiez HTTPS, l’URL complète et l’accessibilité publique du relais |
La signification des codes de statut varie selon le fournisseur : le corps de la réponse constitue donc un indice plus prioritaire. Une erreur de nom de modèle ne se corrige pas en régénérant la clé, et une clé révoquée ne se répare pas en modifiant la température.
Les retours de la communauté montrent pourquoi les ID de modèles doivent être vérifiés régulièrement. Dans un fil pour débutants de Janitor AI, u/Puzzleheaded-Town350 a écrit :
« I get this message ‘proxy error 400 open-mistral-nemo-2407 is not a valid model’ » — u/Puzzleheaded-Town350 dans r/JanitorAI_Official
Lorsqu’une nouvelle configuration échoue, procédez dans cet ordre :
- Testez le modèle intégré de Janitor AI afin de distinguer un problème de plateforme d’un problème de proxy.
- Vérifiez que le personnage autorise les proxies.
- Vérifiez l’URL finale de l’endpoint, y compris
/chat/completionslorsque la route l’exige. - Vérifiez l’ID exact du modèle dans la liste en direct du fournisseur.
- Vérifiez que la clé correspond à l’endpoint et qu’elle dispose toujours des autorisations ou du solde nécessaires.
- Réessayez avec les paramètres de génération par défaut avant de modifier la température ou les limites de tokens.
Confidentialité et hygiène du compte
L’endpoint peut recevoir vos prompts, l’historique des conversations, les données de sélection de modèle et parfois les informations du personnage. Consultez les conditions de confidentialité et les réglages de rétention du fournisseur direct, de l’agrégateur ou du relais que vous choisissez.
Si une clé a pu être exposée, révoquez-la, créez-en une nouvelle, supprimez l’ancienne valeur des configurations Janitor AI et consultez l’historique d’utilisation. Ne testez pas une clé divulguée en continuant à l’utiliser.
FAQ sur les proxies Janitor AI
Un proxy Janitor AI est-il un VPN ?
Non. Il achemine les requêtes de conversation vers un LLM externe ; un VPN modifie le routage réseau et ne fournit pas de modèle de langage.
Faut-il une clé API pour un modèle gratuit ?
En général, oui. Un fournisseur peut ne rien facturer pour un modèle ou un quota tout en exigeant une clé propre à votre compte.
Dois-je coller l’URL complète ou seulement /api/v1 ?
Utilisez l’URL finale attendue par le champ Proxy de Janitor AI. Dans l’exemple AIReiter, il s’agit de https://aireiter.com/api/v1/chat/completions ; /api/v1 est l’URL de base du SDK.
Pourquoi un personnage refuse-t-il de fonctionner avec un proxy ?
Le créateur du personnage a peut-être désactivé l’usage des proxies. Une clé externe valide ne peut pas outrepasser ce réglage.
Janitor AI peut-il appeler directement localhost ?
Uniquement si le composant qui émet la requête s’exécute sur la même machine que le serveur local. Sinon, utilisez un relais HTTPS public correctement sécurisé plutôt que d’exposer un service local non authentifié.
Pourquoi un ID de modèle qui fonctionnait auparavant ne marche-t-il plus ?
Les fournisseurs modifient la disponibilité des modèles, les alias, les quotas et les libellés des offres gratuites. Consultez à nouveau la liste de modèles en direct et mettez d’abord à jour le champ du modèle.
Un proxy gratuit partagé est-il sûr ?
Ne le présumez pas. Son opérateur peut potentiellement lire les requêtes ou capturer des identifiants ; privilégiez une route directe vers le fournisseur ou un reverse proxy que vous exploitez et pouvez auditer.
Commencez avec une clé privée, un ID de modèle exact et un endpoint complet. La configuration par API directe reste la plus simple ; un reverse proxy ne mérite sa maintenance que si vous devez contrôler le relais ou la connexion en amont.