Langflow è un builder visuale open source per agenti e flow RAG. Il suo componente OpenAI ha un campo OpenAI API Base che, con le parole del componente stesso, permette di “use other APIs” (traduzione: usare altre API). BroadNet Inference serve le chat completions su https://inference.broadnet.ai/v1, quindi quel componente funziona con un ID di modello BroadNet digitato a mano. BroadRouter è il sito di BroadNet; questa guida segue la documentazione di Langflow 1.13.x e il codice sorgente del componente nella v1.13.2.
Configurazione
-
Aggiungi il componente. In un flow apri il pannello dei componenti e aggiungi OpenAI dal bundle OpenAI. Langflow 1.13.2 installa questo bundle insieme al pacchetto principale.
-
Model Name. Clicca sul campo e scrivi
broadnet/glm-5.3. Accetta valori personalizzati, quindi non sei limitato ai modelli OpenAI della lista. -
OpenAI API Key. Incolla la tua chiave BroadNet, oppure scegli una variabile globale che la contiene.
-
Impostazioni avanzate. Apri i controlli del componente e imposta:
Campo Valore OpenAI API Base https://inference.broadnet.ai/v1Max Tokens 4000 -
Avvialo. Collega un Chat Input e un Chat Output, apri il Playground e invia un messaggio. Se arriva una risposta, le impostazioni sono corrette.
Due controlli di Langflow che possono bloccare BroadNet
Langflow 1.13 ha la protezione SSRF attiva per impostazione predefinita. Contano due regole:
-
Chiavi dall’ambiente del server. Se la chiave API arriva dall’ambiente del server (per esempio una variabile globale caricata da una variabile d’ambiente), Langflow si rifiuta di inviarla a un endpoint non predefinito, a meno che l’host non sia in allowlist. L’operatore imposta:
export LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS=inference.broadnet.aiUna chiave scritta nel componente non è interessata.
-
Indirizzi privati. Loopback e IP privati sono bloccati, a meno che non siano in
LANGFLOW_SSRF_ALLOWED_HOSTS. BroadNet è un host HTTPS pubblico, quindi conta solo se lo instradi attraverso un proxy locale.
Perché non il provider OpenAI Compatible?
Langflow 1.13 ha anche un model provider OpenAI Compatible in Settings → Model Providers. La sua documentazione dice che valida la connessione sulla route /v1/models dell’endpoint e propone i modelli che trova. Al nostro controllo del 16 novembre 2026, il /v1/models di BroadNet elencava solo broadnet/cohere-transcribe-arabic e broadnet/cohere-transcribe, quindi lì i modelli di chat non si possono scegliere. Il nome di modello digitato nel componente OpenAI evita il problema.
Quale modello scegliere
| Flow | Modello |
|---|---|
| Componente Agent con strumenti | broadnet/glm-5.3 |
| Flow con immagini o testo in arabo, con strumenti | broadnet/qwen3.8-27b |
| Flow su documenti lunghi, piano a prezzo fisso | broadnet/deepseek-v4.1-flash |
| Provare Langflow con il credito iniziale | broadnet/gemma-4-26b-a4b (contesto da 32.768 token) |
La documentazione di BroadNet indica strumenti e output strutturato solo per GLM 5.3 e Qwen3.8 27B. La JSON Mode del componente invia response_format: {"type": "json_object"}; usala con questi due modelli. Prezzi di tutti i modelli.
Come l’abbiamo testato
Non abbiamo avviato l’interfaccia di Langflow. Il 2026-11-15 abbiamo installato lfx 1.13.2 e il bundle lfx-openai, il cui file del componente OpenAI corrisponde al sorgente della v1.13.2, e abbiamo costruito il componente in Python contro un mock server locale che riproduce il formato chat completions di BroadNet. Con una chiave digitata e LANGFLOW_SSRF_ALLOWED_HOSTS impostato per il mock locale, la richiesta è arrivata a /v1/chat/completions con l’ID del modello broadnet/glm-5.3 invariato, una chiave Bearer, temperature: 0.1 e un seed. Il valore di Max Tokens è stato inviato come max_completion_tokens; il riferimento API di BroadNet descrive max_tokens. Una chiave copiata dall’ambiente del server è stata rifiutata finché non abbiamo impostato anche LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS. Non avevamo una chiave BroadNet, quindi non abbiamo testato l’output reale dei modelli.
Risoluzione dei problemi
- “Refusing to send a server-provisioned API credential” (traduzione: rifiuto di inviare una credenziale API fornita dal server). Aggiungi
inference.broadnet.aiaLANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS, oppure scrivi la chiave nel componente. - 401. La chiave è sbagliata, scaduta o ha esaurito la quota.
- 404. OpenAI API Base deve finire con
/v1, e Model Name deve corrispondere esattamente all’ID di BroadNet. I modelli a pagamento richiedono una ricarica; il credito di $5 copre solobroadnet/gemma-4-26b-a4be i due modelli Transcribe. - Risposte vuote. Su DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B il ragionamento conta nel limite di output. Alza Max Tokens. Perché le risposte arrivano vuote.
- 429. Una chiave a consumo consente 30 richieste al minuto e 4 in corso contemporaneamente. Vedi errori e retry.
