Utiliser BroadNet Inference dans n8n (credential OpenAI, Base URL)
Mis à jour
Dans n8n, créez un credential OpenAI avec votre clé BroadNet comme API Key et la Base URL https://inference.broadnet.ai/v1. Dans le nœud OpenAI Chat Model, passez Model de From List à ID, saisissez un ID BroadNet comme broadnet/glm-5.3 et désactivez Use Responses API pour que n8n appelle les chat completions.
n8n est un outil d’automatisation de workflows. Son credential OpenAI possède un champ Base URL : le nœud OpenAI Chat Model (et les autres nœuds OpenAI qui utilisent ce credential) peut donc appeler n’importe quelle API compatible OpenAI. BroadNet Inference en fait partie. La page de documentation de n8n sur ce credential ne montre pas le champ Base URL ; les noms de champs ci-dessous ont donc aussi été vérifiés dans le code source de n8n, cité dans les sources.
Configuration
Créez le credential. Dans n8n, ouvrez Credentials, créez un nouveau credential OpenAI et remplissez :
Champ
Valeur
API Key
votre clé BroadNet
Organization ID (optional)
laisser vide
Base URL
https://inference.broadnet.ai/v1
Enregistrez-le. n8n teste le credential en appelant /models sur la Base URL.
Ajoutez le nœud de modèle. Ajoutez un nœud AI Agent ou Basic LLM Chain, rattachez-y un sous-nœud OpenAI Chat Model et sélectionnez le credential.
Définissez le modèle par ID. Dans Model, passez le mode de From List à ID et saisissez broadnet/glm-5.3.
Désactivez Use Responses API. D’après le code source de n8n, ce bouton existe à partir de la version 1.3 du nœud et y est activé par défaut. BroadNet sert les chat completions : désactivez-le.
Réglez les options. Sous Options, laissez Maximum Number of Tokens à sa valeur par défaut (-1) ou fixez-le à quelques milliers. Max Retries vaut 2 par défaut ; augmentez-le si vous voulez que n8n relance plus souvent les appels en échec.
Exécutez le workflow une fois avec un prompt de test.
n8n affiche un avertissement quand vous utilisez une Base URL qui n’est pas celle d’OpenAI : tous les modèles ne sont peut-être pas compatibles chat ni capables d’appeler des outils ou de produire le format de réponse JSON. Chez BroadNet, le chat fonctionne avec tous les modèles de chat, mais la documentation de BroadNet n’indique les outils et la sortie structurée que pour GLM 5.3 et Qwen3.8 27B.
Quel modèle choisir ?
Workflow
Modèle
Pourquoi
AI Agent avec outils
broadnet/glm-5.3
Outils et sortie structurée indiqués par BroadNet
Images, messages en arabe
broadnet/qwen3.8-27b
Outils, images en entrée, testé en arabe
Classification à fort volume
broadnet/gemma-4-26b-a4b
Prix par token bas ; pas de raisonnement indiqué
Longs documents
broadnet/deepseek-v4.1-flash
Contexte de 1M ; outils non indiqués
Comparez les prix sur la page des tarifs. Pour l’audio, le nœud HTTP Request de n8n peut envoyer des fichiers à /v1/audio/transcriptions ; le guide speech-to-text pour l’arabe montre les champs de formulaire à envoyer.
Dépannage
Le test du credential échoue. Vérifiez que la Base URL se termine par /v1, sans chemin supplémentaire. Si les appels de chat renvoient aussi 401, la clé est erronée, expirée ou son quota de paiement à l’usage est épuisé.
Erreurs de modèle. Utilisez le mode ID et saisissez l’ID BroadNet exact, avec le préfixe broadnet/. GLM 5.3, Qwen3.8 27B et DeepSeek V4.1 Flash nécessitent une recharge ; le crédit de départ de $5 couvre BroadNet Gemma 4 VL 26B.
« Bad request - please check your parameters » (traduction : « requête invalide, vérifiez vos paramètres »). La documentation de n8n conseille de rejouer l’appel dans un nœud HTTP Request pour voir l’erreur complète. Ici, une cause fréquente est le bouton de la Responses API.
429 dans les boucles. Une clé à l’usage autorise 30 requêtes par minute et 4 simultanées. La documentation de n8n conseille Loop Over Items avec un nœud Wait pour cadencer les lots. Voir codes d’erreur et nouvelles tentatives.
Exécutions parallèles avec une clé de forfait. Une session de forfait illimité traite une seule requête à la fois. Les exécutions parallèles du workflow passent en file d’attente, sauf si chacune a sa propre session.
Vous préférez le code ? Les mêmes réglages fonctionnent dans LangChain, sur lequel reposent les nœuds IA de n8n.
Questions fréquentes
Pourquoi l’AI Agent de n8n échoue-t-il avec BroadNet ?
Vérifiez que Use Responses API est désactivé dans le nœud OpenAI Chat Model. Dans la version 1.3 du nœud, l’option est activée par défaut, et BroadNet sert /v1/chat/completions, pas la Responses API. Passez aussi Model en mode ID avec l’ID BroadNet exact.
Pourquoi la liste des modèles est-elle vide ou fausse ?
Le mode From List lit l’endpoint /models du fournisseur. La documentation de BroadNet décrit cet endpoint comme des métadonnées publiques du catalogue destinées à la supervision. Passez Model en mode ID et saisissez l’ID du modèle BroadNet.
Pourquoi l’agent n8n renvoie-t-il une sortie vide ?
Le raisonnement a épuisé Maximum Number of Tokens. Augmentez la valeur ou laissez-la à sa valeur par défaut, -1.
Où se trouve le champ Base URL dans le credential OpenAI de n8n ?
Dans le credential OpenAI lui-même, sous API Key et Organization ID. Sa valeur par défaut est https://api.openai.com/v1. Remplacez-la par https://inference.broadnet.ai/v1, en gardant /v1 et sans ajouter d’autre chemin.