---
title: "BroadNet Inference 개발자 빠른 시작: Python과 cURL | BroadRouter"
description: "Python 또는 cURL로 BroadNet Inference에 첫 채팅 요청과 음성 전사 요청을 보내고, 선택한 모델의 마이그레이션 체크리스트를 확인하세요."
url: https://broadrouter.com/ko/developers/
lang: ko
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

# 개발자

업데이트 2026-11-15

BroadNet Inference는 `https://inference.broadnet.ai/v1`에서 OpenAI 요청 형식을 사용합니다. 콘솔에서 키를 만들어 환경 변수에 저장하고, 정확한 모델 ID와 함께 `/chat/completions` 또는 `/audio/transcriptions`로 요청을 보내세요. 프로덕션 트래픽을 옮기기 전에 해당 모델의 파라미터, 스트리밍, 도구, 한도, 오류를 확인하세요.

-   채팅 빠른 시작
-   음성 전사 빠른 시작
-   모델 ID
-   마이그레이션 체크리스트
-   오류와 재시도
-   문서와 가이드

## 첫 채팅 요청은 어떻게 보내나요?

1.  [inference.broadnet.ai (영어)](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-developers&utm_content=quickstart-account)에 로그인해 추론 키를 만듭니다. 키는 한 번만 표시되며, 콘솔에는 해시만 저장됩니다.
2.  OpenAI SDK를 설치하고 셸에서 키를 설정합니다. 키는 서버에만 두고, 브라우저 코드에는 절대 넣지 마세요.
3.  요청을 보냅니다. 답변은 `choices[0].message.content`에서 읽습니다.

setup

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

first\_request.py

```
import os
from openai import OpenAI

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

request.sh

```
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","messages":[{"role":"user","content":"Reply with one short sentence."}]}'
```

이 예제는 BroadNet Gemma 4 VL 26B 모델을 사용하며, US$5 상당의 초기 크레딧으로 이용할 수 있습니다. DeepSeek V4.1 Flash, GLM 5.3 및 Qwen3.8 27B 모델은 먼저 충전해야 합니다. 지원 문의에 대비해 응답 헤더의 `X-Request-ID` 값을 보관하세요.

How a request reaches a model

1.  01**Your app**Key kept in an environment variable
    
2.  02**OpenAI SDK**Two settings change
    
    `base_url` `api_key`
    
3.  03**BroadNet Inference**OpenAI-compatible API`inference.broadnet.ai/v1``POST /chat/completions`
    
4.  04**The model you name**Set in every request
    
    -   `broadnet/deepseek-v4.1-flash`
    -   `broadnet/glm-5.3`
    -   `broadnet/qwen3.8-27b`
    -   `broadnet/gemma-4-26b-a4b`your choice
    
5.  05**Response**From that model
    

You choose the model in each request. There is no automatic routing: the request runs on the model ID you sent.

Your app calls the OpenAI SDK with BroadNet’s base URL and your key. The request goes to BroadNet Inference with the model ID you wrote, and that model answers. Nothing picks or switches the model for you.

### 스트리밍

`stream=true`로 설정하고 `data: [DONE]`까지 Server-Sent Events를 읽습니다. `stream_options.include_usage`를 지정하면 토큰 사용량이 마지막 청크에 담겨 옵니다. `[DONE]` 전에 스트림이 끝나면 답변이 불완전한 것으로 처리하세요. BroadNet은 프로덕션에서 스트리밍에 의존하기 전에 모델별로 확인할 것을 요청합니다.

stream.sh

```
curl -N https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","stream":true,"stream_options":{"include_usage":true},"messages":[{"role":"user","content":"Count from one to three."}]}'
```

## 오디오는 어떻게 전사하나요?

WAV 또는 MP3 파일(파일당 최대 26,214,400바이트)을 `/audio/transcriptions`로 보냅니다. `language`는 항상 지정하세요. 지정하지 않으면 아랍어가 라틴 문자로 반환될 수 있습니다. 아랍어에는 `language=ar` 값을 사용합니다. `.ogg`나 `.m4a` 파일은 먼저 변환하세요: `ffmpeg -i voice-note.ogg -ar 16000 -ac 1 voice-note.wav`

transcribe.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
with open("recording.wav", "rb") as audio:
    result = client.audio.transcriptions.create(
        model="broadnet/cohere-transcribe-arabic",
        file=audio,
        language="ar",
    )
print(result.text)
```

