BroadRouter

Usare BroadNet Inference in n8n (credenziale OpenAI, Base URL)

Aggiornato

In n8n crea una credenziale OpenAI con la tua chiave BroadNet come API Key e Base URL impostato su https://inference.broadnet.ai/v1. Nel nodo OpenAI Chat Model passa Model da From List a ID, inserisci un ID BroadNet come broadnet/glm-5.3 e disattiva Use Responses API, così n8n chiama chat completions.

n8n è uno strumento di automazione dei workflow. La sua credenziale OpenAI ha un campo Base URL, quindi il nodo OpenAI Chat Model (e gli altri nodi OpenAI che usano la credenziale) può chiamare qualsiasi API compatibile con OpenAI. BroadNet Inference è una di queste. La pagina della documentazione di n8n sulla credenziale non mostra il campo Base URL, quindi i nomi dei campi qui sotto sono verificati anche sul codice sorgente di n8n, linkato tra le fonti.

Configurazione

  1. Crea la credenziale. In n8n vai su Credentials, crea una nuova credenziale OpenAI e compila:

    Campo Valore
    API Key la tua chiave BroadNet
    Organization ID (optional) lascialo vuoto
    Base URL https://inference.broadnet.ai/v1

    Salvala. n8n verifica la credenziale chiamando /models sul Base URL.

  2. Aggiungi il nodo del modello. Aggiungi un nodo AI Agent o Basic LLM Chain, poi collega un sotto-nodo OpenAI Chat Model e seleziona la credenziale.

  3. Imposta il modello per ID. In Model passa dalla modalità From List a ID e inserisci broadnet/glm-5.3.

  4. Disattiva Use Responses API. Nel codice sorgente di n8n l’interruttore esiste dalla versione 1.3 del nodo, dove è attivo per impostazione predefinita. BroadNet serve chat completions, quindi disattivalo.

  5. Imposta le opzioni. In Options lascia Maximum Number of Tokens al valore predefinito (-1) o impostalo a qualche migliaio. Max Retries vale 2 per impostazione predefinita; alzalo se vuoi che n8n ritenti più spesso le chiamate fallite.

  6. Esegui il workflow una volta con un prompt di prova.

Quando usi un Base URL diverso da quello di OpenAI, n8n mostra un avviso: not all models might be chat-compatible or support tools calling or JSON response format (traduzione: non tutti i modelli potrebbero essere compatibili con la chat o supportare il tool calling o il formato di risposta JSON). Su BroadNet la chat funziona con ogni modello di chat, ma la documentazione di BroadNet indica strumenti e output strutturato solo per GLM 5.3 e Qwen3.8 27B.

Quale modello scegliere

Workflow Modello Perché
AI Agent con strumenti broadnet/glm-5.3 Strumenti e output strutturato indicati da BroadNet
Immagini, messaggi in arabo broadnet/qwen3.8-27b Strumenti, input di immagini, testato in arabo
Classificazione ad alto volume broadnet/gemma-4-26b-a4b Prezzo per token basso; nessun ragionamento indicato
Documenti lunghi broadnet/deepseek-v4.1-flash Contesto da 1M; strumenti non indicati

Confronta i prezzi nella pagina dei prezzi. Per l’audio, il nodo HTTP Request di n8n può inviare file a /v1/audio/transcriptions; la guida allo speech-to-text in arabo mostra i campi del form da inviare.

Risoluzione dei problemi

  • Il test della credenziale fallisce. Controlla che il Base URL finisca con /v1, senza percorsi aggiuntivi. Se anche le chiamate di chat restituiscono 401, la chiave è sbagliata, scaduta o ha esaurito la quota a consumo.
  • Errori sul modello. Usa la modalità ID e inserisci l’ID BroadNet esatto, con il prefisso broadnet/. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash richiedono una ricarica; il credito iniziale di $5 copre BroadNet Gemma 4 VL 26B.
  • “Bad request - please check your parameters” (traduzione: richiesta non valida, controlla i parametri). La documentazione di n8n suggerisce di ripetere la chiamata in un nodo HTTP Request per vedere l’errore completo. Qui una causa frequente è l’interruttore della Responses API.
  • Output vuoto. Il ragionamento conta in Maximum Number of Tokens. Alza il valore. Perché le risposte arrivano vuote.
  • 429 nei loop. Una chiave a consumo consente 30 richieste al minuto e 4 in contemporanea. La documentazione di n8n suggerisce Loop Over Items con un nodo Wait per distanziare i batch. Vedi errori e retry.
  • Esecuzioni parallele con una chiave di piano. Una sessione del piano illimitato esegue una richiesta alla volta. Le esecuzioni parallele del workflow finiscono in coda, a meno che ognuna abbia la propria sessione.

Preferisci il codice? Le stesse impostazioni funzionano in LangChain, su cui sono costruiti i nodi AI di n8n.

Domande frequenti

Perché l’AI Agent di n8n non funziona con BroadNet?

Controlla che Use Responses API sia disattivato nel nodo OpenAI Chat Model. Nella versione 1.3 del nodo è attivo per impostazione predefinita, e BroadNet serve /v1/chat/completions, non la Responses API. Imposta anche Model in modalità ID con l’ID BroadNet esatto.

Perché il menu a tendina dei modelli è vuoto o sbagliato?

La modalità From List legge l’endpoint /models del provider. La documentazione di BroadNet descrive quell’endpoint come metadati pubblici del catalogo per i sistemi di monitoraggio. Passa Model in modalità ID e scrivi l’ID del modello BroadNet.

Perché l’agente di n8n restituisce un output vuoto?

Il ragionamento ha esaurito Maximum Number of Tokens. Alza il valore, oppure lascialo al predefinito -1.

Dov’è il campo Base URL nella credenziale OpenAI di n8n?

Si trova nella credenziale OpenAI stessa, sotto API Key e Organization ID. Il valore predefinito è https://api.openai.com/v1. Sostituiscilo con https://inference.broadnet.ai/v1, mantenendo /v1 e senza aggiungere altri percorsi.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity