FR ▾

LLM open-weight sans filtre de contenu.

Clé API Janitor AI : Configuration via proxy

Pour utiliser la clé API Janitor AI avec un autre service, Janitor AI nécessite trois données : l'adresse de l'endpoint, la clé API et le nom du modèle. Voici la procédure de configuration et les corrections des erreurs courantes.

Analyse des coûts et compromis avec un modèle sans censure

Mis à jour

Petite scène de théâtre avec des masques et des ballons de dialogue lumineux connectés à un serveur, thème Janitor AI

Points clés

  1. Trois champs : adresse de l'endpoint, clé API et nom du modèle uncensored.

  2. Testez d'abord la clé avec curl pour déterminer si le problème vient de la clé ou des paramètres de Janitor AI.

  3. L'erreur 404 indique généralement une adresse incorrecte, la 401 une clé erronée, et la 429 un dépassement de limite de débit.

  4. Un contexte plus grand rend chaque message plus cher, limitez-le selon vos besoins.

Résumé : les trois valeurs à saisir

Janitor AI propose une option pour connecter votre propre source de modèle via un endpoint compatible OpenAI. Ainsi, pour la clé API Janitor AI de ce service, vous devez simplement saisir trois valeurs :

  • URL de l'endpoint : https://api.apitanpasensor.com/v1/chat/completions
  • Clé API : votre clé depuis la page Clé API
  • Nom du modèle : uncensored

Les noms des colonnes et l'emplacement du menu dans Janitor AI peuvent changer, cet article explique donc la configuration de manière générale. Si l'interface diffère de ce que vous voyez, suivez le guide officiel de Janitor AI pour cette section, puis revenez aux trois valeurs ci-dessus.

Étape 1 : récupérer la clé et tester avec curl

Avant de modifier les paramètres de Janitor AI, vérifiez que votre clé API fonctionne. Ainsi, en cas d'erreur, vous saurez que le problème ne vient pas de la clé. Les nouveaux utilisateurs peuvent réclamer un crédit d'essai de 0,50 $ sur la page de la clé API sans carte, suffisant pour quelques centaines de messages d'essai.

curl https://api.apitanpasensor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "Kamu adalah karakter fiksi bernama Laras, seorang penjaga mercusuar."},
      {"role": "user", "content": "Selamat malam, boleh saya masuk?"}
    ],
    "max_tokens": 200
  }'

Si vous recevez un JSON avec une réponse dans choices[0].message.content, la clé et le modèle sont corrects. Vérifiez également l'en-tête X-Balance-USD pour voir le solde restant.

Étape 2 : configurer le proxy dans Janitor AI

Dans Janitor AI, les paramètres du modèle se trouvent généralement dans le menu des paramètres API sur l'écran de chat. Cherchez l'option pour utiliser un proxy ou une source de modèle personnalisée, puis remplissez comme suit :

  1. Sélectionnez l'option proxy ou API personnalisée, et non le modèle par défaut.
  2. Remplissez le champ adresse du proxy avec https://api.apitanpasensor.com/v1/chat/completions. De nombreux guides de la communauté indiquent que ce champ doit contenir l'URL complète jusqu'à la partie chat completions. Si la connexion échoue, essayez avec et sans cette partie finale.
  3. Collez votre clé API dans le champ clé.
  4. Saisissez le nom du modèle avec uncensored. La casse doit être exactement la même.
  5. Enregistrez les paramètres, rechargez la page et envoyez un message d'essai.

Ne placez pas le mot « Bearer » dans le champ clé. Les applications compatibles OpenAI l'ajoutent automatiquement, et le saisir deux fois provoque une erreur d'authentification.

Si vous avez un doute sur une étape, consultez la documentation de Janitor AI. Les paramètres affichés sont la référence la plus récente pour son interface. Pour le côté API, la référence est notre documentation.

Erreurs courantes et corrections

