Configuration proxy Janitor AI : format URL, modèles et corrections 429

Réponse rapide : les trois champs demandés par JanitorAI

La configuration proxy de JanitorAI prend exactement trois valeurs : une URL de proxy, un nom de modèle, et une clé API. L'URL du proxy doit être l'endpoint complet de chat completions, pas une URL de base. Si votre fournisseur vous donne une URL de base se terminant en /v1, ajoutez /chat/completions avant de la coller dans JanitorAI. Ce seul détail cause plus d'échecs de configuration que tout le reste combiné. Saisissez l'ID du modèle exactement comme le fournisseur l'écrit, en minuscules avec les tirets inclus, puis sauvegardez et envoyez un court message de test. Si une réponse revient, c'est fait. Si vous obtenez un code d'erreur à la place, passez au tableau d'erreurs ci-dessous. Chaque code courant a une cause spécifique et une correction spécifique.

Proxy URL:  https://api.apisrouter.com/v1/chat/completions
Model:      deepseek-v4-flash
API Key:    sk-...   (collez exactement, sans guillemets, sans espaces en fin)

Ce que « proxy » signifie dans la communauté JanitorAI

Le mot est trompeur. Dans le jargon JanitorAI, un proxy n'est pas un proxy réseau ou un VPN. C'est n'importe quel endpoint API compatible OpenAI vers lequel le site envoie vos requêtes de chat au lieu de son backend par défaut. La communauté a adopté ce terme il y a des années quand les gens ont commencé à router les chats via des proxys inverses d'API de fournisseurs, et le nom est resté même si la plupart des configs aujourd'hui parlent directement à un fournisseur ou une passerelle. Les gens font tourner un proxy pour trois raisons. D'abord, le choix du modèle : vous choisissez exactement quel LLM écrit vos personnages au lieu d'accepter ce que le site propose par défaut. Ensuite, la qualité : des modèles comme DeepSeek V4 ou Claude écrivent des scènes plus longues et plus cohérentes qu'un niveau intégré gratuit. Enfin, le contrôle des coûts : avec une clé payante au token, vous voyez exactement ce que coûte chaque chat au lieu de payer pour un abonnement que vous n'utilisez peut-être pas entièrement. Il existe trois types d'endpoints que vous verrez partagés dans la communauté. Les API officielles des fournisseurs (OpenAI, Anthropic, xAI, DeepSeek) nécessitent un compte chez chaque vendeur. Les passerelles agrègent de nombreux modèles derrière une URL compatible OpenAI et une clé. Les « proxys gratuits » communautaires sont des clés partagées que quelqu'un d'autre paie, ce qui explique pourquoi ils sont instables et fortement limités en débit. Une dernière chose à dire clairement : quel que soit l'endpoint utilisé, la politique de contenu du fournisseur du modèle en amont s'applique toujours à chaque réponse, et les propres conditions de JanitorAI, y compris son exigence réservée aux adultes, régissent toujours la plateforme. Connaître les deux politiques avant de choisir un modèle vous évite des refus en pleine scène.

Configuration complète : de la clé API à la première réponse

Si vous voulez une seule clé qui couvre DeepSeek, GLM, Kimi, Claude, Gemini et Grok à la fois, une passerelle compatible OpenAI comme APIsRouter est la voie à faible friction : le paiement sur /topup ne nécessite pas d'inscription de compte, la clé arrive par e-mail, et l'URL de proxy pour JanitorAI est https://api.apisrouter.com/v1/chat/completions. Une nuance si vous utilisez aussi SillyTavern : SillyTavern veut l'URL de base se terminant à /v1 et remplit automatiquement sa liste de modèles depuis /v1/models avec votre clé, tandis que JanitorAI veut le chemin complet incluant /chat/completions. Même endpoint, portion d'URL différente. Confondre les deux formats est la cause principale des erreurs 404 dans les deux apps.