transcribe.sh

```
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe-arabic \
  -F language=ar \
  -F file=@voice-note.wav
```

응답은 JSON이며, 전사 텍스트는 `text` 필드에 있습니다. [아랍어 모델과 다국어 모델, 오디오 비용](https://broadrouter.com/ko/arabic-transcription/).

## 사용할 수 있는 모델 ID는 무엇인가요?

`model`에는 정확한 ID를 전달하세요. 채팅 모델을 찾을 때 `/v1/models`에 의존하지 말고, 이 목록이나 [레퍼런스 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-developers&utm_content=models-docs#models)를 참고하세요.

| 모델 | ID | 엔드포인트 | 입력 | 문서화됨 | 이용 조건 |
| --- | --- | --- | --- | --- | --- |
| [DeepSeek V4.1 Flash](https://broadrouter.com/ko/models/deepseek-v4.1-flash/) | `broadnet/deepseek-v4.1-flash` | `/chat/completions` | 텍스트 + 이미지 | 추론(reasoning) | 충전 필요 |
| [GLM 5.3](https://broadrouter.com/ko/models/glm-5.3/) | `broadnet/glm-5.3` | `/chat/completions` | 텍스트 | 도구 호출, 구조화된 출력, 추론(reasoning) | 충전 필요 |
| [Qwen3.8 27B](https://broadrouter.com/ko/models/qwen3.8-27b/) | `broadnet/qwen3.8-27b` | `/chat/completions` | 텍스트 + 이미지 | 도구 호출, 구조화된 출력, 추론(reasoning) | 충전 필요 |
| [BroadNet Gemma 4 VL 26B](https://broadrouter.com/ko/models/gemma-4-vl-26b/) | `broadnet/gemma-4-26b-a4b` | `/chat/completions` | 텍스트 + 이미지 | — | 초기 크레딧 |
| [BroadNet Transcribe Arabic](https://broadrouter.com/ko/models/cohere-transcribe-arabic/) | `broadnet/cohere-transcribe-arabic` | `/audio/transcriptions` | 아랍어 오디오 | — | 초기 크레딧 |
| [BroadNet Transcribe](https://broadrouter.com/ko/models/cohere-transcribe/) | `broadnet/cohere-transcribe` | `/audio/transcriptions` | 오디오, 14개 언어 | — | 초기 크레딧 |

'문서화됨'은 BroadNet 레퍼런스가 각 모델에 대해 명시한 도구 호출, 구조화된 출력, 추론(reasoning)입니다(2026-11-15 확인). 대시는 레퍼런스에 언급이 없다는 뜻이며, 기능이 없다는 뜻은 아닙니다.

## 다른 OpenAI 호환 API에서 이전하기: 체크리스트

요청 형식은 익숙하지만 모델마다 차이가 있습니다. 선택한 모델에 대해 각 항목을 확인하고, 트래픽을 전환하기 전에 테스트하세요.

1.  **엔드포인트.** 베이스 URL에 `https://inference.broadnet.ai/v1` 값을 설정합니다.
2.  **키.** BroadNet 추론 키를 환경 변수에서 읽어 오세요. 플랜 키와 종량제 키는 별개입니다.
3.  **모델 ID.** 정확한 ID를 사용합니다(예: `broadnet/gemma-4-26b-a4b`).
4.  **파라미터.** 보내는 모든 파라미터가 해당 모델 문서에 나와 있는지 확인하세요. 나와 있지 않은 파라미터는 제거하세요.
5.  **스트리밍.** 클라이언트가 SSE를 `[DONE]`까지 읽고, 일찍 끝난 스트림을 처리하는지 확인하세요.
6.  **도구 호출과 구조화된 출력.** 레퍼런스에는 다음 모델에 대해 이 기능이 문서화되어 있습니다: GLM 5.3 및 Qwen3.8 27B. 다른 모델은 의존하기 전에 테스트하세요.
7.  **추론(reasoning).** 추론은 출력 예산의 일부를 사용할 수 있습니다. `max_tokens`에 여유를 두세요. 자세한 내용: [추론 모델의 빈 응답 문제](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/).
8.  **한도.** 종량제 키는 분당 요청 30개, 동시 처리 4개까지 허용합니다. 플랜 세션은 한 번에 요청 1개를 처리합니다. Gemma 시간제 키는 스트림 1개, 분당 요청 120개, 분당 토큰 300,000개까지입니다.
9.  **컨텍스트.** 컨텍스트에는 입력과 답변이 모두 포함됩니다. 모델의 한도는 [모델 페이지](https://broadrouter.com/ko/models/)에서 확인하세요.
10.  **오류.** 아래 상태 코드를 재시도 또는 수정 조치에 대응시키고, `X-Request-ID`를 로그에 남기세요.
11.  **비용.** [가격 계산기](https://broadrouter.com/ko/pricing/)로 비용을 추정하세요. 종량제에서 이미지는 입력 토큰으로 계산됩니다.

## 어떤 오류를 재시도해야 하나요?

| 상태 | 의미 | 조치 |
| --- | --- | --- |
| 400 / 422 | 잘못된 요청 또는 필드 | 요청을 수정하세요. 그대로 재시도하지 마세요 |
| 401 | 키 누락, 무효, 만료, 또는 이용 한도 소진 | 키와 계정을 확인하세요 |
| 402 | `insufficient_balance` | 충전한 뒤 재시도하세요 |
| 413 | 요청이 바이트 또는 텍스트 한도를 초과함 | 더 작게 보내세요(예: 더 작은 오디오 파일) |
| 429 | 속도, 동시 처리, 토큰 속도 또는 지출 한도 | 상한을 둔 백오프 후 재시도하세요 |
| 500–504 | 서버 측 문제 | 상한을 둔 지수 백오프로 재시도하세요 |

[레퍼런스의 오류 표 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-developers&utm_content=errors-docs#errors)를 요약했습니다(2026-11-15 확인). [재시도 코드 예제](https://broadrouter.com/ko/guides/errors-and-retries/).

## 전체 문서와 가이드는 어디에 있나요?

-   [**개발자 레퍼런스 (영어)**요청 형식, 한도, 오류, 가격 피드. 공식 정보 출처입니다.](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-developers&utm_content=docs)
-   [**연동 (영어)**Aider, Cline, LangChain, n8n, LiteLLM 등 OpenAI 호환 도구의 설정.](https://broadrouter.com/integrations/)
-   [**가이드**SDK, 스트리밍, 재시도, IP 허용 목록, 아랍어 음성.](https://broadrouter.com/ko/guides/)
-   [**Python SDK 가이드**OpenAI Python SDK로 설치, 첫 요청, 스트리밍까지.](https://broadrouter.com/ko/guides/openai-python-sdk/)
-   [**Node SDK 가이드**같은 내용을 JavaScript와 TypeScript로, 요청 ID 포함.](https://broadrouter.com/ko/guides/openai-node-sdk/)
-   [**cURL 빠른 시작**모든 요청을 셸에서.](https://broadrouter.com/ko/guides/curl-quickstart/)
-   [**키와 IP 허용 목록**키를 내 서버에서만 쓰도록 제한합니다.](https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/)
-   [**API 요청 빌더 (영어)**브라우저에서 요청을 만들고 복사합니다.](https://broadrouter.com/tools/api-request-builder/)

전용 엔드포인트나 목록에 없는 모델이 필요하신가요? [BroadNet에 문의하기](https://broadrouter.com/ko/contact/#private).

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

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

**출처**

-   [BroadNet Inference 개발자 레퍼런스(2026-11-15 확인) (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-developers&utm_content=sources)
-   [BroadNet Inference 가격 (영어)](https://inference.broadnet.ai/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-developers&utm_content=sources)
-   [pricing.json(공개 요금표) (영어)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-developers&utm_content=sources)