SymptômesLa cause la plus probableCorrections
Erreur 401 ou échec d'authentificationClé incorrecte, tronquée ou avec des espaces au début ou à la finCopiez à nouveau la clé, assurez-vous qu'elle ne contient pas le mot « Bearer », puis testez à nouveau avec curl
Erreur 404URL de l'endpoint incorrecte, par exemple faute de frappe ou partie /v1 manquanteUtilisez l'URL exacte ci-dessus et essayez les variations avec ou sans /chat/completions
Erreur liée au modèleLe nom du modèle ne correspond pasSaisissez uncensored en minuscules
Erreur 429 avec le code concurrencyTrop de requêtes simultanéesFermez les autres onglets de chat qui génèrent encore des réponses
Erreur 429 avec le code rate_limitedLimite de requêtes par minute dépasséeAttendez un instant, puis réessayez
La réponse s'interrompt ou échoue complètementSolde insuffisant ou contexte trop volumineuxVérifiez votre solde via l'en-tête X-Balance-USD ou GET /v1/balance, et réduisez la taille du contexte

Avec la clé d'essai, la limite est de 2 requêtes simultanées et 60 par minute. Avec la clé complète, vous avez droit à 8 requêtes simultanées et 300 par minute. Lorsque l'API est très sollicitée, elle peut également renvoyer une erreur 429 avec l'en-tête Retry-After: 5, ce qui signifie que vous devez réessayer dans cinq secondes. Une réponse en cours de streaming occupe toujours une seule requête simultanée jusqu'à sa fin.

Si toutes les étapes sont correctes mais que l'erreur persiste, envoyez l'ID de requête de l'en-tête X-Request-Id à support pour accélérer l'investigation.

Si la réponse est lente ou coupée

Certains problèmes ne viennent pas de la clé, mais de la manière dont le chat fonctionne. Vérifiez les points suivants dans l'ordre :

  • Plusieurs onglets actifs : chaque réponse en streaming occupe une requête simultanée. Avec la clé d'essai, il n'y a que 2 slots disponibles, donc trois onglets ouverts peuvent facilement déclencher une erreur 429.
  • Réponse trop longue : les réponses longues prennent effectivement plus de temps. Limitez la longueur de la réponse dans les paramètres de Janitor AI.
  • Contexte trop volumineux : un prompt très long ralentit la réponse initiale et augmente la facture.
  • Votre réseau : essayez d'exécuter curl depuis le même ordinateur. Si curl fonctionne mais que Janitor AI échoue, le problème vient des paramètres de Janitor AI, et non de l'API.

Si les nouvelles tentatives réussissent souvent, il s'agit généralement d'une limite ou d'une congestion temporaire. Attendez quelques secondes et renvoyez le message, sans cliquer plusieurs fois sur le bouton d'envoi, car chaque tentative utilise un slot.

Configurer le contexte et le coût par message

Chaque fois que vous envoyez un message, Janitor AI envoie une partie de l'historique du chat à l'API. Plus le contexte que vous autorisez est grand, plus le nombre de tokens entrants facturés est élevé. La fenêtre de contexte maximale ici est de 100 000 tokens (prompt plus réponse), mais presque aucun chat n'en a besoin.

Exemple de calcul avec un tarif de $0,15 par 1 million de tokens entrants et de $0,50 par 1 million de tokens sortants :

  • Contexte de 8 000 tokens et réponse de 400 tokens : 8 000 x 0,15 / 1 000 000 = $0,0012, plus 400 x 0,50 / 1 000 000 = $0,0002. Soit $0,0014 par message.
  • Cent messages comme celui-ci : 100 x $0,0014 = $0,14.
  • Avec un contexte de 2 000 tokens et la même réponse, le coût est de $0,0003 + $0,0002 = $0,0005 par message, soit $0,05 pour cent messages.

Pour les personnages ayant un arrière-plan narratif long, une taille de contexte moyenne (quelques milliers de tokens) est généralement suffisante. Augmentez-la uniquement lorsque le personnage commence à oublier des éléments importants. Une explication plus détaillée des coûts figure sur la page tarifs.

Paramètres de génération utiles

