---
title: "Dify : configurer OpenAI-API-compatible (URL de base)"
description: "Connectez Dify à BroadNet Inference via le plugin de fournisseur OpenAI-API-compatible : valeurs exactes des champs, tailles de contexte et function calling."
url: https://broadrouter.com/fr/guides/dify-openai-api-compatible/
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/dify-openai-api-compatible/) (mis à jour le 2026-11-16).

# Ajouter BroadNet Inference à Dify avec le plugin OpenAI-API-compatible

Mis à jour 2026-11-16

Dans Dify, installez le plugin OpenAI-API-compatible depuis Integrations, Model Provider, puis cliquez sur Add Model. Choisissez le type LLM et saisissez un ID BroadNet comme broadnet/glm-5.3, votre clé BroadNet et l’API Base URL https://inference.broadnet.ai/v1. Réglez Completion mode sur Chat, la vraie taille de contexte, une limite de sortie avec de la marge pour le raisonnement, et Tool Call seulement pour GLM 5.3 ou Qwen3.8 27B.

Dify est une plateforme open source pour créer des applications et des workflows LLM. Les fournisseurs que Dify ne liste pas nommément s’ajoutent via le plugin de fournisseur de modèles **OpenAI-API-compatible**, publié par l’équipe de Dify (langgenius). BroadNet Inference sert des chat completions standard à l’adresse `https://inference.broadnet.ai/v1` : il convient donc. BroadRouter est le site de BroadNet ; les noms de champs ci-dessous viennent de la version 0.0.83 du plugin.

## Configuration

1.  **Obtenez une clé.** Créez une clé à l’usage dans la console BroadNet.
    
2.  **Installez le plugin.** Dans Dify, allez dans **Integrations** > **Model Provider**, trouvez **OpenAI-API-compatible** parmi les fournisseurs installables (ou ouvrez-le sur la [Marketplace](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)) et installez-le. Vous devez être propriétaire ou administrateur de l’espace de travail.
    
3.  **Ajoutez un modèle.** Cliquez sur **Add Model** sur la carte du fournisseur et remplissez :
    
    | Champ | Valeur |
    | --- | --- |
    | Model Type | LLM |
    | Model Name | `broadnet/glm-5.3` |
    | Model display name | GLM 5.3 (BroadNet) |
    | API Key | votre clé BroadNet |
    | API Base URL | `https://inference.broadnet.ai/v1` |
    | Completion mode | Chat |
    | Model context size | `1048576` |
    | Upper bound for max tokens | `16000` |
    | Function Call Type | Tool Call |
    | Vision Support | Not Support |
    | Structured Output | Support |
    | API Type | Chat Completions API (/chat/completions) |
    | Token parameter name | Use max\_tokens |
    
4.  **Enregistrez.** Dify vérifie les identifiants avant d’ajouter le modèle.
    
5.  **Testez.** Créez une application Chatbot, sélectionnez **GLM 5.3 (BroadNet)** dans le sélecteur de modèles et envoyez un message dans le volet d’aperçu.
    

Répétez **Add Model** pour chaque modèle BroadNet souhaité. Le nom du modèle doit correspondre exactement à l’ID BroadNet, préfixe `broadnet/` compris.

## Valeurs par modèle

| Model Name | Taille de contexte | Function Call Type | Vision Support |
| --- | --- | --- | --- |
| `broadnet/glm-5.3` | 1048576 | Tool Call | Not Support |
| `broadnet/qwen3.8-27b` | 262144 | Tool Call | Support |
| `broadnet/deepseek-v4.1-flash` | 1048576 | Not Support (non testé) | Support |
| `broadnet/gemma-4-26b-a4b` | 32768 | Not Support | Support |

Pourquoi ces choix :

-   **Context size** vaut 4 096 par défaut dans le plugin. Si vous la laissez ainsi, Dify tronque la mémoire et le contexte récupéré bien en dessous de ce que le modèle accepte.
-   **Upper bound for max tokens** vaut aussi 4 096 par défaut. Trois des modèles raisonnent avant de répondre, et le raisonnement compte dans cette limite : laissez-leur de la marge. 16 000 est notre suggestion, pas une limite de BroadNet.
-   **Token parameter name** réglé sur `max_tokens` correspond au champ de la référence de l’API de BroadNet. Par défaut, le plugin le devine à partir du nom du modèle.
-   **API Type** reste sur Chat Completions. BroadNet ne liste pas la Responses API.

## Transcription

