---
title: "OpenAI Node.js SDK の baseURL を変更して使う（BroadNet） | BroadRouter"
description: "公式の OpenAI Node.js / TypeScript SDK は、baseURL を設定するだけで BroadNet Inference に接続できます。インストール、最初のリクエスト、トークンのストリーミング、リクエスト ID の記録までを説明します。"
url: https://broadrouter.com/ja/guides/openai-node-sdk/
lang: ja
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

このページは英語の原文を 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、apiKey を BroadNet のキーにしてクライアントを作成します。既存の chat.completions のコードはそのまま動き、変えるのはモデル ID（例：broadnet/deepseek-v4.1-flash）だけです。BroadNet は Responses API ではなくチャット補完を提供しているので、client.chat.completions.create を使い続けてください。

[BroadNet Inference のアカウント](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-openai-node-sdk&utm_content=body)で発行した推論キーが必要です。新規アカウントは $5 のクレジット付きで始まり、カードは不要です。Python を使う場合は [Python SDK のガイド](https://broadrouter.com/ja/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` を 1,000 以上にしてください。推論も上限に数えられるためです。[回答が空で返る理由](https://broadrouter.com/ja/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/ja/guides/errors-and-retries/)。

## トラブルシューティング

-   **401。** キーが間違っている、期限切れ、または従量課金の利用枠を使い切っています。`BROADNET_API_KEY` が未設定だと `apiKey` は `undefined` になり、SDK は `OPENAI_API_KEY` を使います。それもなければ例外を投げます。
-   **404。** `baseURL` が `/v1` で終わっているか、`responses` ではなく `chat.completions` を呼んでいるかを確認してください。次に、`broadnet/` 接頭辞を含むモデル ID を確認してください。
-   **新しいアカウントで有料モデルが失敗する。** $5 の初回クレジットで使えるのは BroadNet Gemma 4 VL 26B（`broadnet/gemma-4-26b-a4b`）と 2 つの BroadNet Transcribe モデルです。ほかのチャットモデル（DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B）を使うにはチャージしてください。
-   **`content` が空。** 推論は `max_tokens` に数えられます。上げるか、指定しないでください。[回答が空で返る理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。
-   **429。** 従量課金のキーは毎分 30 リクエスト、同時 4 リクエストまでです。SDK はデフォルトで 2 回リトライします。クライアントの `maxRetries` で調整してください。途中で切れたストリームについては [chat completions のストリーミング](https://broadrouter.com/ja/guides/streaming-chat-completions/)を参照してください。

## このガイドの用語

[従量課金（pay-as-you-go）](https://broadrouter.com/ja/glossary/pay-as-you-go/)

従量課金とは、使った分だけを支払う料金体系です。トークン、リクエスト、音声の分数などの単位で計測され、サブスクリプションや最低利用額はありません。多くの LLM API はこの方式で、前払いの残高か定期的な請求書から支払います。

[API キー（API key）](https://broadrouter.com/ja/glossary/api-key/)

API キーとは、API を呼び出すクライアントを識別し、認可するための秘密の文字列です。LLM API では通常 Authorization: Bearer ヘッダーで送り、キーを持つ人は誰でも、そのキーの所有アカウントに課金されるリクエストを送れます。

[Chat Completions API（チャット補完 API）](https://broadrouter.com/ja/glossary/chat-completions-api/)

Chat Completions API とは、OpenAI の HTTP エンドポイント POST /v1/chat/completions で、モデル名とロール付きメッセージのリストを受け取り、モデルの次のメッセージを返します。そのリクエストと応答の形は、OpenAI 互換のプロバイダーや SDK が使う共通形式になりました。

[トークン（token）](https://broadrouter.com/ja/glossary/token/)

トークンとは、言語モデルが読み書きするテキストの単位です。モデルのトークナイザーが作る単語、単語の一部、句読点、バイト列のいずれかにあたります。LLM API は利用量をトークンで数え、上限を設け、通常はトークン単位で課金します。

[プリペイドクレジット（prepaid credit）](https://broadrouter.com/ja/glossary/prepaid-credit/)

プリペイドクレジットとは、使用前に API アカウントに入金しておくお金です。リクエストごとに費用が残高から差し引かれ、残高がなくなると、チャージするまで従量課金のリクエストは止まります。支出は支払った額までに抑えられます。

[レート制限（rate limit）](https://broadrouter.com/ja/glossary/rate-limit/)

レート制限とは、1 分あたりのリクエスト数やトークン数など、一定時間内にクライアントが API を使える量に API 側が設ける上限です。上限を超えたリクエストは、使用量が下回るまで通常 HTTP 429 Too Many Requests で拒否されます。

[同時実行数（concurrency）](https://broadrouter.com/ja/glossary/concurrency/)

同時実行数（concurrency）とは、クライアントが同時に処理中にしているリクエストの数です。開いているリクエストは応答が終わるまで GPU の容量を占有するため、LLM API は毎分リクエスト数とは別に、キーやプランごとにこれを制限することがよくあります。

## よくある質問

### Node で BroadNet のベース URL を環境変数で設定できますか？

はい。SDK は、baseURL を渡さなければ OPENAI\_BASE\_URL を、apiKey を渡さなければ OPENAI\_API\_KEY を読みます。両方を明示的に渡しておくと、BroadNet のキーを誤って OpenAI に送ったり、その逆が起きたりするのを防げます。

### client.responses.create は BroadNet で動きますか？

いいえ。BroadNet のドキュメントにあるのはチャット補完と音声の文字起こしだけです。チャットには client.chat.completions.create を使ってください。

### openai パッケージに必要な Node.js のバージョンは？

現在の 7.x リリースは Node.js 22 以上を要件としています。Deno、Bun、Cloudflare Workers、Vercel Edge にも対応しています。

### Node SDK でブラウザーから BroadNet を呼び出せますか？

やめてください。キーがすべての訪問者に配布されてしまうため、SDK は dangerouslyAllowBrowser を設定しない限りブラウザーでの利用をブロックします。BroadNet はサーバーから呼び出してください。

## 関連ガイド

-   [OpenAI Python SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-python-sdk/)
-   [chat completions のストリーミングと接続切断への対処](https://broadrouter.com/ja/guides/streaming-chat-completions/)
-   [BroadNet Inference のエラーコードとリトライすべき場合](https://broadrouter.com/ja/guides/errors-and-retries/)

実際のワークロードで試してください。 新規アカウントには US$5 の初回クレジットがあり、Gemma、文字起こし に使えます。DeepSeek、GLM、Qwen3.8 はチャージが必要です。

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

**出典**

-   [BroadNet Inference API リファレンス （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-openai-node-sdk&utm_content=sources)
-   [npm の OpenAI Node.js ライブラリ（7.x、Node.js 22 以上、2026-11-14 確認）](https://www.npmjs.com/package/openai)
-   [openai-node の README、リクエスト ID と動作要件（2026-11-14 確認）](https://github.com/openai/openai-node)
