---
title: "Langflow: componente OpenAI con API base custom | BroadRouter"
description: "Usa BroadNet Inference in Langflow con il campo OpenAI API Base del componente OpenAI e un nome di modello digitato, e scopri perché OpenAI Compatible non lo elenca."
url: https://broadrouter.com/it/guides/langflow-openai-compatible/
lang: it
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/guides/langflow-openai-compatible/) (aggiornato il 2026-11-16).

# Collegare Langflow a BroadNet Inference

Aggiornato 2026-11-16

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:
    
    ```bash
    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](https://broadrouter.com/it/pricing/).

## 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](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **429.** Una chiave a consumo consente 30 richieste al minuto e 4 in corso contemporaneamente. Vedi [errori e retry](https://broadrouter.com/it/guides/errors-and-retries/).

## Termini in questa guida

[Token](https://broadrouter.com/it/glossary/token/)

Un token è l’unità di testo che un modello linguistico legge e scrive: una parola, una parte di parola, un segno di punteggiatura o una sequenza di byte prodotta dal tokenizer del modello. Le API LLM contano, limitano e di solito fatturano l’uso in token.

[Pagamento a consumo (pay-as-you-go)](https://broadrouter.com/it/glossary/pay-as-you-go/)

Il pagamento a consumo è un modello di prezzo in cui paghi solo ciò che usi, misurato per unità come token, richieste o minuti di audio, senza abbonamento né impegno minimo. La maggior parte delle API LLM fattura così, da un saldo prepagato o con una fattura periodica.

[Tool calling (chiamata di strumenti)](https://broadrouter.com/it/glossary/tool-calling/)

Il tool calling, detto anche function calling, è una funzionalità delle API LLM in cui il modello restituisce una richiesta strutturata di eseguire una funzione definita dallo sviluppatore, con argomenti JSON. L’applicazione esegue la funzione e rimanda il risultato; il modello non esegue mai codice da solo.

[Chat Completions API](https://broadrouter.com/it/glossary/chat-completions-api/)

La Chat Completions API è l’endpoint HTTP di OpenAI, POST /v1/chat/completions, che riceve il nome di un modello e una lista di messaggi con un ruolo e restituisce il messaggio successivo del modello. La forma della sua richiesta e risposta è diventata il formato comune che riusano provider e SDK compatibili con OpenAI.

[Chiave API (API key)](https://broadrouter.com/it/glossary/api-key/)

Una chiave API è una stringa segreta che identifica e autorizza un client che chiama un’API. Le API LLM di solito la vogliono in un header Authorization: Bearer, e chiunque possieda la chiave può fare richieste fatturate all’account a cui appartiene.

[Concorrenza (concurrency)](https://broadrouter.com/it/glossary/concurrency/)

La concorrenza è il numero di richieste che un client ha in corso nello stesso momento. Le API LLM spesso la limitano per chiave o per piano, separatamente dalle richieste al minuto, perché ogni richiesta aperta occupa capacità GPU finché la sua risposta non è terminata.

[Rate limit (limite di frequenza)](https://broadrouter.com/it/glossary/rate-limit/)

Un rate limit è un tetto che un’API pone a quanto un client può usarla in un intervallo di tempo, per esempio richieste al minuto o token al minuto. Le richieste oltre il limite vengono rifiutate, di solito con HTTP 429 Too Many Requests, finché l’uso non torna sotto la soglia.

[Credito prepagato (prepaid credit)](https://broadrouter.com/it/glossary/prepaid-credit/)

Il credito prepagato è denaro aggiunto a un account API prima dell’uso. Ogni richiesta scala il proprio costo dal saldo e, quando il saldo si esaurisce, le richieste a consumo si fermano finché non ricarichi. Limita la spesa a quanto hai versato.

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

## Guide correlate

-   [Collegare Flowise a BroadNet Inference (OpenAI Custom Model)](https://broadrouter.com/it/guides/flowise-openai-compatible/)
-   [BroadNet Inference in Dify con il plugin OpenAI-API-compatible](https://broadrouter.com/it/guides/dify-openai-api-compatible/)
-   [Usare LangChain con BroadNet Inference](https://broadrouter.com/it/guides/langchain-openai-base-url/)
-   [Perché un modello di ragionamento restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/)
-   [Tutti gli strumenti che funzionano con BroadNet Inference (in inglese)](https://broadrouter.com/integrations/): SDK, agenti di coding, interfacce di chat e strumenti di automazione, con le impostazioni esatte per ciascuno

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

[Inizia](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-langflow-openai-compatible&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di Langflow 1.13.x, bundle OpenAI (verificata il 2026-11-15)](https://docs.langflow.org/bundles-openai)
-   [Documentazione di Langflow 1.13.x, provider OpenAI Compatible (verificata il 2026-11-15)](https://docs.langflow.org/bundles-openai-compatible)
-   [Codice sorgente di Langflow, componente OpenAI alla v1.13.2 (verificato il 2026-11-15)](https://github.com/langflow-ai/langflow/blob/v1.13.2/src/bundles/openai/src/lfx_openai/components/openai/openai_chat_model.py)
-   [Documentazione di Langflow, protezione SSRF (verificata il 2026-11-16)](https://docs.langflow.org/api-keys-and-authentication#ssrf-protection)
-   [Riferimento API di BroadNet Inference (verificato il 2026-11-15) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-langflow-openai-compatible&utm_content=sources)
