---
title: "SDK Node.js OpenAI avec une baseURL personnalisée | BroadRouter"
description: "Branchez le SDK officiel d’OpenAI pour Node.js et TypeScript sur BroadNet Inference via baseURL : installation, première requête, streaming et ID de requête."
url: https://broadrouter.com/fr/guides/openai-node-sdk/
lang: fr
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduit de l’anglais avec l’aide de l’IA. [Lire l’original en anglais](https://broadrouter.com/guides/openai-node-sdk/) (mis à jour le 2026-11-16).

# Utiliser le SDK Node.js d’OpenAI avec BroadNet Inference

Mis à jour 2026-11-16

Installez le paquet npm openai et créez le client avec baseURL défini sur https://inference.broadnet.ai/v1 et apiKey sur votre clé BroadNet. Votre code chat.completions existant continue de fonctionner ; changez seulement l’ID du modèle, par exemple broadnet/deepseek-v4.1-flash. BroadNet sert les chat completions, pas la Responses API : gardez client.chat.completions.create.

Il vous faut une clé d’inférence issue de [votre compte BroadNet Inference](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-openai-node-sdk&utm_content=body). Les nouveaux comptes démarrent avec $5 de crédit, sans carte. Si vous travaillez en Python, consultez [le guide du SDK Python](https://broadrouter.com/fr/guides/openai-python-sdk/).

## 1\. Installer et définir la clé

Le paquet `openai` actuel (7.x) nécessite Node.js 22 ou plus récent.

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

## 2\. Première requête

Enregistrez ceci sous `first-request.mjs` et lancez `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` fonctionne avec le crédit gratuit. Pour le modèle du forfait illimité, utilisez `broadnet/deepseek-v4.1-flash` et fixez `max_tokens` à 1 000 ou plus, car son raisonnement est décompté de la limite. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).

## 3\. Streamer les tokens

```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\. Journaliser l’ID de requête

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

Le SDK lit `request_id` dans l’en-tête `x-request-id`. Les réponses analysées le portent aussi sous `data._request_id`.

Conservez cet ID avec l’heure UTC, la route et le statut : le support de BroadNet vous les demandera. [Codes d’erreur et quand réessayer](https://broadrouter.com/fr/guides/errors-and-retries/).

## Dépannage

-   **401.** La clé est erronée, expirée ou son quota de paiement à l’usage est épuisé. Si `BROADNET_API_KEY` n’est pas définie, `apiKey` vaut `undefined` et le SDK se rabat sur `OPENAI_API_KEY`, ou lève une erreur si celle-ci manque aussi.
-   **404.** Vérifiez que `baseURL` se termine par `/v1` et que vous appelez `chat.completions`, pas `responses`. Vérifiez ensuite l’ID du modèle, avec le préfixe `broadnet/`.
-   **Un modèle payant échoue sur un nouveau compte.** Le crédit de départ de $5 couvre BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) et les deux modèles BroadNet Transcribe. Rechargez pour utiliser les autres modèles de chat : DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B.
-   **`content` vide.** Le raisonnement est décompté de `max_tokens`. Augmentez-le ou ne le définissez pas. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **429.** Une clé à l’usage autorise 30 requêtes par minute et 4 simultanées. Par défaut, le SDK réessaie deux fois ; ajustez `maxRetries` sur le client. Pour les flux interrompus, voir [streamer des chat completions](https://broadrouter.com/fr/guides/streaming-chat-completions/).

## Termes de ce guide

[Paiement à l’usage (pay-as-you-go)](https://broadrouter.com/fr/glossary/pay-as-you-go/)

Le paiement à l’usage (pay-as-you-go) est un modèle tarifaire où vous ne payez que ce que vous consommez, mesuré par unité, comme les tokens, les requêtes ou les minutes d’audio, sans abonnement ni engagement minimal. La plupart des API LLM facturent ainsi, à partir d’un solde prépayé ou d’une facture périodique.

[Concurrence (requêtes simultanées)](https://broadrouter.com/fr/glossary/concurrency/)

La concurrence est le nombre de requêtes qu’un client a en cours au même moment. Les API de LLM la plafonnent souvent par clé ou par forfait, indépendamment des requêtes par minute, car chaque requête ouverte occupe de la capacité GPU jusqu’à la fin de sa réponse.

[Limite de débit (rate limit)](https://broadrouter.com/fr/glossary/rate-limit/)

Une limite de débit (rate limit) est un plafond qu’une API impose à l’usage d’un client sur une période, par exemple en requêtes ou en tokens par minute. Les requêtes au-delà sont refusées, généralement avec HTTP 429 Too Many Requests, jusqu’à ce que l’usage repasse sous la limite.

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

Un token est l’unité de texte qu’un modèle de langage lit et écrit : un mot, une partie de mot, un signe de ponctuation ou une suite d’octets produite par le tokenizer du modèle. Les API LLM comptent, limitent et facturent généralement l’usage en tokens.

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

L’API Chat Completions est l’endpoint HTTP d’OpenAI, POST /v1/chat/completions, qui reçoit un nom de modèle et une liste de messages associés à un rôle, et renvoie le message suivant du modèle. Sa forme de requête et de réponse est devenue le format commun que reprennent les fournisseurs et SDK compatibles OpenAI.

[Clé d’API (API key)](https://broadrouter.com/fr/glossary/api-key/)

Une clé d’API est une chaîne secrète qui identifie et autorise un client qui appelle une API. Les API LLM l’attendent généralement dans un en-tête Authorization: Bearer, et quiconque détient la clé peut envoyer des requêtes facturées au compte qui la possède.

[Forfait LLM (flat rate)](https://broadrouter.com/fr/glossary/flat-rate-llm-plan/)

Un forfait LLM facture un prix fixe pour une période, par exemple un mois, en échange de l’accès à une API de modèle de langage, au lieu de facturer au token. Ces forfaits limitent généralement autre chose, comme la concurrence, la vitesse, les modèles ou des fenêtres d’usage : les plafonds comptent donc autant que le prix.

## Questions fréquentes

### Puis-je définir l’URL de base de BroadNet avec une variable d’environnement dans Node ?

Oui. Le SDK lit OPENAI\_BASE\_URL si vous ne passez pas baseURL, et OPENAI\_API\_KEY si vous ne passez pas apiKey. Passer les deux explicitement évite d’envoyer par erreur une clé BroadNet à OpenAI, ou l’inverse.

### Est-ce que client.responses.create fonctionne avec BroadNet ?

Non. La documentation de BroadNet ne mentionne que les chat completions et les audio transcriptions. Pour le chat, utilisez client.chat.completions.create.

### Quelle version de Node.js le paquet openai exige-t-il ?

La version 7.x actuelle déclare Node.js 22 ou plus récent. Deno, Bun, Cloudflare Workers et Vercel Edge sont également pris en charge.

### Puis-je appeler BroadNet depuis le navigateur avec le SDK Node ?

À éviter. Le SDK bloque l’usage dans le navigateur tant que vous ne définissez pas dangerouslyAllowBrowser, car la clé serait envoyée à chaque visiteur. Appelez plutôt BroadNet depuis votre serveur.

## Guides associés

-   [Utiliser le SDK Python d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-python-sdk/)
-   [Streamer des chat completions et gérer les connexions coupées](https://broadrouter.com/fr/guides/streaming-chat-completions/)
-   [Codes d’erreur de BroadNet Inference : quand réessayer ?](https://broadrouter.com/fr/guides/errors-and-retries/)

Essayez-le sur votre vraie charge de travail. Les nouveaux comptes démarrent avec USD 5 de crédit pour Gemma et transcription. DeepSeek, GLM et Qwen3.8 nécessitent une recharge.

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

**Sources**

-   [Référence de l’API de BroadNet Inference (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-openai-node-sdk&utm_content=sources)
-   [Bibliothèque Node.js d’OpenAI sur npm (7.x, Node.js 22+, consulté le 2026-11-14)](https://www.npmjs.com/package/openai)
-   [README d’openai-node, ID de requête et prérequis (consulté le 2026-11-14)](https://github.com/openai/openai-node)
