BroadRouter
Inizia

Collegare Langflow a BroadNet Inference

Aggiornato

In Langflow aggiungi il componente OpenAI dal bundle OpenAI. Scrivi in Model Name un ID BroadNet come broadnet/glm-5.3, incolla la tua chiave BroadNet e nelle impostazioni avanzate imposta OpenAI API Base su https://inference.broadnet.ai/v1. Non usare il model provider OpenAI Compatible: elenca i modelli da /v1/models, e quello di BroadNet elenca solo i modelli di trascrizione.

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

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

  2. Model Name. Clicca sul campo e scrivi broadnet/glm-5.3. Accetta valori personalizzati, quindi non sei limitato ai modelli OpenAI della lista.

  3. OpenAI API Key. Incolla la tua chiave BroadNet, oppure scegli una variabile globale che la contiene.

  4. Impostazioni avanzate. Apri i controlli del componente e imposta:

    Campo Valore
    OpenAI API Base https://inference.broadnet.ai/v1
    Max Tokens 4000
  5. 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.ai

    Una 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.ai a LANGFLOW_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 solo broadnet/gemma-4-26b-a4b e 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.

Domande frequenti

Perché il provider OpenAI Compatible non mostra GLM 5.3 o Qwen?

La documentazione di Langflow dice che quel provider scopre i modelli dalla route /v1/models dell’endpoint. Al nostro controllo del 16 novembre 2026, il /v1/models di BroadNet elencava solo i due modelli di trascrizione, quindi i modelli di chat non compaiono mai. Usa invece il componente OpenAI con un nome di modello digitato.

Posso scrivere un modello che non è nella lista del componente OpenAI?

Sì. Model Name è una combobox, che nelle definizioni degli input di Langflow significa che l’utente può inserire un valore personalizzato. Scrivi l’ID BroadNet completo, per esempio broadnet/glm-5.3.

Perché Langflow si rifiuta di inviare la mia chiave a BroadNet?

Langflow 1.13 non invia a un endpoint personalizzato una chiave API che arriva dall’ambiente del server, a meno che l’operatore non autorizzi l’host. Imposta LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS=inference.broadnet.ai, oppure incolla la chiave nel componente.

Il componente OpenAI di Langflow usa la Responses API?

No. Costruisce ChatOpenAI di LangChain, che per le richieste normali chiama chat completions. Nel nostro test ha chiamato /v1/chat/completions.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity