---
title: "Open WebUI : configurer un endpoint compatible OpenAI"
description: "Ajoutez BroadNet Inference à Open WebUI comme connexion compatible OpenAI, inscrivez les ID de modèles et corrigez vérification, réponses vides et 429."
url: https://broadrouter.com/fr/guides/open-webui-openai-api/
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/open-webui-openai-api/) (mis à jour le 2026-11-16).

# Connecter Open WebUI à BroadNet Inference

Mis à jour 2026-11-16

Dans Open WebUI, ouvrez Settings > Connections dans la section d’administration, cliquez sur Add Connection sous Manage OpenAI API Connections, indiquez https://inference.broadnet.ai/v1 comme URL et votre clé BroadNet comme API Key, puis ajoutez des ID de modèles comme broadnet/glm-5.3 à la liste Model IDs et enregistrez.

Open WebUI est une interface de chat auto-hébergée. Elle se connecte à tout fournisseur qui implémente le protocole chat completions d’OpenAI, et c’est le cas de BroadNet Inference. Les étapes suivent [le guide d’Open WebUI pour les fournisseurs compatibles OpenAI](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible).

## Configuration

1.  **Obtenez une clé BroadNet.** Pour une interface de chat utilisée par plusieurs personnes, une clé à l’usage est le bon choix. Voir [clés d’API et listes d’IP autorisées](https://broadrouter.com/fr/guides/api-keys-ip-allow-lists/).
    
2.  **Ouvrez la page des connexions.** Allez dans **Settings > Connections** dans la section d’administration et repérez **Manage OpenAI API Connections**.
    
3.  **Cliquez sur Add Connection** et remplissez :
    
    | Champ | Valeur |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1` (sans barre oblique finale) |
    | API Key | votre clé BroadNet |
    | Model IDs | ajoutez chaque ID ci-dessous, un par un, avec l’icône **+** |
    
4.  **Ajoutez les ID de modèles à la main.** Saisissez `broadnet/glm-5.3`, cliquez sur **+**, puis recommencez pour les autres modèles voulus. La documentation de BroadNet décrit `GET /v1/models` comme des métadonnées publiques du catalogue destinées à la supervision : ne comptez pas dessus pour remplir le sélecteur de modèles.
    
5.  **Cliquez sur Save.** La documentation d’Open WebUI précise que l’enregistrement ne teste pas la connexion.
    
6.  **Lancez un chat** et choisissez le modèle dans le sélecteur.
    

### Avec des variables d’environnement

Si vous faites tourner Open WebUI dans Docker, vous pouvez définir la connexion au démarrage :

```bash
OPENAI_API_BASE_URL=https://inference.broadnet.ai/v1
OPENAI_API_KEY=your-broadnet-key
```

Pour ajouter BroadNet à côté d’une connexion OpenAI existante, utilisez les formes au pluriel, séparées par des points-virgules : `OPENAI_API_BASE_URLS` et `OPENAI_API_KEYS`. `OPENAI_API_CONFIGS` définit des options par connexion comme `model_ids`, indexées selon la position de la connexion dans cette liste :

```bash
OPENAI_API_CONFIGS='{"0": {"enable": true, "model_ids": ["broadnet/glm-5.3", "broadnet/qwen3.8-27b"]}}'
```

La [référence des variables d’environnement](https://docs.openwebui.com/reference/env-configuration) d’Open WebUI les classe parmi les réglages ConfigVar. Elles sont lues au premier lancement et enregistrées dans la base de données. Ensuite, c’est le panneau d’administration qui prime. Modifiez la connexion dans **Settings > Connections** dans la section d’administration, ou définissez `ENABLE_PERSISTENT_CONFIG=False` si vous voulez que l’environnement s’applique à chaque démarrage.

## Quel modèle choisir ?

| Usage | Modèle | Contexte |
| --- | --- | --- |
| Chat général, outils, JSON | `broadnet/glm-5.3` | 1 048 576 |
| Questions sur des images, arabe | `broadnet/qwen3.8-27b` | 262 144 |
| Longs documents, images | `broadnet/deepseek-v4.1-flash` | 1 048 576 |
| Petit budget, crédit gratuit | `broadnet/gemma-4-26b-a4b` | 32 768 |

BroadNet a testé Qwen3.8 27B en arabe, y compris les dialectes du Golfe et égyptien ; voir [choisir un LLM pour l’arabe](https://broadrouter.com/fr/blog/choosing-an-llm-for-arabic/). Gemma 4 VL 26B est le seul modèle de chat qui fonctionne avec le crédit de départ de $5 ; le crédit couvre aussi les deux modèles Transcribe. Les prix de chacun figurent sur la [page des tarifs](https://broadrouter.com/fr/pricing/).

Open WebUI transmet les paramètres standard comme `temperature` et `max_tokens`, et prend en charge les outils quand le modèle et le serveur gèrent `tools`. BroadNet indique les outils pour GLM 5.3 et Qwen3.8 27B.

## Dépannage

-   **Verify Connection échoue avec 400, 401 ou 403.** Le bouton de vérification d’Open WebUI appelle `/models`. Sa documentation précise que les chat completions peuvent tout de même fonctionner. Ajoutez les ID à la liste et testez un chat. Si le chat renvoie aussi 401, la clé est erronée, expirée ou son quota de paiement à l’usage est épuisé.
-   **Le modèle apparaît, mais le premier message échoue.** Vérifiez que l’ID correspond 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.** Les modèles de raisonnement (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) dépensent d’abord des tokens de sortie pour raisonner. Si vous avez défini **max\_tokens** dans les **Advanced Params** du modèle, augmentez-le ou videz-le. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **429 quand plusieurs personnes discutent.** Une clé à l’usage autorise 30 requêtes par minute et 4 simultanées. Open WebUI fait aussi des appels en arrière-plan avec la même clé, par exemple pour les titres de conversation. Voir [codes d’erreur et nouvelles tentatives](https://broadrouter.com/fr/guides/errors-and-retries/).
-   **Les variables d’environnement modifiées n’ont aucun effet.** Le premier lancement a enregistré les anciennes valeurs. Modifiez la connexion dans le panneau d’administration, ou reportez-vous à la section sur les variables d’environnement plus haut.
-   **Avec une clé de forfait.** Une [session de forfait illimité](https://broadrouter.com/fr/guides/unlimited-llm-api-sessions/) traite une seule requête à la fois, et les clés ne peuvent pas être partagées. Cela convient à une instance personnelle ; les requêtes des autres utilisateurs passent en file d’attente.

## Termes de ce guide

[Token](https://broadrouter.com/fr/glossary/token/)

Un token est l’unité de texte qu’un modèle de langage lit et écrit : un mot, une partie de mot, un signe de ponctuation ou une suite d’octets produite par le tokenizer du modèle. Les API LLM comptent, limitent et facturent généralement l’usage en tokens.

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

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

[API Chat Completions](https://broadrouter.com/fr/glossary/chat-completions-api/)

L’API Chat Completions est l’endpoint HTTP d’OpenAI, POST /v1/chat/completions, qui reçoit un nom de modèle et une liste de messages associés à un rôle, et renvoie le message suivant du modèle. Sa forme de requête et de réponse est devenue le format commun que reprennent les fournisseurs et SDK compatibles OpenAI.

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

[Chat template (modèle de conversation)](https://broadrouter.com/fr/glossary/chat-template/)

Un chat template est la règle de mise en forme, généralement écrite en Jinja et livrée avec le tokenizer d’un modèle, qui convertit une liste de messages de chat avec leurs rôles en la séquence unique de tokens attendue par le modèle, tokens de contrôle spéciaux compris. Un mauvais template peut fortement dégrader les réponses d’un modèle.

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

## Questions fréquentes

### Pourquoi Verify Connection échoue-t-il alors que le chat fonctionne ?

Le bouton de vérification d’Open WebUI appelle l’endpoint /models du fournisseur. Sa documentation précise qu’un échec ne signifie pas que le chat est cassé. Ajoutez à la main les ID de modèles BroadNet à la liste Model IDs.

### Puis-je configurer la connexion avec des variables d’environnement ?

Oui. Définissez OPENAI\_API\_BASE\_URL sur https://inference.broadnet.ai/v1 et OPENAI\_API\_KEY sur votre clé BroadNet. Open WebUI enregistre ces valeurs au premier lancement : les modifications ultérieures des variables sont ignorées, sauf si ENABLE\_PERSISTENT\_CONFIG vaut False.

### Pourquoi ma nouvelle valeur de OPENAI\_API\_BASE\_URL n’est-elle pas prise en compte ?

Open WebUI la traite comme une ConfigVar. Après le premier lancement, il utilise la valeur enregistrée dans sa base de données. Modifiez l’URL dans Settings > Connections dans la section d’administration, ou définissez ENABLE\_PERSISTENT\_CONFIG=False pour relire l’environnement à chaque démarrage.

### Toute mon équipe peut-elle partager une clé de forfait illimité dans Open WebUI ?

Non. Les forfaits de BroadNet n’autorisent pas le partage d’une clé, et une session de forfait traite une seule requête à la fois. Utilisez une clé à l’usage pour un Open WebUI partagé.

## Guides associés

-   [Ajouter BroadNet Inference à LibreChat comme custom endpoint](https://broadrouter.com/fr/guides/librechat-custom-endpoint/)
-   [Pourquoi un modèle de raisonnement renvoie une réponse vide](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/)
-   [Comment fonctionnent les forfaits API LLM illimités pour agents](https://broadrouter.com/fr/guides/unlimited-llm-api-sessions/)
-   [Codes d’erreur de BroadNet Inference : quand réessayer ?](https://broadrouter.com/fr/guides/errors-and-retries/)
-   [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-open-webui-openai-api&utm_content=page-cta) ·

**Sources**

-   [Documentation Open WebUI, fournisseurs compatibles OpenAI (consulté le 2026-11-16)](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [Documentation Open WebUI, configuration par variables d’environnement (consulté le 2026-11-14)](https://docs.openwebui.com/reference/env-configuration)
-   [Référence de l’API de BroadNet Inference (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-open-webui-openai-api&utm_content=sources)
