---
title: "LangChain ChatOpenAI con un base_url personalizzato | BroadRouter"
description: "Collega ChatOpenAI di LangChain a BroadNet Inference con base_url e api_key, e scopri cosa LangChain conserva e cosa scarta dei modelli di ragionamento."
url: https://broadrouter.com/it/guides/langchain-openai-base-url/
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/langchain-openai-base-url/) (aggiornato il 2026-11-16).

# Usare LangChain con BroadNet Inference

Aggiornato 2026-11-16

Installa langchain-openai e crea ChatOpenAI con base\_url impostato su https://inference.broadnet.ai/v1, la tua chiave BroadNet come api\_key e un ID di modello BroadNet, per esempio broadnet/glm-5.3. Invoke, streaming e catene con tool calling passano poi da chat completions. Evita le funzioni disponibili solo nella Responses API e lascia spazio al ragionamento in max\_tokens.

`ChatOpenAI` di LangChain accetta qualsiasi endpoint tramite `base_url`. Con BroadNet Inference funziona perché usa il formato standard di chat completions. Se invece chiami l’API direttamente, vedi [la guida all’SDK Python](https://broadrouter.com/it/guides/openai-python-sdk/).

## Installazione

Le versioni attuali di `langchain-openai` (1.x) richiedono Python 3.11 o successivo.

```bash
pip install -U langchain-openai
export BROADNET_API_KEY='paste-the-key-once'
```

## Connessione

```python
import os
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="broadnet/glm-5.3",
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=2000,  # reasoning counts toward this limit
)

print(llm.invoke("Summarise the CAP theorem in two sentences.").content)
```

`openai_api_base` è un alias di `base_url`. Se mancano entrambi, LangChain legge `OPENAI_API_BASE`, e poi il client `openai` sottostante legge `OPENAI_BASE_URL`. Il commento nel codice ricorda che il ragionamento conta nel limite di `max_tokens`.

## Cose da sapere

-   **Il testo del ragionamento non viene conservato.** La documentazione di LangChain dice che `ChatOpenAI` segue la specifica ufficiale di OpenAI e non conserva campi non standard come `reasoning_content`. Ricevi la risposta finale, che di solito è ciò che serve a una catena.
-   **Lascia spazio al ragionamento.** GLM 5.3, DeepSeek V4.1 Flash e Qwen3.8 27B ragionano prima di rispondere. Un `max_tokens` basso può restituire una risposta vuota. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **Usage in streaming.** Se configuri l’endpoint con `OPENAI_BASE_URL`, LangChain disattiva `stream_usage` per impostazione predefinita. Passa `stream_usage=True` se vuoi il conteggio dei token durante lo streaming. La documentazione di BroadNet dice che l’usage arriva nell’ultimo chunk, quando lo richiedi.
-   **Resta su chat completions.** BroadNet serve `/v1/chat/completions`, non la Responses API. Secondo la documentazione di LangChain, `ChatOpenAI` passa alla Responses API quando usi gli strumenti integrati di OpenAI (web search, file search, code interpreter e simili), lo stato della conversazione o il parametro `reasoning`. Lasciali fuori e non impostare `use_responses_api=True`.
-   **Nome del limite di token.** Secondo la documentazione di LangChain, `max_tokens` viene convertito internamente in `max_completion_tokens`. La documentazione di BroadNet descrive `max_tokens`. Se un limite sembra ignorato, controlla la richiesta che la tua app invia davvero.

## Quale modello per quale catena

| Catena | Modello |
| --- | --- |
| Tool calling e output strutturato | `broadnet/glm-5.3` |
| Documenti lunghi e agenti, piano illimitato | `broadnet/deepseek-v4.1-flash` |
| Testo in arabo o immagini | `broadnet/qwen3.8-27b` |

[Vedi i prezzi di tutti i modelli](https://broadrouter.com/it/pricing/).

## Risoluzione dei problemi

-   **401.** La chiave è sbagliata, scaduta o ha esaurito la quota a consumo. Se non hai passato `api_key`, LangChain ha usato `OPENAI_API_KEY`, che potrebbe contenere una chiave OpenAI.
-   **404 o “not found”.** Controlla che `base_url` finisca con `/v1` e che nulla instradi la chiamata verso la Responses API (vedi sopra). Poi verifica che l’ID del modello corrisponda esattamente a quello di BroadNet, con il prefisso `broadnet/`. I modelli a pagamento richiedono una ricarica; il credito di $5 copre `broadnet/gemma-4-26b-a4b` e i due modelli Transcribe.
-   **`content` vuoto.** Il ragionamento ha consumato il budget. Alza `max_tokens`. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **Le chiamate agli strumenti non partono mai.** Usa `broadnet/glm-5.3` o `broadnet/qwen3.8-27b`. La documentazione di BroadNet indica gli strumenti solo per questi due.
-   **429 in catene batch o parallele.** Una chiave a consumo consente 30 richieste al minuto e 4 in contemporanea. Imposta `max_concurrency` nella configurazione del runnable per `batch()`. Vedi [codici di errore e retry](https://broadrouter.com/it/guides/errors-and-retries/).

## Termini in questa guida

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

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

[Streaming](https://broadrouter.com/it/glossary/streaming/)

Lo streaming è un modo di restituire la risposta di un modello linguistico in piccoli pezzi mentre viene ancora generata, invece che in un’unica risposta alla fine. Le API compatibili con OpenAI trasmettono in streaming tramite server-sent event quando la richiesta imposta stream a true.

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

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

[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

### In ChatOpenAI uso base\_url o openai\_api\_base?

Indifferente. openai\_api\_base è un alias di base\_url. Se non passi nessuno dei due, LangChain controlla OPENAI\_API\_BASE, e poi il client openai legge OPENAI\_BASE\_URL.

### Posso impostare l’endpoint di BroadNet solo con le variabili d’ambiente?

Sì. Imposta OPENAI\_BASE\_URL su https://inference.broadnet.ai/v1 e OPENAI\_API\_KEY con la tua chiave BroadNet, poi crea ChatOpenAI indicando solo l’ID del modello. Passa stream\_usage=True se vuoi il conteggio dei token durante lo streaming.

### Perché LangChain scarta reasoning\_content dalle risposte di BroadNet?

La documentazione di LangChain dice che ChatOpenAI segue la specifica ufficiale di OpenAI e non estrae campi non standard come reasoning\_content. La risposta finale in content arriva comunque.

### ChatOpenAI con BroadNet supporta il tool calling?

Sì, tramite bind\_tools, sui modelli per cui BroadNet indica gli strumenti. Per il tool calling e with\_structured\_output usa broadnet/glm-5.3 o broadnet/qwen3.8-27b.

## Guide correlate

-   [Usare l’SDK Python di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-python-sdk/)
-   [Perché un modello di ragionamento restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/)
-   [Usare l’OpenAI Agents SDK con BroadNet Inference](https://broadrouter.com/it/guides/openai-agents-sdk-custom-provider/)
-   [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-langchain-openai-base-url&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di LangChain, integrazione ChatOpenAI (verificata il 2026-11-14)](https://docs.langchain.com/oss/python/integrations/chat/openai)
-   [PyPI, pacchetto langchain-openai (1.8, Python 3.11+, verificato il 2026-11-14)](https://pypi.org/project/langchain-openai/)
-   [Codice sorgente di langchain-openai, risoluzione del base URL in ChatOpenAI (verificato il 2026-11-16)](https://github.com/langchain-ai/langchain/blob/master/libs/partners/openai/langchain_openai/chat_models/base.py)
-   [Riferimento API di BroadNet Inference (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-langchain-openai-base-url&utm_content=sources)
