---
title: "OpenAI Node.js SDK со своим baseURL (BroadNet) | BroadRouter"
description: "Как подключить официальный OpenAI SDK для Node.js и TypeScript к BroadNet Inference через baseURL: установка, первый запрос, стриминг и ID запросов."
url: https://broadrouter.com/ru/guides/openai-node-sdk/
lang: ru
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/guides/openai-node-sdk/) (обновлён 2026-11-16).

# OpenAI Node.js SDK и BroadNet Inference

Обновлено 2026-11-16

Установите npm-пакет openai и создайте клиент с baseURL https://inference.broadnet.ai/v1 и ключом BroadNet в apiKey. Ваш код с chat.completions продолжит работать; меняется только ID модели, например broadnet/deepseek-v4.1-flash. BroadNet обслуживает chat completions, а не Responses API, поэтому вызывайте client.chat.completions.create.

Вам нужен ключ для инференса из [вашего аккаунта BroadNet Inference](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-openai-node-sdk&utm_content=body). Новые аккаунты получают $5 стартового гранта без привязки карты. Если вы пишете на Python, откройте [руководство по Python SDK](https://broadrouter.com/ru/guides/openai-python-sdk/).

## 1\. Установите пакет и задайте ключ

Текущей версии пакета `openai` (7.x) нужен Node.js 22 или новее.

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

## 2\. Первый запрос

Сохраните код в файл `first-request.mjs` и запустите `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` работает на бесплатном гранте. Для модели безлимитных тарифов используйте `broadnet/deepseek-v4.1-flash` и задайте `max_tokens` не меньше 1000: её рассуждения расходуют этот лимит. [Почему ответы приходят пустыми](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/).

## 3\. Стриминг токенов

```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\. Записывайте ID запроса

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

SDK берёт `request_id` из заголовка `x-request-id`. У разобранных ответов он также доступен как `data._request_id`.

Храните этот ID вместе со временем UTC, маршрутом и статусом: их попросит поддержка BroadNet. [Коды ошибок и когда повторять запрос](https://broadrouter.com/ru/guides/errors-and-retries/).

## Решение проблем

-   **401.** Ключ неверен, истёк или исчерпан лимит оплаты по факту. Если `BROADNET_API_KEY` не задана, `apiKey` равен `undefined`, и SDK берёт `OPENAI_API_KEY`, а если нет и её, выбрасывает ошибку.
-   **404.** Проверьте, что `baseURL` заканчивается на `/v1` и что вы вызываете `chat.completions`, а не `responses`. Затем проверьте ID модели с префиксом `broadnet/`.
-   **Платная модель не работает на новом аккаунте.** Стартовый грант $5 покрывает BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) и обе модели BroadNet Transcribe. Чтобы пользоваться другими чат-моделями — DeepSeek V4.1 Flash, GLM 5.3 и Qwen3.8 27B, — пополните баланс.
-   **Пустой `content`.** Рассуждения расходуют `max_tokens`. Поднимите лимит или не задавайте его. [Почему ответы приходят пустыми](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/).
-   **429.** Ключ с оплатой по факту допускает 30 запросов в минуту, а одновременно — не больше 4. По умолчанию SDK повторяет запрос дважды; это настраивается через `maxRetries` у клиента. Об оборванных потоках — в руководстве [стриминг chat completions](https://broadrouter.com/ru/guides/streaming-chat-completions/).

## Термины в этом руководстве

[Лимит запросов (rate limit)](https://broadrouter.com/ru/glossary/rate-limit/)

Лимит запросов (rate limit) — это ограничение, которое API накладывает на объём использования клиентом за отрезок времени, например число запросов или токенов в минуту. Запросы сверх лимита отклоняются, обычно с HTTP 429 Too Many Requests, пока использование снова не опустится ниже порога.

[Оплата по факту (pay-as-you-go)](https://broadrouter.com/ru/glossary/pay-as-you-go/)

Оплата по факту (pay-as-you-go) — это модель ценообразования, при которой вы платите только за то, что использовали, по счётчику в единицах вроде токенов, запросов или минут аудио, без подписки и минимальных обязательств. Так тарифицирует большинство LLM API — с предоплаченного баланса или по периодическому счёту.

[Параллельность (concurrency)](https://broadrouter.com/ru/glossary/concurrency/)

Параллельность (concurrency) — это число запросов, которые клиент одновременно держит в работе. LLM API часто ограничивают её на ключ или тариф отдельно от лимита запросов в минуту, потому что каждый открытый запрос занимает мощности GPU, пока ответ не будет готов.

[Стриминг (streaming)](https://broadrouter.com/ru/glossary/streaming/)

Стриминг — это способ возвращать ответ языковой модели небольшими частями (чанками) прямо во время генерации, а не одним ответом в конце. OpenAI-совместимые API передают поток через server-sent events, если в запросе stream равен true.

[API-ключ (API key)](https://broadrouter.com/ru/glossary/api-key/)

API-ключ — это секретная строка, которая идентифицирует и авторизует клиента, вызывающего API. LLM API обычно ожидают его в заголовке Authorization: Bearer, и любой, у кого есть ключ, может отправлять запросы, оплачиваемые аккаунтом владельца ключа.

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

Chat Completions API — это HTTP-эндпоинт OpenAI, POST /v1/chat/completions, который принимает имя модели и список сообщений с ролями и возвращает следующее сообщение модели. Формат его запроса и ответа стал общим стандартом, который повторяют OpenAI-совместимые провайдеры и SDK.

## Вопросы и ответы

### Можно ли задать базовый URL BroadNet через переменную окружения в Node?

Да. SDK читает OPENAI\_BASE\_URL, если не передан baseURL, и OPENAI\_API\_KEY, если не передан apiKey. Если передавать оба значения явно, ключ BroadNet не уйдёт по ошибке в OpenAI, и наоборот.

### Работает ли client.responses.create с BroadNet?

Нет. В документации BroadNet перечислены только chat completions и audio transcriptions. Для чата используйте client.chat.completions.create.

### Какая версия Node.js нужна пакету openai?

Текущий релиз 7.x требует Node.js 22 или новее. Также поддерживаются Deno, Bun, Cloudflare Workers и Vercel Edge.

### Можно ли вызывать BroadNet из браузера через Node SDK?

Не стоит. SDK блокирует работу в браузере, пока вы не зададите dangerouslyAllowBrowser, потому что ключ попадёт к каждому посетителю. Вызывайте BroadNet со своего сервера.

## Похожие руководства

-   [OpenAI Python SDK и BroadNet Inference](https://broadrouter.com/ru/guides/openai-python-sdk/)
-   [Стриминг chat completions и обрыв соединения](https://broadrouter.com/ru/guides/streaming-chat-completions/)
-   [Коды ошибок BroadNet Inference и когда повторять запрос](https://broadrouter.com/ru/guides/errors-and-retries/)

Проверьте на своей реальной нагрузке. Новые аккаунты получают стартовый грант US$5 на Gemma и распознавание речи. Для DeepSeek, GLM и Qwen3.8 нужно пополнить баланс.

[Начать](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-openai-node-sdk&utm_content=page-cta) ·

**Источники**

-   [Справочник API BroadNet Inference (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-openai-node-sdk&utm_content=sources)
-   [Библиотека OpenAI для Node.js в npm (7.x, Node.js 22+, дата обращения 2026-11-14)](https://www.npmjs.com/package/openai)
-   [README openai-node: ID запросов и требования (дата обращения 2026-11-14)](https://github.com/openai/openai-node)
