Comment utiliser OpenRouter sur Janitor AI : configuration du proxy

Fonctionnement de la connexion

Janitor AI est un site de chat de personnages. Outre ses options intégrées, il vous permet de brancher votre propre modèle via un paramètre API. Ce paramètre demande trois choses : une URL d'endpoint, une clé et un nom de modèle. OpenRouter convient car il expose un endpoint compatible OpenAI ; ses noms de modèles ont la forme vendor/model et sa clé provient de votre compte OpenRouter.

Les mêmes trois champs fonctionnent avec n'importe quel autre service compatible OpenAI. L'API de ce site en est un : URL de base https://api.openrouternsfw.com/v1, une clé Bearer, et l'ID du modèle uncensored. Les étapes ci-dessous couvrent donc les deux cas. Lorsqu'une étape diffère entre les deux, je le précise.

Janitor AI est un site tiers et ses menus changent. Je décris les paramètres tels qu'ils sont couramment disposés, attendez-vous donc à ce que les étiquettes diffèrent légèrement. Les valeurs sont ce qui compte.

Préparez les trois valeurs

Avant d'ouvrir Janitor AI, rassemblez ces éléments.

Champ	OpenRouter	Cette API
Endpoint	URL de style OpenAI d'OpenRouter issue de sa documentation	https://api.openrouternsfw.com/v1/chat/completions
Clé	Clé depuis votre compte OpenRouter	Clé depuis la page clé API
Nom du modèle	Un ID vendor/model depuis leur liste	uncensored

Pour cette API, la page clé permet également aux nouveaux utilisateurs de réclamer 0,50 $ de crédit d'essai en un clic, une fois par personne, valable 7 jours. L'inscription se fait avec Google ou avec e-mail et mot de passe. Le crédit d'essai suffit pour tester toute la configuration avant d'ajouter du crédit.

Testez d'abord l'endpoint avec curl

Janitor AI fournit peu de retours lorsqu'un proxy échoue ; vous voyez généralement une erreur générique dans le chat. Vérifiez l'endpoint en dehors du site, afin de savoir que les valeurs sont correctes avant de les coller.

Copycurl https://api.openrouternsfw.com/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship mechanic."},
      {"role": "user", "content": "Mara, the engine is making that noise again."}
    ],
    "max_tokens": 200
  }'

Une réponse JSON avec un tableau choices signifie que la clé, l'URL et le nom du modèle sont tous corrects. Consultez les en-têtes de réponse si vous voulez en savoir plus : X-Balance-USD affiche le crédit restant, et X-Request-Id est utile si vous contactez le support.

Saisissez le proxy dans Janitor AI

1. Ouvrez un chat avec n'importe quel personnage.
2. Ouvrez le menu dans le chat et choisissez les paramètres API ou de génération. Le nom exact varie selon la version.
3. Sélectionnez l'option proxy, c'est-à-dire celle pour un endpoint personnalisé compatible OpenAI, au lieu du modèle intégré.
4. Collez l'URL de l'endpoint dans le champ URL du proxy.
5. Collez la clé dans le champ clé.
6. Saisissez le nom du modèle exactement comme indiqué : uncensored pour cette API.
7. Enregistrez les paramètres et rechargez la page de chat.

Le choix de la forme de l'URL à utiliser est le seul point où les gens bloquent. Le champ proxy de Janitor AI s'attend couramment à l'URL complète des complétions de chat, se terminant par /chat/completions. D'autres outils n'attendent que l'URL de base se terminant par /v1 et ajoutent le chemin eux-mêmes. Si l'URL complète donne une erreur, essayez l'URL de base, et vice versa. Le test curl ci-dessus vous indique que l'URL complète est valide, donc un échec pointe vers la façon dont le site construit sa requête, et non vers la clé.

Les noms de modèles sont sensibles à la casse et doivent correspondre. Un nom de modèle incorrect est la deuxième cause la plus fréquente d'échec du premier message.

Paramètres importants pour le jeu de rôle

Janitor AI expose quelques paramètres de génération à côté des champs proxy. L'API transmet les paramètres d'échantillonnage, ils ont donc un effet.

• Température : 0,7 à 1,0 garde le dialogue vivant. Des valeurs plus élevées commencent à dériver et à inventer des détails qui contredisent la fiche personnage.
• Max tokens : contrôle la longueur de la réponse. Une valeur de 300 à 600 convient au chat. La complétion pourrait utiliser le reste de la fenêtre de 100 000 tokens, mais des réponses de chat aussi longues sont rarement ce que vous voulez.
• Taille du contexte : l'API accepte jusqu'à 100 000 tokens, prompt plus complétion. Une valeur plus petite, telle que 8 000, maintient le coût par message bas et conserve encore beaucoup d'historique. Augmentez-le seulement si le personnage oublie des éléments dont vous avez besoin.
• Contrôle de la répétition : si un personnage boucle sur les mêmes phrases, une pénalité modérée de fréquence ou de présence aide. Les deux sont transmis.