Le plugin peut aussi ajouter des modèles de speech-to-text. BroadNet sert `/v1/audio/transcriptions` avec `broadnet/cohere-transcribe-arabic` pour l’arabe et `broadnet/cohere-transcribe` pour 14 langues. Le README du plugin indique que, pour le speech-to-text, il ajoute lui-même le chemin de version : son exemple utilise donc l’hôte sans `/v1` (ici, `https://inference.broadnet.ai`). Nous n’avons pas testé ce chemin via Dify ; vérifiez-le d’abord avec un court fichier WAV. Voir le [guide de transcription de l’arabe](https://broadrouter.com/fr/guides/arabic-speech-to-text-api/).

## Dépannage

-   **La vérification des identifiants échoue.** Vérifiez la clé, l’API Base URL (elle se termine par `/v1` pour les LLM) et le nom du modèle. Les modèles payants nécessitent une recharge ; le crédit de $5 ne couvre que `broadnet/gemma-4-26b-a4b` et les deux modèles Transcribe.
-   **Réponses vides dans un workflow.** Le max tokens du nœud LLM est trop bas pour un modèle à raisonnement. Augmentez-le. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **Le nœud Agent n’appelle jamais d’outils.** Utilisez GLM 5.3 ou Qwen3.8 27B avec Function Call Type réglé sur Tool Call.
-   **429 en charge.** Une clé à l’usage autorise 30 requêtes par minute et 4 requêtes en cours. Les branches parallèles et les nœuds d’itération peuvent dépasser ce seuil ; réduisez leur parallélisme. Voir [codes d’erreur et nouvelles tentatives](https://broadrouter.com/fr/guides/errors-and-retries/).

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

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

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

[Fenêtre de contexte (context window)](https://broadrouter.com/fr/glossary/context-window/)

La fenêtre de contexte est le nombre maximal de tokens qu’un modèle de langage peut traiter dans une seule requête. Elle couvre le prompt, l’historique de conversation, les définitions d’outils, les images et la sortie générée, tokens de raisonnement compris. Ce qui ne tient pas doit être coupé, résumé ou réparti sur plusieurs requêtes.

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

[Sortie structurée (structured output)](https://broadrouter.com/fr/glossary/structured-output/)

La sortie structurée est une fonction des API LLM qui contraint la réponse d’un modèle à un format défini par le développeur, en général un JSON Schema, pour que le code puisse l’analyser de façon fiable. Elle est plus stricte que le mode JSON, qui garantit un JSON valide mais pas une structure précise.

## Questions fréquentes

### BroadNet fonctionne-t-il avec Dify Cloud comme avec Dify auto-hébergé ?

Oui. BroadNet Inference est un endpoint HTTPS public, Dify Cloud peut donc l’atteindre. Selon la documentation de Dify, seuls les propriétaires et administrateurs de l’espace de travail peuvent gérer les fournisseurs de modèles, et une clé ajoutée vaut pour tout l’espace de travail.

### L’API Base URL doit-elle inclure /v1 ?

Oui, pour les modèles LLM. Les exemples du plugin utilisent une URL de base se terminant par /v1 pour les modèles de chat, et son README prévient que, pour certains autres types de modèles, il ajoute lui-même le chemin de version.

### Quel Function Call Type choisir ?

Tool Call pour GLM 5.3 et Qwen3.8 27B, que BroadNet liste avec les outils. Choisissez Not Support pour DeepSeek V4.1 Flash, sauf si vous avez vous-même testé les appels d’outils avec ce modèle.

### Les crédits IA de Dify s’appliquent-ils aux modèles BroadNet ?

Non. Selon la documentation de Dify, les crédits IA ne s’appliquent pas aux fournisseurs que vous utilisez avec votre propre compte. BroadNet facture la clé que vous saisissez.

## Guides associés

-   [Utiliser BroadNet Inference dans n8n (credential OpenAI, Base URL)](https://broadrouter.com/fr/guides/n8n-openai-compatible/)
-   [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/)
-   [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-dify-openai-api-compatible&utm_content=page-cta) ·

**Sources**

-   [Documentation Dify, Model Providers (consulté le 2026-11-15)](https://docs.dify.ai/en/cloud/use-dify/workspace/model-providers)
-   [Dify Marketplace, plugin OpenAI-API-compatible de langgenius, version 0.0.83 (consulté le 2026-11-15)](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)
-   [Code source du plugin, champs du fournisseur openai\_api\_compatible (consulté le 2026-11-15)](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible)
-   [Référence de l’API de BroadNet Inference (consulté le 2026-11-15) (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-dify-openai-api-compatible&utm_content=sources)
