Documentation

Janitor AI

La configuration du proxy de Janitor AI exige l’URL complète de l’endpoint, et non une URL de base : le chemin se termine par /chat/completions. Renseignez correctement ce champ ; le reste se résume à un nom, un identifiant de modèle et une clé.

API Settings → Proxy → Add Configuration : le Proxy URL est le chemin complet /v1/chat/completions, et le Model Name doit être exactement un identifiant du catalogue.

Janitor AI · Paramètres de l’API

☰ → API Settings → Proxy → + Add Configuration

  Config Name   Kunavo
  Model Name    claude-sonnet-5
  Proxy URL     https://api.kunavo.com/v1/chat/completions
  API Key       sk-kn-...

L’URL du proxy est l’URL complète de l’endpoint. Le guide de Janitor AI précise qu’elle doit se terminer par /chat/completions ; il faut donc indiquer https://api.kunavo.com/v1/chat/completions — et non l’URL de base que vous saisiriez dans un outil de programmation. Une URL de base est la cause la plus fréquente d’un « proxy qui ne fonctionne pas ».

Le nom du modèle doit être exact. Janitor AI transmet la chaîne sans la modifier ; une faute de frappe ou un nom d’affichage provoque donc une erreur renvoyée par l’endpoint, au lieu d’un message utile dans l’interface. Copiez les identifiants depuis GET /v1/models ou depuis /models sur ce site.

Pas encore de clé ? Créez un compte Kunavo, créez une clé (elle commence par sk-kn-) et ajoutez un crédit à partir de 10 $ — les appels sont payés sur ce solde et les appels échoués ne sont pas facturés. Le tableau de bord s’ouvre ensuite sur la configuration Janitor AI.

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Ouvrez une conversation, cliquez sur le menu ☰ en haut, puis choisissez Paramètres de l’API.
Sélectionnez Proxy, puis + Ajouter une configuration.
Renseignez Nom de la configuration, Nom du modèle, URL du proxy et Clé API exactement comme ci-dessus, puis enregistrez.
Envoyez un message. Une réponse signifie que le proxy fonctionne ; une erreur mentionnant le modèle concerne le nom du modèle, et une erreur mentionnant l’URL concerne le chemin.

Vérifié avec Guide du proxy de Janitor AI le 6 septembre 2026. Les paramètres tiers évoluent ; si le nom d’un champ ne correspond plus à ce que vous voyez ici, cette page fait autorité, pas celle-ci.

Vérifiez avant de déboguer le client

Une requête suffit à déterminer si l’échec vient de l’endpoint, de la clé ou du fichier de configuration. Si cette requête renvoie du JSON, la même URL de base et la même clé fonctionnent dans Janitor AI.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quel identifiant de modèle saisir dans le champ

Tous les modèles textuels sont accessibles sous forme d’identifiant de modèle — la liste à jour se trouve sur GET /v1/models, et le catalogue avec les prix sur la page des modèles. Les tarifs sont en USD par million de tokens, entrée / sortie.

Identifiant du modèle	Entrée / sortie sur Kunavo	Où cela s’intègre dans Janitor AI
`claude-sonnet-5`	$1.40 / $7.00	le choix par défaut — l’équilibre recherché par la plupart des utilisateurs
`claude-haiku-4-5`	$0.70 / $3.50	le moins cher par tour et rapide
`claude-opus-5`	$3.50 / $17.50	le plus coûteux ; vérifiez le coût par tour avant de vous engager
`gpt-5-6-terra`	$0.70 / $4.20	les longues conversations, lorsque la taille du contexte est le facteur limitant

La facturation se fait au token à partir d’un solde prépayé, sans frais mensuels — consultez la facturation. Avec un contexte répété — ce qu’envoient la plupart des éditeurs et clients de chat — la mise en cache des prompts influe davantage sur la facture que le choix du modèle.

Questions fréquentes

Quelle URL de proxy Janitor AI exige-t-il ?

L’endpoint complet de chat completions, et non une URL de base. Le guide de Janitor AI précise que l’URL doit se terminer par /chat/completions et donne un chemin complet en exemple. Pour un service compatible avec OpenAI, il faut donc saisir https://<host>/v1/chat/completions. Une URL de base est la raison la plus courante pour laquelle un proxy pourtant correctement configuré ne renvoie rien.

Comment configurer un proxy personnalisé dans Janitor AI ?

Ouvrez une conversation, cliquez sur le menu ☰, choisissez Paramètres de l’API, sélectionnez Proxy, puis cliquez sur + Ajouter une configuration. Renseignez un nom de configuration, le nom exact du modèle, l’URL du proxy se terminant par /chat/completions et la clé API, puis enregistrez et envoyez un message de test. Une réponse confirme simultanément que les quatre champs sont corrects.

Pourquoi Janitor AI indique-t-il que le modèle est introuvable ?

Parce que le nom du modèle est transmis tel quel à l’endpoint et doit correspondre exactement à un véritable identifiant de modèle : les noms d’affichage, les différences de majuscules et les espaces en fin de chaîne entraînent tous un échec. Copiez l’identifiant depuis la liste de modèles du fournisseur ou depuis un appel GET /v1/models, plutôt que de le saisir de mémoire.

L’utilisation d’un proxy dans Janitor AI est-elle payante ?

Elle coûte le montant facturé par l’endpoint derrière le proxy. Janitor AI ne facture pas l’utilisation du proxy ; le fournisseur de l’API facture chaque message de la conversation au nombre de jetons — dans une longue conversation de jeu de rôle, chaque tour inclut l’historique entier. Choisir un modèle moins cher et un endpoint avec mise en cache des prompts permet de réduire la facture.