---
title: "LibreChat : custom endpoint dans librechat.yaml (API OpenAI)"
description: "Ajoutez BroadNet Inference à LibreChat comme custom endpoint compatible OpenAI dans librechat.yaml : clé dans .env, liste de modèles, modèle de titre et dépannage."
url: https://broadrouter.com/fr/guides/librechat-custom-endpoint/
lang: fr
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduit de l’anglais avec l’aide de l’IA. [Lire l’original en anglais](https://broadrouter.com/guides/librechat-custom-endpoint/) (mis à jour le 2026-11-16).

# Ajouter BroadNet Inference à LibreChat comme custom endpoint

Mis à jour 2026-11-16

Dans librechat.yaml, ajoutez une entrée sous endpoints.custom avec name BroadNet, apiKey pointant vers une variable d’environnement comme BROADNET\_API\_KEY, baseURL https://inference.broadnet.ai/v1 et, sous models.default, des ID BroadNet comme broadnet/glm-5.3. Mettez la clé dans .env, montez le fichier dans le conteneur sous Docker, puis redémarrez LibreChat. LibreChat ajoute lui-même /chat/completions à l’URL de base.

LibreChat est une application de chat open source qui prend en charge les services compatibles OpenAI sous forme de **custom endpoints**. Vous les définissez dans `librechat.yaml`, gardez les clés dans `.env` et, sous Docker, montez le fichier YAML dans le conteneur. BroadRouter est le site de BroadNet ; les étapes suivent le [guide des custom endpoints de LibreChat](https://www.librechat.ai/docs/quick_start/custom_endpoints).

## Configuration

1.  **Montez librechat.yaml (Docker uniquement).** Copiez `docker-compose.override.yml.example` vers `docker-compose.override.yml` et vérifiez que le volume est actif :

```yaml
services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml
```

2.  **Ajoutez l’endpoint** dans `librechat.yaml`, à la racine du projet, sous `endpoints.custom` :

```yaml
endpoints:
  custom:
    - name: 'BroadNet'
      apiKey: '${BROADNET_API_KEY}'
      baseURL: 'https://inference.broadnet.ai/v1'
      models:
        default:
          - 'broadnet/glm-5.3'
          - 'broadnet/qwen3.8-27b'
          - 'broadnet/deepseek-v4.1-flash'
          - 'broadnet/gemma-4-26b-a4b'
        fetch: false
      titleConvo: true
      titleModel: 'broadnet/gemma-4-26b-a4b'
      modelDisplayLabel: 'BroadNet'
```

Conservez les clés de premier niveau déjà présentes dans votre fichier, comme `version`.

3.  **Définissez la clé** dans `.env` :

```bash
BROADNET_API_KEY=your-broadnet-key
```

4.  **Redémarrez LibreChat.** Avec Docker : `docker compose down && docker compose up -d`. Pour une installation locale, redémarrez avec `npm run backend`. BroadNet apparaît alors dans le sélecteur d’endpoints.

## Notes sur les champs

-   **baseURL.** LibreChat ajoute lui-même `/chat/completions` : utilisez donc la racine `/v1` ci-dessus. Ne réglez pas `directEndpoint: true` ; cette option est prévue pour une baseURL qui est déjà l’URL complète des completions.
-   **fetch: false.** C’est la valeur par défaut de LibreChat ; nous la définissons pour rendre ce choix visible. La documentation de BroadNet décrit `GET /v1/models` comme des métadonnées de catalogue publiques destinées aux outils de supervision : lister les modèles dans `default` est donc plus prévisible.
-   **titleModel.** LibreChat génère un titre pour chaque conversation avec une requête supplémentaire. Un petit modèle peu coûteux, sans raisonnement, garde cet appel court. La documentation de BroadNet n’indique pas de raisonnement pour Gemma 4 VL 26B.
-   **user\_provided.** Réglez `apiKey: 'user_provided'` si chaque utilisateur doit saisir sa propre clé BroadNet dans l’interface. LibreChat stocke la clé de chaque utilisateur chiffrée et la demande la première fois qu’il choisit l’endpoint.
-   **Nom unique.** Un second endpoint portant le même nom, sans tenir compte de la casse, remplace le premier sans prévenir. Si vous avez déjà une entrée nommée BroadNet, renommez l’une des deux.
-   **Pas de clé en clair.** La documentation de LibreChat recommande la référence `${VAR}` plutôt qu’une clé saisie dans `librechat.yaml`, où elle resterait en clair.

## Quel modèle choisir ?

| Usage | Modèle |
| --- | --- |
| Chat par défaut, outils, JSON | [GLM 5.3](https://broadrouter.com/fr/models/glm-5.3/) |
| Images et arabe | [Qwen3.8 27B](https://broadrouter.com/fr/models/qwen3.8-27b/) |
| Longs documents, contexte de 1M | [DeepSeek V4.1 Flash](https://broadrouter.com/fr/models/deepseek-v4.1-flash/) |
| Titres et réponses rapides | [BroadNet Gemma 4 VL 26B](https://broadrouter.com/fr/models/gemma-4-vl-26b/) |

Parmi ces modèles, seul Gemma 4 VL 26B fonctionne avec le crédit de départ de $5, qui couvre aussi les deux modèles Transcribe. Comparez les prix sur la [page des tarifs](https://broadrouter.com/fr/pricing/).

## Dépannage

-   **L’endpoint n’apparaît pas.** Vérifiez que `name`, `baseURL`, `apiKey` et `models.default` sont bien orthographiés et indentés sous `endpoints.custom`. LibreChat écarte les entrées incomplètes sans ligne de log. Sous Docker, vérifiez que le bind mount n’est plus commenté dans `docker-compose.override.yml`.
-   **« Missing API Key for BroadNet ».** `BROADNET_API_KEY` est absent de `.env`, ou LibreChat n’a pas été redémarré. L’endpoint apparaît quand même ; l’erreur ne s’affiche qu’à l’envoi d’un message.
-   **401 renvoyé par le fournisseur.** La clé est erronée ou a expiré, ou l’allocation à l’usage est épuisée.
-   **Erreurs de modèle.** Chaque ID doit correspondre exactement à celui de BroadNet, avec le préfixe `broadnet/`. GLM 5.3, Qwen3.8 27B et DeepSeek V4.1 Flash nécessitent une recharge.
-   **Réponses vides.** DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B raisonnent d’abord, et le raisonnement est décompté de `max_tokens`. Si vous avez réglé une petite sortie maximale dans les paramètres de LibreChat, augmentez-la. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **429 avec de nombreux utilisateurs.** Une clé à l’usage autorise 30 requêtes par minute et 4 simultanées, partagées par tous les utilisateurs de l’endpoint. Les requêtes de titre comptent aussi. Des clés `user_provided` répartissent la charge. Voir [codes d’erreur et nouvelles tentatives](https://broadrouter.com/fr/guides/errors-and-retries/).
-   **Clés de forfait.** Une [session de forfait illimité](https://broadrouter.com/fr/guides/unlimited-llm-api-sessions/) traite une requête à la fois et ne peut pas être partagée : elle ne convient donc pas à un LibreChat multi-utilisateur.

## Termes de ce guide

[Appel d’outils (tool calling, function calling)](https://broadrouter.com/fr/glossary/tool-calling/)

L’appel d’outils, aussi appelé function calling, est une fonctionnalité des API LLM dans laquelle le modèle renvoie une demande structurée d’exécution d’une fonction définie par le développeur, avec des arguments JSON. L’application exécute la fonction et renvoie le résultat ; le modèle n’exécute jamais de code lui-même.

[Concurrence (requêtes simultanées)](https://broadrouter.com/fr/glossary/concurrency/)

La concurrence est le nombre de requêtes qu’un client a en cours au même moment. Les API de LLM la plafonnent souvent par clé ou par forfait, indépendamment des requêtes par minute, car chaque requête ouverte occupe de la capacité GPU jusqu’à la fin de sa réponse.

[Limite de débit (rate limit)](https://broadrouter.com/fr/glossary/rate-limit/)

Une limite de débit (rate limit) est un plafond qu’une API impose à l’usage d’un client sur une période, par exemple en requêtes ou en tokens par minute. Les requêtes au-delà sont refusées, généralement avec HTTP 429 Too Many Requests, jusqu’à ce que l’usage repasse sous la limite.

[Paiement à l’usage (pay-as-you-go)](https://broadrouter.com/fr/glossary/pay-as-you-go/)

Le paiement à l’usage (pay-as-you-go) est un modèle tarifaire où vous ne payez que ce que vous consommez, mesuré par unité, comme les tokens, les requêtes ou les minutes d’audio, sans abonnement ni engagement minimal. La plupart des API LLM facturent ainsi, à partir d’un solde prépayé ou d’une facture périodique.

[URL de base (base URL)](https://broadrouter.com/fr/glossary/base-url/)

L’URL de base est l’adresse racine fixe d’une API, comme https://api.example.com/v1, que le client place devant chaque chemin d’endpoint, comme /chat/completions. Dans les SDK compatibles OpenAI, changer l’URL de base, avec la clé d’API et l’ID du modèle, oriente le même code vers un autre fournisseur.

[Clé d’API (API key)](https://broadrouter.com/fr/glossary/api-key/)

Une clé d’API est une chaîne secrète qui identifie et autorise un client qui appelle une API. Les API LLM l’attendent généralement dans un en-tête Authorization: Bearer, et quiconque détient la clé peut envoyer des requêtes facturées au compte qui la possède.

[Crédit prépayé (prepaid credit)](https://broadrouter.com/fr/glossary/prepaid-credit/)

Le crédit prépayé est de l’argent versé sur un compte API avant utilisation. Chaque requête déduit son coût du solde, et quand le solde est épuisé, les requêtes facturées s’arrêtent jusqu’à la prochaine recharge. Les dépenses sont ainsi plafonnées à ce que vous avez versé.

[Forfait LLM (flat rate)](https://broadrouter.com/fr/glossary/flat-rate-llm-plan/)

Un forfait LLM facture un prix fixe pour une période, par exemple un mois, en échange de l’accès à une API de modèle de langage, au lieu de facturer au token. Ces forfaits limitent généralement autre chose, comme la concurrence, la vitesse, les modèles ou des fenêtres d’usage : les plafonds comptent donc autant que le prix.

## Questions fréquentes

### Pourquoi mon endpoint BroadNet n’apparaît-il pas dans LibreChat ?

LibreChat écarte un custom endpoint sans erreur ni ligne de log si name, baseURL, apiKey ou models.default manque ou est mal orthographié. Sous Docker, vérifiez aussi que librechat.yaml est monté sur /app/librechat.yaml et que vous avez redémarré.

### Chaque utilisateur peut-il utiliser sa propre clé BroadNet ?

Oui. Réglez apiKey sur user\_provided. LibreChat demande alors une clé à chaque utilisateur la première fois qu’il choisit l’endpoint, et la stocke chiffrée.

### Pourquoi LibreChat affiche-t-il « Missing API Key for BroadNet » ?

La variable référencée dans apiKey n’est pas définie dans .env. L’endpoint apparaît quand même dans le sélecteur, et l’erreur ne s’affiche qu’à l’envoi d’un message. Ajoutez la variable, puis redémarrez LibreChat.

### La baseURL de LibreChat doit-elle inclure /chat/completions ?

Non. Par défaut, LibreChat ajoute /chat/completions à la baseURL. Utilisez https://inference.broadnet.ai/v1. Ne réglez directEndpoint sur true que si l’URL saisie est déjà le point de terminaison complet des completions.

## Guides associés

-   [Connecter Open WebUI à BroadNet Inference](https://broadrouter.com/fr/guides/open-webui-openai-api/)
-   [Pourquoi un modèle de raisonnement renvoie une réponse vide](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/)
-   [Codes d’erreur de BroadNet Inference : quand réessayer ?](https://broadrouter.com/fr/guides/errors-and-retries/)
-   [Limiter vos clés API à vos serveurs avec une liste d’IP autorisées](https://broadrouter.com/fr/guides/api-keys-ip-allow-lists/)
-   [Tous les outils compatibles avec BroadNet Inference (en anglais)](https://broadrouter.com/integrations/) : SDK, agents de code, interfaces de chat et outils d’automatisation, avec les réglages exacts pour chacun

Essayez-le sur votre vraie charge de travail. Les nouveaux comptes démarrent avec USD 5 de crédit pour Gemma et transcription. DeepSeek, GLM et Qwen3.8 nécessitent une recharge.

[Commencer](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-librechat-custom-endpoint&utm_content=page-cta) ·

**Sources**

-   [Documentation de LibreChat, démarrage rapide Custom Endpoints (consulté le 2026-11-14)](https://www.librechat.ai/docs/quick_start/custom_endpoints)
-   [Documentation de LibreChat, structure de l’objet Custom Endpoint (consulté le 2026-11-14)](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint)
-   [Référence de l’API de BroadNet Inference (consultée le 2026-11-16) (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-librechat-custom-endpoint&utm_content=sources)
