---
title: "SDK Python di OpenAI con un base_url personalizzato | BroadRouter"
description: "Collega l’SDK Python ufficiale di OpenAI a BroadNet Inference cambiando solo il base_url. Installazione, chiave, prima richiesta e risposta in streaming."
url: https://broadrouter.com/it/guides/openai-python-sdk/
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/openai-python-sdk/) (aggiornato il 2026-11-16).

# Usare l’SDK Python di OpenAI con BroadNet Inference

Aggiornato 2026-11-16

Installa il pacchetto openai, poi crea il client con base\_url impostato su https://inference.broadnet.ai/v1 e la tua chiave BroadNet come api\_key. Ogni chiamata chat.completions funziona senza modifiche; cambia solo l’ID del modello, per esempio broadnet/deepseek-v4.1-flash. BroadNet serve chat completions e trascrizioni, non la Responses API.

Ti servono un account BroadNet Inference e una chiave di inferenza. I nuovi account partono con $5 di credito e senza carta; [crealo su inference.broadnet.ai](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-openai-python-sdk&utm_content=body). La console mostra la chiave una sola volta e ne conserva solo l’hash, quindi copiala subito nel tuo ambiente.

## 1\. Installa e imposta la chiave

L’attuale pacchetto `openai` (3.x) richiede Python 3.10 o successivo.

```bash
python -m pip install openai
export BROADNET_API_KEY='paste-the-key-once'
```

## 2\. Fai una prima richiesta

Salva questo codice come `first_request.py`:

```python
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)

response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)
print(response.choices[0].message.content)
```

Eseguilo con `python first_request.py`. L’esempio usa `broadnet/gemma-4-26b-a4b` perché funziona con il credito gratuito. Gli altri modelli di chat sono disponibili dopo una ricarica.

## 3\. Passa al modello che ti serve

Cambia solo `model`:

| Ti serve | ID del modello |
| --- | --- |
| Illimitato con un piano flat, contesto da 1M | `broadnet/deepseek-v4.1-flash` |
| Strumenti e output strutturato, contesto da 1M | `broadnet/glm-5.3` |
| Testo e immagini in arabo | `broadnet/qwen3.8-27b` |
| Prezzo basso, funziona con il credito gratuito | `broadnet/gemma-4-26b-a4b` |

DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B ragionano prima di rispondere, e il ragionamento conta in `max_tokens`. Dai loro 1.000 token o più. [Ecco perché un limite basso restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).

## 4\. Ricevi la risposta in streaming

```python
stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash",
    stream=True,
    stream_options={"include_usage": True},
    messages=[{"role": "user", "content": "Count from one to three."}],
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:
        print("\n", chunk.usage)
```

Con `include_usage`, i conteggi dei token arrivano nell’ultimo chunk, che non ha `choices`. [La guida allo streaming](https://broadrouter.com/it/guides/streaming-chat-completions/) spiega come gestire le connessioni interrotte.

## 5\. Conserva l’ID della richiesta

Ogni risposta porta un header `X-Request-ID`. Registralo nei log: l’assistenza di BroadNet lo chiede. Le risposte già interpretate lo espongono come `response._request_id`. Per leggerlo insieme agli altri header:

```python
raw = client.chat.completions.with_raw_response.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Hi"}],
)
print(raw.headers.get("x-request-id"))
response = raw.parse()
```

Le chiavi a consumo consentono 30 richieste al minuto e 4 contemporanee. [Cosa significa ogni codice di errore e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/).

## Risoluzione dei problemi

-   **`AuthenticationError` (401).** La chiave è sbagliata, scaduta o ha esaurito la quota a consumo. Verifica che `BROADNET_API_KEY` sia impostata nel processo che esegue il codice.
-   **`NotFoundError` (404).** Verifica che `base_url` termini con `/v1` e che tu chiami `chat.completions`, non `responses`. Poi controlla l’ID del modello, con il prefisso `broadnet/`.
-   **Un modello a pagamento fallisce su un account nuovo.** Il credito iniziale di $5 copre BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) e i due modelli BroadNet Transcribe. Ricarica per usare gli altri modelli di chat: DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B.
-   **`content` vuoto.** Il ragionamento conta in `max_tokens`. Alzalo a 1.000 o più. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **`RateLimitError` (429).** Hai superato il limite al minuto o quello di concorrenza. Per impostazione predefinita l’SDK ritenta due volte; imposta `max_retries` sul client per cambiarlo.
-   **Errori del client HTTP personalizzato dopo l’aggiornamento.** L’SDK 3.x usa HTTPX2. Se passi un tuo `http_client`, segui la guida di migrazione a HTTPX2 dell’SDK.

## Termini in questa guida

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

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

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

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

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

[Output strutturato (structured output)](https://broadrouter.com/it/glossary/structured-output/)

L’output strutturato è una funzionalità delle API LLM che vincola la risposta di un modello a un formato indicato dallo sviluppatore, di solito un JSON Schema, così il codice può interpretarla in modo affidabile. È più rigoroso della JSON mode, che garantisce un JSON valido ma non una struttura precisa.

## Domande frequenti

### Mi serve un SDK diverso?

No. BroadNet Inference parla i formati chat completions e audio transcriptions di OpenAI, quindi il pacchetto ufficiale openai funziona con un base\_url diverso.

### Posso continuare a usare OPENAI\_API\_KEY?

Puoi, ma una variabile separata BROADNET\_API\_KEY evita di mandare per errore la chiave di un provider a un altro.

### L’SDK legge OPENAI\_BASE\_URL?

Sì. Se non passi base\_url, il client usa OPENAI\_BASE\_URL. Impostala su https://inference.broadnet.ai/v1, imposta OPENAI\_API\_KEY con la tua chiave BroadNet, e OpenAI() non ha bisogno di argomenti.

### Posso usare client.responses.create con BroadNet?

No. Il README dell’SDK parte dalla Responses API, ma la documentazione di BroadNet elenca solo chat completions e audio transcriptions. Usa client.chat.completions.create.

## Guide correlate

-   [Usare l’SDK Node.js di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-node-sdk/)
-   [Streaming delle chat completions e connessioni interrotte](https://broadrouter.com/it/guides/streaming-chat-completions/)
-   [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/)

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-openai-python-sdk&utm_content=page-cta) ·

**Fonti**

-   [Riferimento API di BroadNet Inference, prima richiesta (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-openai-python-sdk&utm_content=sources#base-url)
-   [Libreria Python di OpenAI su PyPI (3.x, Python 3.10+, verificata il 2026-11-14)](https://pypi.org/project/openai/)
