---
title: "OpenAI Node.js SDK mit eigener baseURL (BroadNet) | BroadRouter"
description: "Das offizielle OpenAI SDK für Node.js und TypeScript per baseURL auf BroadNet Inference umstellen: installieren, erste Anfrage, Tokens streamen, Request-IDs loggen."
url: https://broadrouter.com/de/guides/openai-node-sdk/
lang: de
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Mit KI-Unterstützung aus dem Englischen übersetzt. [Englisches Original lesen](https://broadrouter.com/guides/openai-node-sdk/) (aktualisiert am 2026-11-16).

# OpenAI Node.js SDK mit BroadNet Inference nutzen

Aktualisiert 2026-11-16

Installieren Sie das npm-Paket openai und erstellen Sie den Client mit baseURL = https://inference.broadnet.ai/v1 und Ihrem BroadNet-Schlüssel als apiKey. Ihr bestehender chat.completions-Code läuft weiter; ändern Sie nur die Modell-ID, etwa broadnet/deepseek-v4.1-flash. BroadNet bietet Chat Completions, nicht die Responses API, also bleiben Sie bei client.chat.completions.create.

Sie brauchen einen Inferenz-Schlüssel aus [Ihrem Konto bei BroadNet Inference](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-openai-node-sdk&utm_content=body). Neue Konten starten mit $5 Guthaben, ohne Karte. Wenn Sie stattdessen Python verwenden, lesen Sie [die Anleitung zum Python SDK](https://broadrouter.com/de/guides/openai-python-sdk/).

## 1\. Installieren und Schlüssel setzen

Das aktuelle Paket `openai` (7.x) erfordert Node.js 22 oder neuer.

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

## 2\. Erste Anfrage

Speichern Sie dies als `first-request.mjs` und starten Sie es mit `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` läuft mit dem kostenlosen Guthaben. Für das Modell des unbegrenzten Plans nehmen Sie `broadnet/deepseek-v4.1-flash` und setzen `max_tokens` auf 1.000 oder mehr, weil sein Reasoning zum Limit zählt. [Warum Antworten leer zurückkommen](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/).

## 3\. Tokens streamen

```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\. Die Request-ID loggen

```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);
```

Das SDK liest `request_id` aus dem Header `x-request-id`. Geparste Antworten enthalten sie außerdem als `data._request_id`.

Bewahren Sie diese ID zusammen mit Uhrzeit (UTC), Route und Status auf, denn der Support von BroadNet fragt danach. [Fehlercodes und wann ein Retry sinnvoll ist](https://broadrouter.com/de/guides/errors-and-retries/).

## Fehlerbehebung

-   **401.** Der Schlüssel ist falsch, abgelaufen oder das Pay-as-you-go-Kontingent ist aufgebraucht. Ist `BROADNET_API_KEY` nicht gesetzt, ist `apiKey` gleich `undefined`, und das SDK greift auf `OPENAI_API_KEY` zurück oder wirft einen Fehler, wenn auch diese Variable fehlt.
-   **404.** Prüfen Sie, ob `baseURL` auf `/v1` endet und ob Sie `chat.completions` aufrufen, nicht `responses`. Prüfen Sie danach die Modell-ID mit dem Präfix `broadnet/`.
-   **Kostenpflichtiges Modell schlägt bei einem neuen Konto fehl.** Das Startguthaben von $5 deckt BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) und die beiden Modelle von BroadNet Transcribe ab. Laden Sie auf, um die anderen Chatmodelle zu nutzen: DeepSeek V4.1 Flash, GLM 5.3 und Qwen3.8 27B.
-   **Leeres `content`.** Reasoning zählt zu `max_tokens`. Erhöhen Sie den Wert oder lassen Sie ihn ungesetzt. [Warum Antworten leer zurückkommen](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/).
-   **429.** Ein Pay-as-you-go-Schlüssel erlaubt 30 Anfragen pro Minute und 4 gleichzeitig. Das SDK versucht es standardmäßig zweimal erneut; passen Sie `maxRetries` am Client an. Zu abgebrochenen Streams siehe [Chat Completions streamen](https://broadrouter.com/de/guides/streaming-chat-completions/).

## Begriffe in dieser Anleitung

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

Ein Token ist die Texteinheit, die ein Sprachmodell liest und schreibt: ein Wort, ein Wortteil, ein Satzzeichen oder eine Bytefolge, die der Tokenizer des Modells erzeugt. LLM-APIs zählen, begrenzen und berechnen die Nutzung meist in Tokens.

[Pay-as-you-go](https://broadrouter.com/de/glossary/pay-as-you-go/)

Pay-as-you-go ist ein Preismodell, bei dem Sie nur für tatsächliche Nutzung zahlen, gemessen pro Einheit wie Tokens, Anfragen oder Audiominuten, ohne Abonnement oder Mindestabnahme. Die meisten LLM-APIs rechnen so ab, aus einem vorausbezahlten Guthaben oder per regelmäßiger Rechnung.

[Rate Limit (Ratenbegrenzung)](https://broadrouter.com/de/glossary/rate-limit/)

Ein Rate Limit ist eine Obergrenze, die eine API festlegt, wie stark ein Client sie in einem Zeitfenster nutzen darf, etwa Anfragen pro Minute oder Tokens pro Minute. Anfragen über dem Limit werden abgelehnt, meist mit HTTP 429 Too Many Requests, bis die Nutzung wieder darunter liegt.

[API-Schlüssel (API Key)](https://broadrouter.com/de/glossary/api-key/)

Ein API-Schlüssel ist eine geheime Zeichenfolge, die einen Client beim Aufruf einer API identifiziert und autorisiert. LLM-APIs erwarten ihn meist im Header Authorization: Bearer, und wer den Schlüssel besitzt, kann Anfragen stellen, die dem Konto des Inhabers berechnet werden.

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

Die Chat Completions API ist der HTTP-Endpoint von OpenAI, POST /v1/chat/completions, der einen Modellnamen und eine Liste von Nachrichten mit Rollen entgegennimmt und die nächste Nachricht des Modells zurückgibt. Ihr Format für Anfrage und Antwort wurde zum gemeinsamen Standard, den OpenAI-kompatible Anbieter und SDKs übernehmen.

[Concurrency (Parallelität)](https://broadrouter.com/de/glossary/concurrency/)

Concurrency (Parallelität) ist die Zahl der Anfragen, die ein Client gleichzeitig offen hat. LLM-APIs begrenzen sie oft pro Schlüssel oder Plan, getrennt von den Anfragen pro Minute, weil jede offene Anfrage GPU-Kapazität belegt, bis ihre Antwort fertig ist.

## Häufige Fragen

### Kann ich die Basis-URL von BroadNet in Node per Umgebungsvariable setzen?

Ja. Das SDK liest OPENAI\_BASE\_URL, wenn Sie keine baseURL übergeben, und OPENAI\_API\_KEY, wenn Sie keinen apiKey übergeben. Wenn Sie beides explizit setzen, senden Sie nicht versehentlich einen BroadNet-Schlüssel an OpenAI oder umgekehrt.

### Funktioniert client.responses.create mit BroadNet?

Nein. Die Dokumentation von BroadNet nennt nur Chat Completions und Audio-Transkription. Verwenden Sie für Chat client.chat.completions.create.

### Welche Node.js-Version braucht das Paket openai?

Das aktuelle Release 7.x setzt Node.js 22 oder neuer voraus. Deno, Bun, Cloudflare Workers und Vercel Edge werden ebenfalls unterstützt.

### Kann ich BroadNet mit dem Node SDK aus dem Browser aufrufen?

Lassen Sie es. Das SDK blockiert die Nutzung im Browser, solange Sie nicht dangerouslyAllowBrowser setzen, denn der Schlüssel würde an jeden Besucher ausgeliefert. Rufen Sie BroadNet stattdessen von Ihrem Server aus auf.

## Verwandte Anleitungen

-   [OpenAI Python SDK mit BroadNet Inference nutzen](https://broadrouter.com/de/guides/openai-python-sdk/)
-   [Chat Completions streamen und abgebrochene Verbindungen behandeln](https://broadrouter.com/de/guides/streaming-chat-completions/)
-   [Fehlercodes von BroadNet Inference: Wann ist ein Retry sinnvoll?](https://broadrouter.com/de/guides/errors-and-retries/)

Testen Sie es mit Ihrem echten Workload. Neue Konten starten mit USD 5 Guthaben für Gemma und Transkription. DeepSeek, GLM und Qwen3.8 erfordern eine Aufladung.

[Loslegen](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-openai-node-sdk&utm_content=page-cta) ·

**Quellen**

-   [API-Referenz von BroadNet Inference (auf Englisch)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-openai-node-sdk&utm_content=sources)
-   [OpenAI-Node.js-Bibliothek auf npm (7.x, Node.js 22+, geprüft am 2026-11-14)](https://www.npmjs.com/package/openai)
-   [README von openai-node, Request-IDs und Voraussetzungen (geprüft am 2026-11-14)](https://github.com/openai/openai-node)
