LibreChat

LibreChat utilise une passerelle sous forme de bloc endpoints.custom dans librechat.yaml — quatre champs obligatoires, la clé provenant de .env, puis un redémarrage avant son affichage dans le sélecteur.

# librechat.yaml — project root, beside your .env
version: 1.3.5          # the value the documentation's own example carries

endpoints:
  custom:
    # Required: name, apiKey, baseURL, models. The name must be unique and
    # must not reuse a built-in endpoint name such as openAI or anthropic.
    - name: "Kunavo"
      apiKey: "${KUNAVO_API_KEY}"        # resolved from .env, not written here
      # Keep the /v1. LibreChat appends /chat/completions to this by default.
      baseURL: "https://api.kunavo.com/v1"
      models:
        default: ["claude-sonnet-5", "claude-haiku-4-5"]
        fetch: true                      # fills the picker from GET /v1/models
      titleConvo: true
      titleModel: "claude-haiku-4-5"         # titles are a separate call — pin a cheap id
      modelDisplayLabel: "Kunavo"

      # Optional but worth the four lines: without it LibreChat prices your
      # traffic from a table it ships. prompt/completion are USD per million
      # tokens; context is that model's own window. All three required.
      tokenConfig:
        claude-sonnet-5:
          prompt: 1.4
          completion: 7
          context: 1000000
        claude-haiku-4-5:
          prompt: 0.7
          completion: 3.5
          context: 200000

Étape par étape

1. Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
2. Sur Docker, montez d’abord le fichier de configuration : le guide de démarrage rapide demande de copier docker-compose.override.yml.example vers docker-compose.override.yml et de décommenter le volume librechat.yaml. Une installation bare metal n’a pas besoin de cette étape.
3. Créez ou modifiez librechat.yaml à la racine du projet, dans le même répertoire que votre .env, puis ajoutez l’entrée endpoints.custom ci-dessus.
4. Placez la clé dans .env sous la forme KUNAVO_API_KEY=sk-kn-.... L’espace réservé ${KUNAVO_API_KEY} dans le YAML est résolu à partir de ce fichier, ce qui évite d’inclure le secret dans le fichier de configuration que vous validez dans le dépôt.
5. Redémarrez LibreChat, puis ouvrez le sélecteur de points de terminaison : Kunavo apparaît comme une entrée distincte à côté des entrées intégrées. La liste des modèles est soit récupérée depuis GET /v1/models, soit tirée de votre tableau models.default si cette récupération échoue.
6. Envoyez un message, puis vérifiez que le sélecteur de modèles change bien de modèle : les identifiants sont résolus au point de terminaison. Il est donc normal d’avoir un identifiant Claude et un identifiant GPT sous une même entrée ; ce n’est pas une mauvaise configuration.

Vérifié avec Référence des objets de points de terminaison personnalisés de LibreChat le 21 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 LibreChat.

# 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.

Trois champs facultatifs qui se comportent différemment derrière une passerelle

Toutes les informations de ce tableau proviennent de la même référence de champs, consultée à la date indiquée ci-dessus. Il s’agit de la description par LibreChat de sa propre configuration, et non d’un résultat de test Kunavo ni d’une affirmation sur le comportement d’un identifiant de modèle donné une fois la requête envoyée par le client.

Le guide en quatre étapes — monter le fichier, configurer, définir la variable d’environnement, redémarrer — se trouve sur la page de démarrage rapide de LibreChat consacrée aux points de terminaison personnalisés, qui utilise une passerelle dans son exemple pratique.