---
title: "SDK Node.js di OpenAI con un baseURL personalizzato | BroadRouter"
description: "Collega l’SDK ufficiale di OpenAI per Node.js e TypeScript a BroadNet Inference impostando baseURL. Installazione, prima richiesta, streaming e ID delle richieste."
url: https://broadrouter.com/it/guides/openai-node-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-node-sdk/) (aggiornato il 2026-11-16).

# Usare l’SDK Node.js di OpenAI con BroadNet Inference

Aggiornato 2026-11-16

Installa il pacchetto npm openai e crea il client con baseURL impostato su https://inference.broadnet.ai/v1 e apiKey con la tua chiave BroadNet. Il codice chat.completions che hai già continua a funzionare; cambia solo l’ID del modello, per esempio broadnet/deepseek-v4.1-flash. BroadNet serve chat completions, non la Responses API, quindi continua a usare client.chat.completions.create.

Ti serve una chiave di inferenza dal [tuo account BroadNet Inference](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-openai-node-sdk&utm_content=body). I nuovi account partono con $5 di credito e senza carta. Se invece usi Python, vedi [la guida all’SDK Python](https://broadrouter.com/it/guides/openai-python-sdk/).

## 1\. Installa e imposta la chiave

L’attuale pacchetto `openai` (7.x) richiede Node.js 22 o successivo.

```bash
npm install openai
export BROADNET_API_KEY='paste-the-key-once'
```

## 2\. Prima richiesta

Salva come `first-request.mjs` ed esegui `node first-request.mjs`:

```js
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://inference.broadnet.ai/v1",
  apiKey: process.env.BROADNET_API_KEY,
});

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

`broadnet/gemma-4-26b-a4b` funziona con il credito gratuito. Per il modello dei piani illimitati usa `broadnet/deepseek-v4.1-flash` e imposta `max_tokens` a 1.000 o più, perché il suo ragionamento conta nel limite. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).

## 3\. Streaming dei token

```js
const stream = await 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 await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
  if (chunk.usage) console.log("\n", chunk.usage);
}
```

## 4\. Registra l’ID della richiesta

```js
const { data, request_id } = await client.chat.completions
  .create({ model: "broadnet/gemma-4-26b-a4b", messages: [{ role: "user", content: "Hi" }] })
  .withResponse();
console.log(request_id, data.choices[0].message.content);
```

L’SDK legge `request_id` dall’header `x-request-id`. Le risposte già interpretate lo riportano anche come `data._request_id`.

Conserva quell’ID insieme all’ora UTC, alla route e allo stato: l’assistenza di BroadNet li chiede. [Codici di errore e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/).

## Risoluzione dei problemi

-   **401.** La chiave è sbagliata, scaduta o ha esaurito la quota a consumo. Se `BROADNET_API_KEY` non è impostata, `apiKey` vale `undefined` e l’SDK ripiega su `OPENAI_API_KEY`, oppure lancia un errore se manca anche quella.
-   **404.** Verifica che `baseURL` 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 o non impostarlo. [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 contemporanee. Per impostazione predefinita l’SDK ritenta due volte; regola `maxRetries` sul client. Per gli stream interrotti vedi [streaming delle chat completions](https://broadrouter.com/it/guides/streaming-chat-completions/).

## Termini in questa guida

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

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

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

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

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

[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 Node posso impostare la base URL di BroadNet con una variabile d’ambiente?

Sì. L’SDK legge OPENAI\_BASE\_URL quando non passi baseURL, e OPENAI\_API\_KEY quando non passi apiKey. Passarli entrambi in modo esplicito evita di mandare per errore una chiave BroadNet a OpenAI, o il contrario.

### client.responses.create funziona con BroadNet?

No. La documentazione di BroadNet elenca solo chat completions e audio transcriptions. Per la chat usa client.chat.completions.create.

### Quale versione di Node.js richiede il pacchetto openai?

L’attuale release 7.x dichiara Node.js 22 o successivo. Sono supportati anche Deno, Bun, Cloudflare Workers e Vercel Edge.

### Posso chiamare BroadNet dal browser con l’SDK Node?

Meglio di no. L’SDK blocca l’uso nel browser a meno che tu non imposti dangerouslyAllowBrowser, perché la chiave finirebbe a ogni visitatore. Chiama BroadNet dal tuo server.

## Guide correlate

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

**Fonti**

-   [Riferimento API di BroadNet Inference (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-openai-node-sdk&utm_content=sources)
-   [Libreria Node.js di OpenAI su npm (7.x, Node.js 22+, verificata il 2026-11-14)](https://www.npmjs.com/package/openai)
-   [README di openai-node, ID delle richieste e requisiti (verificato il 2026-11-14)](https://github.com/openai/openai-node)
