---
title: "OpenAI Node.js SDK baseURL 변경하기(BroadNet) | BroadRouter"
description: "공식 OpenAI Node.js·TypeScript SDK의 baseURL을 BroadNet Inference로 지정합니다. 설치, 첫 요청, 토큰 스트리밍, 요청 ID 로깅까지 안내합니다."
url: https://broadrouter.com/ko/guides/openai-node-sdk/
lang: ko
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 업데이트).

# BroadNet Inference에서 OpenAI Node.js SDK 사용하기

업데이트 2026-11-16

OpenAI Node.js SDK를 BroadNet Inference에서 쓰려면 openai npm 패키지를 설치하고, baseURL을 https://inference.broadnet.ai/v1로, apiKey를 BroadNet 키로 지정해 클라이언트를 만드세요. 기존 chat.completions 코드는 그대로 작동하며 모델 ID만 바꾸면 됩니다(예: broadnet/deepseek-v4.1-flash). BroadNet은 Responses API가 아니라 chat completions를 제공하므로 client.chat.completions.create를 계속 쓰세요.

[BroadNet Inference 계정](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-openai-node-sdk&utm_content=body)에서 발급한 추론 키가 필요합니다. 새 계정은 카드 없이 초기 크레딧($5)으로 시작합니다. Python을 쓴다면 [Python SDK 가이드](https://broadrouter.com/ko/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/ko/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는 `x-request-id` 헤더에서 `request_id`를 읽습니다. 파싱된 응답에도 `data._request_id`로 들어 있습니다.

이 ID를 UTC 시각, 경로, 상태 코드와 함께 보관하세요. BroadNet 지원팀이 이 정보를 요청합니다. [오류 코드와 재시도 시점](https://broadrouter.com/ko/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`)와 BroadNet Transcribe 모델 2종에 적용됩니다. 다른 채팅 모델(DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B)을 쓰려면 충전하세요.
-   **비어 있는 `content`.** 추론은 `max_tokens`에 포함됩니다. 값을 늘리거나 지정하지 마세요. [답변이 비어 있는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.
-   **429.** 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. SDK는 기본적으로 두 번 재시도하며, 클라이언트의 `maxRetries`로 조정할 수 있습니다. 스트림이 끊기는 경우는 [채팅 완성 스트리밍](https://broadrouter.com/ko/guides/streaming-chat-completions/)을 참고하세요.

## 이 가이드의 용어

[종량제(Pay-as-you-go)](https://broadrouter.com/ko/glossary/pay-as-you-go/)

종량제(pay-as-you-go)는 구독이나 최소 약정 없이 토큰, 요청, 오디오 분 같은 단위로 사용량을 측정해 쓴 만큼만 내는 요금 방식입니다. 대부분의 LLM API가 선불 잔액에서 차감하거나 정기 청구서를 발행하는 식으로 이렇게 과금합니다.

[동시 처리(concurrency)](https://broadrouter.com/ko/glossary/concurrency/)

동시 처리(concurrency)는 클라이언트가 같은 시점에 진행 중인 요청 수입니다. LLM API는 분당 요청 수와 별도로 키나 플랜마다 이를 제한하는 경우가 많습니다. 열려 있는 요청은 응답이 끝날 때까지 GPU 용량을 차지하기 때문입니다.

[속도 제한(rate limit)](https://broadrouter.com/ko/glossary/rate-limit/)

속도 제한(rate limit)은 API가 일정 시간 동안 클라이언트가 사용할 수 있는 양에 두는 상한으로, 분당 요청 수나 분당 토큰 수 같은 기준이 있습니다. 한도를 넘은 요청은 사용량이 다시 한도 아래로 내려갈 때까지 거부되며, 보통 HTTP 429 Too Many Requests가 반환됩니다.

## 자주 묻는 질문

### Node에서 BroadNet base URL을 환경 변수로 설정할 수 있나요?

네. SDK는 baseURL을 넘기지 않으면 OPENAI\_BASE\_URL을, apiKey를 넘기지 않으면 OPENAI\_API\_KEY를 읽습니다. 두 값을 명시적으로 넘기면 BroadNet 키를 OpenAI로, 또는 그 반대로 실수로 보내는 일을 막을 수 있습니다.

### BroadNet에서 client.responses.create가 작동하나요?

아닙니다. BroadNet 문서에는 chat completions와 audio transcriptions만 나와 있습니다. 채팅에는 client.chat.completions.create를 쓰세요.

### openai 패키지에는 어떤 Node.js 버전이 필요한가요?

현재 7.x 릴리스는 Node.js 22 이상을 요구합니다. Deno, Bun, Cloudflare Workers, Vercel Edge도 지원합니다.

### Node SDK로 브라우저에서 BroadNet을 호출해도 되나요?

그러지 마세요. 키가 모든 방문자에게 전달되기 때문에 SDK는 dangerouslyAllowBrowser를 설정하지 않는 한 브라우저 사용을 막습니다. 대신 서버에서 BroadNet을 호출하세요.

## 관련 가이드

-   [BroadNet Inference에서 OpenAI Python SDK 사용하기](https://broadrouter.com/ko/guides/openai-python-sdk/)
-   [채팅 완성 스트리밍과 끊긴 연결 처리하기](https://broadrouter.com/ko/guides/streaming-chat-completions/)
-   [BroadNet Inference 오류 코드와 재시도해야 하는 경우](https://broadrouter.com/ko/guides/errors-and-retries/)

실제 워크로드로 테스트해 보세요. 신규 계정에는 US$5 상당의 초기 크레딧이 제공되며 Gemma 및 음성 전사에 사용할 수 있습니다. DeepSeek, GLM 및 Qwen3.8 모델은 충전이 필요합니다.

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

**출처**

-   [BroadNet Inference API 레퍼런스 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-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)
