BroadRouter

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

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

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

  3. Définissez le modèle par ID. Dans Model, passez le mode de From List à ID et saisissez broadnet/glm-5.3.

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

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

  6. 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.
  • Sortie vide. Le raisonnement compte dans Maximum Number of Tokens. Augmentez la valeur. Pourquoi les réponses reviennent vides.
  • 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.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity