---
title: "OpenAI Python SDK base_url 변경하기(BroadNet) | BroadRouter"
description: "공식 OpenAI Python SDK에서 base_url 하나만 바꿔 BroadNet Inference에 연결합니다. 설치, 키 설정, 첫 요청, 응답 스트리밍까지 순서대로 안내합니다."
url: https://broadrouter.com/ko/guides/openai-python-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-python-sdk/) (2026-11-16 업데이트).

# BroadNet Inference에서 OpenAI Python SDK 사용하기

업데이트 2026-11-16

OpenAI Python SDK를 BroadNet Inference에서 쓰려면 openai 패키지를 설치하고, base\_url을 https://inference.broadnet.ai/v1로, api\_key를 BroadNet 키로 지정해 클라이언트를 만드세요. chat.completions 호출은 그대로 작동하고 모델 ID만 바뀝니다(예: broadnet/deepseek-v4.1-flash). BroadNet은 chat completions와 transcriptions를 제공하며 Responses API는 제공하지 않습니다.

BroadNet Inference 계정과 추론 키가 필요합니다. 새 계정은 카드 없이 초기 크레딧($5)으로 시작합니다. [inference.broadnet.ai에서 계정을 만드세요](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-openai-python-sdk&utm_content=body). 콘솔은 키를 한 번만 보여 주고 해시만 저장하므로, 키를 바로 환경 변수에 복사해 두세요.

## 1\. 설치하고 키 설정하기

현재 `openai` 패키지(3.x)는 Python 3.10 이상이 필요합니다.

```bash
python -m pip install openai
export BROADNET_API_KEY='paste-the-key-once'
```

## 2\. 첫 요청 보내기

다음 코드를 `first_request.py`로 저장하세요.

```python
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)

response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)
print(response.choices[0].message.content)
```

`python first_request.py`로 실행하세요. 이 예제는 무료 크레딧으로 작동하는 `broadnet/gemma-4-26b-a4b` 모델을 씁니다. 다른 채팅 모델은 충전 후 쓸 수 있습니다.

## 3\. 원하는 모델로 바꾸기

`model`만 바꾸면 됩니다.

| 용도 | 모델 ID |
| --- | --- |
| 정액 플랜으로 무제한 사용, 100만 컨텍스트 | `broadnet/deepseek-v4.1-flash` |
| 도구 호출과 구조화된 출력, 100만 컨텍스트 | `broadnet/glm-5.3` |
| 아랍어 텍스트와 이미지 | `broadnet/qwen3.8-27b` |
| 낮은 가격, 무료 크레딧으로 사용 가능 | `broadnet/gemma-4-26b-a4b` |

DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B는 답하기 전에 추론하며, 추론도 `max_tokens`에 포함됩니다. 1,000토큰 이상을 주세요. [한도가 작으면 빈 응답이 나오는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.

## 4\. 답변 스트리밍하기

```python
stream = 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 chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:
        print("\n", chunk.usage)
```

`include_usage`를 켜면 토큰 수는 `choices`가 없는 마지막 청크로 전달됩니다. 연결이 끊기는 경우는 [스트리밍 가이드](https://broadrouter.com/ko/guides/streaming-chat-completions/)에서 다룹니다.

## 5\. 요청 ID 보관하기

모든 응답에는 `X-Request-ID` 헤더가 있습니다. BroadNet 지원팀이 이 값을 요청하므로 로그에 남겨 두세요. 파싱된 응답에서는 `response._request_id`로 확인할 수 있습니다. 다른 헤더와 함께 읽으려면 다음과 같이 하세요.

```python
raw = client.chat.completions.with_raw_response.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Hi"}],
)
print(raw.headers.get("x-request-id"))
response = raw.parse()
```

종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. [오류 코드별 의미와 재시도 시점](https://broadrouter.com/ko/guides/errors-and-retries/)을 참고하세요.

## 문제 해결

-   **`AuthenticationError` (401).** 키가 틀렸거나, 만료되었거나, 종량제 사용 가능 금액이 소진되었습니다. 코드를 실행하는 프로세스에 `BROADNET_API_KEY`가 설정되어 있는지 확인하세요.
-   **`NotFoundError` (404).** `base_url`이 `/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`에 포함됩니다. 1,000 이상으로 늘리세요. [답변이 비어 있는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.
-   **`RateLimitError` (429).** 분당 한도나 동시 처리 한도를 넘었습니다. SDK는 기본적으로 두 번 재시도합니다. 바꾸려면 클라이언트에 `max_retries`를 설정하세요.
-   **업그레이드 후 커스텀 HTTP 클라이언트 오류.** 3.x SDK는 HTTPX2를 씁니다. 직접 만든 `http_client`를 넘긴다면 SDK의 HTTPX2 마이그레이션 가이드를 따르세요.

## 이 가이드의 용어

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

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

[구조화된 출력(Structured output)](https://broadrouter.com/ko/glossary/structured-output/)

구조화된 출력(structured output)은 모델의 응답을 개발자가 지정한 형식, 주로 JSON Schema에 맞추도록 제한해 코드가 안정적으로 파싱할 수 있게 하는 LLM API 기능입니다. 유효한 JSON만 보장하고 특정 구조는 보장하지 않는 JSON 모드보다 더 엄격합니다.

[동시 처리(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가 반환됩니다.

## 자주 묻는 질문

### 다른 SDK가 필요한가요?

아닙니다. BroadNet Inference는 OpenAI chat completions와 audio transcriptions 형식을 따르므로, base\_url만 바꾸면 공식 openai 패키지가 그대로 작동합니다.

### OPENAI\_API\_KEY를 계속 써도 되나요?

써도 됩니다. 다만 BROADNET\_API\_KEY 변수를 따로 두면 한 제공업체의 키를 실수로 다른 업체에 보내는 일을 막을 수 있습니다.

### SDK가 OPENAI\_BASE\_URL을 읽나요?

네. base\_url을 넘기지 않으면 클라이언트는 OPENAI\_BASE\_URL을 씁니다. 이를 https://inference.broadnet.ai/v1로 설정하고 OPENAI\_API\_KEY에 BroadNet 키를 넣으면 OpenAI()를 인자 없이 호출할 수 있습니다.

### BroadNet에서 client.responses.create를 쓸 수 있나요?

아닙니다. SDK의 README는 Responses API를 먼저 소개하지만, BroadNet 문서에는 chat completions와 audio transcriptions만 나와 있습니다. client.chat.completions.create를 쓰세요.

## 관련 가이드

-   [BroadNet Inference에서 OpenAI Node.js SDK 사용하기](https://broadrouter.com/ko/guides/openai-node-sdk/)
-   [채팅 완성 스트리밍과 끊긴 연결 처리하기](https://broadrouter.com/ko/guides/streaming-chat-completions/)
-   [추론 모델이 빈 답변을 반환하는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)
-   [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-python-sdk&utm_content=page-cta) ·

**출처**

-   [BroadNet Inference API 레퍼런스, 첫 요청 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-openai-python-sdk&utm_content=sources#base-url)
-   [PyPI의 OpenAI Python 라이브러리(3.x, Python 3.10 이상, 2026-11-14 확인)](https://pypi.org/project/openai/)