L'API transmet les paramètres d'échantillonnage standard, donc les paramètres de Janitor AI atteignent le modèle : temperature, top_p, stop, seed, et la pénalité de répétition. Voici quelques conseils initiaux :

  • Température : commencez par une valeur moyenne. Augmentez-la légèrement si la réponse semble rigide, diminuez-la si le personnage commence à divaguer.
  • Pénalité de répétition : augmentez-la légèrement si le modèle répète la même phrase à chaque réponse.
  • Longueur de la réponse : limitez-la avec max_tokens si la réponse est trop longue. Ce paramètre aide aussi à maîtriser les coûts, car les tokens sortants sont plus chers.
  • Seed : utile si vous souhaitez reproduire le même résultat lors du test de prompts pour un personnage.

Modifiez un paramètre à la fois, puis comparez plusieurs réponses. Modifier trois choses en même temps vous empêche de savoir laquelle a eu un effet.

La description du personnage, les exemples de dialogue et le message d'ouverture sont renvoyés à presque chaque message, donc leur longueur impacte directement le coût. Un personnage avec une description de 3 000 tokens ajoute 3 000 x 0,15 / 1 000 000 = $0,00045 à chaque message. Pour mille messages, cela représente $0,45, une petite somme, mais que vous pouvez économiser en rédigeant plus succinctement.

  • Rédigez les faits qui servent réellement l'histoire : noms, traits de caractère, relations et règles du monde. Supprimez les paragraphes d'arrière-plan qui n'apparaissent jamais.
  • Utilisez des phrases courtes et concrètes. Le modèle comprend mieux « Laras est taciturne, connaît les noms des bateaux, craint les tempêtes » que trois paragraphes métaphoriques.
  • Fournissez un ou deux exemples de dialogue montrant le style de parole, pas dix.
  • Indiquez les limites de l'histoire au début, par exemple le genre et le point de vue, pour éviter que le modèle ne s'égare.

Méthode de test simple : créez une version courte et une version longue du même personnage, envoyez cinq messages identiques aux deux, puis comparez les réponses et les chiffres usage. Souvent, la version courte donne des résultats tout aussi bons.

Contenu et limites applicables

Le modèle ici est configuré pour répondre sans refus de contenu pour l'usage adulte légitime, par exemple la fiction, le jeu de rôle et les applications d'accompagnement pour adultes. Cependant, il y a une limite stricte : le contenu sexuel impliquant des mineurs est interdit sans exception, quel que soit l'emballage narratif.

Ce service est réservé au texte. Si une fiche de personnage de Janitor AI utilise des images, celles-ci ne sont pas générées par cette API. Concernant les données, votre prompt n'est pas utilisé pour entraîner le modèle, comme expliqué sur la page confidentialité.

Autres guides

Questions fréquentes

Ai-je besoin d'une carte pour essayer ?

Non. Les nouveaux utilisateurs peuvent réclamer un crédit d'essai gratuit de $0,50 en un clic sur la page de la clé API, sans carte. Le crédit est valable 7 jours.

Quel nom de modèle dois-je saisir dans Janitor AI ?

Saisissez uncensored, exactement comme cela. Il n'y a qu'un seul modèle, donc il n'y a pas d'autre choix dans la liste.

Pourquoi une erreur 404 apparaît-elle après avoir saisi l'adresse ?

En général, l'adresse ne correspond pas. Utilisez https://api.apitanpasensor.com/v1/chat/completions, ou essayez sans la partie chat/completions si Janitor AI l'ajoute automatiquement.

Que signifie l'erreur 429 ?

Vous avez dépassé une limite. Le code concurrency signifie trop de requêtes simultanées, rate_limited signifie trop de requêtes par minute. Attendez un instant, puis réessayez.

Comment payer après épuisement du crédit d'essai ?

Le rechargement commence à $20 jusqu'à $500 avec USDT sur TRC20 ou USDC sur Base. Le crédit n'expire jamais.

Votre clé ne nécessite qu'une seule étape

Créez un compte, copiez votre clé, modifiez l'URL de base. C'est tout le processus de configuration.