• Obtenez une clé API auprès d'un fournisseur ou d'une passerelle compatible OpenAI. Vous avez besoin de la chaîne de clé et de l'URL d'endpoint documentée.
• Ouvrez n'importe quel chat de personnage sur JanitorAI, puis ouvrez API Settings et sélectionnez l'option Proxy.
• Collez l'URL complète de l'endpoint se terminant en /chat/completions dans le champ de l'URL du proxy.
• Tapez l'ID du modèle exactement comme documenté, par exemple deepseek-v4-flash ou glm-5.
• Collez la clé API, sauvegardez les réglages, et rafraîchissez la page si la sauvegarde ne s'enregistre pas.
• Envoyez un message de test d'une ligne. Une réponse normale signifie que toute la chaîne fonctionne.

Testez l'endpoint avec curl avant de blâmer JanitorAI

Quand un proxy se comporte mal, testez l'endpoint en dehors de JanitorAI d'abord. Un appel curl de 10 secondes vous dit si le problème est l'endpoint, la clé, ou la façon dont vous avez configuré le site. Exécutez ceci dans n'importe quel terminal, avec votre propre clé et modèle :

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."}]
  }'

Erreur 429 : pourquoi les proxys gratuits limitent le débit aux heures de pointe

Une réponse 429 signifie « trop de requêtes ». C'est de loin l'erreur de proxy la plus rapportée dans la communauté JanitorAI, et le schéma derrière est prévisible. Un proxy gratuit ou partagé est une seule clé API servant des centaines ou des milliers d'utilisateurs. Les fournisseurs appliquent des limites par clé sur les requêtes par minute et les tokens par minute, donc quand le trafic du soir aux États-Unis culmine, tout le monde passe par le même quota et la clé commence à rejeter les requêtes. Vous n'êtes pas visé personnellement. Le seau est simplement vide, et il se remplit le plus lentement exactement quand le plus de gens veulent discuter. Les proxys gratuits ont un second mode de défaillance : la clé elle-même meurt. Les clés partagées se font révoquer pour violation de politique ou solde épuisé, moment auquel la même URL commence à renvoyer 401 ou 404 à la place, souvent sans annonce. Les endpoints payants évitent structurellement le mur des heures de pointe. Votre clé a son propre quota au lieu de partager un seul seau avec une foule, la facturation est au token donc le fournisseur n'a aucune raison de vous freiner vers un niveau d'abonnement, et la capacité est provisionnée pour le trafic payant. Si vous voyez un 429 sur une clé personnelle payante, c'est presque toujours une limite de rafale courte : attendez quelques secondes et réessayez, ou ralentissez les régénérations rapides. Des 429 persistants sur une clé personnelle méritent un ticket de support, pas un contournement.

Tableau des erreurs de proxy JanitorAI : 429, 401, 404, timeout

Faites correspondre le code que JanitorAI vous affiche à ce tableau. La colonne correction suppose que vous avez déjà confirmé que l'endpoint fonctionne avec le test curl ci-dessus ; si curl échoue de la même manière, le problème est du côté de l'endpoint, pas dans JanitorAI.

Quel modèle faire tourner derrière votre proxy Janitor AI

Le choix du modèle compte plus que n'importe quel réglage de génération. Le consensus communautaire est stable : la famille DeepSeek V4 est le favori pour le roleplay car elle écrit des réponses longues et fidèles au personnage à des prix où le coût cesse d'être une considération. GLM-5, Kimi K2.6 et MiMo sont les choix économiques qui valent la peine d'être testés en rotation quand vous voulez une voix différente. Grok 4.5 est listé parmi les options à politique flexible car la politique publiée par xAI permet les thèmes matures dans des cadres clairement fictionnels pour les utilisateurs adultes. Claude Sonnet 4.6 écrit la prose la plus forte du catalogue et convient à l'écriture créative SFW ; la politique d'Anthropic interdit le contenu explicite, donc gardez-le sur des chats narratifs non explicites. Tous les tarifs du catalogue ci-dessous sont à la consommation sans abonnement. Les modèles globaux sont tarifés 20 % en dessous des tarifs officiels et les modèles chinois sous les prix officiels, et une première recharge double votre solde de départ.

Questions fréquentes