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
-
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/v1Salvala. n8n verifica la credenziale chiamando
/modelssul Base URL. -
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.
-
Imposta il modello per ID. In Model passa dalla modalità From List a ID e inserisci
broadnet/glm-5.3. -
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.
-
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.
-
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.