Le modèle est ajusté pour répondre sans refus de contenu pour une utilisation adulte légale, donc une fiche de personnage écrite pour une histoire pour adultes ne devrait pas déclencher de texte de refus. Une règle est fixe : le contenu sexuel impliquant des mineurs n'est pas autorisé, et vous ne devez pas écrire de texte de fiche qui le suggère.

Ce que cela coûte

Les prix sont de $0,15 par 1M de tokens d'entrée et de $0,50 par 1M de tokens de sortie. Dans le jeu de rôle, presque tout le coût est en entrée, car chaque message renvoie la fiche personnage et l'historique du chat.

Prenez un message avec 8 000 tokens de contexte et une réponse de 300 tokens :

• Entrée : 8 000 x $0,15 / 1M = $0,0012
• Sortie : 300 x $0,50 / 1M = $0,00015
• Total : $0,00135 par message, ou $1,35 pour 1 000 messages

Un rechargement de $20 paie environ 14 800 messages à cette taille ($20 / $0,00135 fait 14 814). Le crédit d'essai de $0,50 couvre environ 370. Si vous augmentez le contexte à 30 000 tokens, l'entrée seule augmente à $0,0045 et un message coûte $0,00465 avec la même réponse, donc utilisez de grands contextes seulement quand vous en avez besoin.

Les rechargements vont de $20 à $500 avec des bonus de 5 % à partir de $50, 10 % à partir de $100 et 15 % à partir de $200. Le paiement est en crypto (USDT sur TRC20 ou USDC sur Base), le crédit n'expire jamais, et les requêtes échouées ou refusées ne sont pas facturées. Les détails sont sur la page des tarifs.

Dépannage

Erreur réseau ou pas de réponse

Vérifiez le format de l'URL (chemin complet ou base). Vérifiez qu'il n'y a pas d'espace de fin dans le champ clé. Puis lancez à nouveau le test curl depuis votre machine.

HTTP 401

La clé est incorrecte ou a été collée avec des caractères supplémentaires. Générez-la à nouveau depuis la page clé.

HTTP 429

Lisez le code d'erreur. rate_limited signifie plus de requêtes par minute que la limite autorisée (300 pour une clé complète, 60 pour une clé d'essai). concurrency signifie trop de requêtes simultanées (8 pour une clé complète, 2 pour une clé d'essai) ; dans Janitor AI, cela se produit lorsque vous régénérez une réponse pendant que la précédente est encore en streaming, car une requête en streaming occupe son emplacement jusqu'à sa fin. Un 429 avec Retry-After: 5 signifie une surcharge temporaire, donc attendez cinq secondes et réessayez.

Les réponses sont coupées court ou divaguent

Ajustez max tokens et température. Si le personnage oublie les événements récents, augmentez un peu la taille du contexte.

Le solde s'épuise

L'en-tête X-Balance-USD affiche ce qui reste. Ajoutez du crédit depuis le tableau de bord ; la documentation couvre le format d'erreur en détail.

OpenRouter ou cette API pour Janitor AI

Ce sont des types de services différents. OpenRouter est un routeur qui propose de nombreux modèles de nombreux fournisseurs ; vous choisissez le modèle par son nom, et ce que chaque modèle écrira ou non dépend de ce modèle. Consultez sa liste de modèles et ses tarifs actuels sur son propre site. Cette API propose un seul modèle textuel à poids ouverts, exécuté par un fournisseur indépendant et ajusté pour répondre sans refus de contenu pour un usage adulte légal. Ce n'est pas une API officielle d'un fabricant de modèle.

Si vous voulez de la variété, gardez votre configuration OpenRouter. Si vos personnages rencontrent des refus et que vous voulez un modèle unique stable et bon marché, celui-ci est simple à essayer : inscrivez-vous, réclamez le crédit d'essai, et collez les trois valeurs ci-dessus. Les prompts ne sont pas utilisés pour l'entraînement.

Plus de guides

• Alternative gratuite à OpenRouter ? Ce que vous obtenez réellement
• Bot Discord open source avec un LLM sans censure
• API Hermes : comment utiliser des LLM sans censure dans votre projet