---
title: "LLM API curl 빠른 시작: 채팅, 스트리밍, 음성 전사 | BroadRouter"
description: "curl로 BroadNet Inference를 처음 호출해 봅니다. 채팅 완성, 스트리밍 응답, 오디오 전사를 실행하고 응답, usage, 오류를 읽는 법까지 정리했습니다."
url: https://broadrouter.com/ko/guides/curl-quickstart/
lang: ko
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

이 페이지는 영어 원문을 AI의 도움을 받아 번역했습니다. [영어 원문 읽기](https://broadrouter.com/guides/curl-quickstart/) (2026-11-16 업데이트).

# curl로 BroadNet Inference에 첫 요청 보내기

업데이트 2026-11-16

curl로 첫 요청을 보내려면 https://inference.broadnet.ai/v1/chat/completions 주소로 POST 요청을 보내세요. Authorization Bearer 헤더에 API 키를 넣고, JSON 본문에 model(예: broadnet/gemma-4-26b-a4b)과 messages를 담으면 됩니다. 스트리밍은 stream true를 추가하세요. 오디오는 model, language, file을 담은 multipart form을 /v1/audio/transcriptions로 보냅니다.

이 페이지를 따라 하면 새 키 하나로 채팅 완성, 스트리밍 응답, 전사 세 가지 호출을 실행할 수 있습니다. 필요한 것은 curl뿐입니다. BroadNet Inference는 OpenAI 요청 형식을 쓰므로, 이 호출이 작동하면 [OpenAI 호환 SDK](https://broadrouter.com/ko/guides/openai-python-sdk/)나 도구도 모두 작동합니다.

## 1\. 키 설정하기

BroadNet 콘솔에서 키를 만드세요. 새 계정에는 초기 크레딧($5)이 제공됩니다.

```bash
export BROADNET_API_KEY='paste-your-key'
```

키는 `Authorization: Bearer` 헤더로만 보내세요.

## 2\. 첫 번째 채팅 완성

초기 크레딧으로 실행되는 채팅 모델은 BroadNet Gemma 4 VL 26B 하나뿐이므로 이 모델로 시작하세요.

```bash
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": "Say hello in English and Arabic."}]
  }'
```

응답은 표준 chat completions JSON입니다. 답변은 `choices[0].message.content`에 있고, `usage`에는 과금 대상인 토큰 수가 들어 있습니다.

## 3\. 추론 모델 사용해 보기

충전한 뒤에는 모델을 바꿔 보세요. GLM 5.3, Qwen3.8 27B, DeepSeek V4.1 Flash는 답하기 전에 추론하며, 그 추론도 `max_tokens`에 포함됩니다.

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "broadnet/glm-5.3",
    "max_tokens": 2000,
    "reasoning_effort": "low",
    "messages": [{"role": "user", "content": "Give me a regex for a UK postcode."}]
  }'
```

`content`가 비어 있고 `finish_reason`이 `length`라면 추론하는 동안 예산이 바닥난 것입니다. [추론 모델이 빈 응답을 반환하는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.

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

`"stream": true`를 추가하고 `-N`으로 curl의 버퍼링을 끄세요.

```bash
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 to five."}]}'
```

Server-Sent Events 형식으로 응답이 옵니다. 스트림은 `data: [DONE]`이라는 줄로 끝나며, `include_usage`를 켜면 마지막 청크에 토큰 수가 담깁니다. 자세한 내용은 [채팅 완성 스트리밍](https://broadrouter.com/ko/guides/streaming-chat-completions/)을 참고하세요.

## 5\. 오디오 전사하기

전사에는 multipart form을 씁니다. 최대 26,214,400바이트의 WAV 또는 MP3를 보내고, `language`는 항상 함께 보내세요.

```bash
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe \
  -F language=en \
  -F file=@meeting.mp3
```

응답은 JSON이며 전사 결과는 `text`에 있습니다. WhatsApp `.ogg` 음성 메시지와 `.m4a` 녹음 파일은 먼저 변환해야 합니다. [WhatsApp 음성 메시지 전사 방법](https://broadrouter.com/ko/guides/transcribe-whatsapp-voice-notes/)을 참고하세요. 아랍어는 `broadnet/cohere-transcribe-arabic` 모델에 `language=ar`을 함께 쓰세요. [아랍어 음성 인식 가이드](https://broadrouter.com/ko/guides/arabic-speech-to-text-api/)를 참고하세요. 다국어 모델은 오디오 분당 $0.002 요금이고, 아랍어 모델은 분당 $0.0042 요금입니다.

## 어떤 모델을 고를까

| 모델 | ID | 엔드포인트 | 무료 크레딧 |
| --- | --- | --- | --- |
| BroadNet Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` | `/v1/chat/completions` | 가능 |
| GLM 5.3 | `broadnet/glm-5.3` | `/v1/chat/completions` | 불가 |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | `/v1/chat/completions` | 불가 |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | `/v1/chat/completions` | 불가 |
| BroadNet Transcribe | `broadnet/cohere-transcribe` | `/v1/audio/transcriptions` | 가능 |
| BroadNet Transcribe Arabic | `broadnet/cohere-transcribe-arabic` | `/v1/audio/transcriptions` | 가능 |

토큰당 가격과 분당 가격은 [가격 페이지](https://broadrouter.com/ko/pricing/)에 있습니다. 모델마다 전용 페이지가 있습니다. 예: [GLM 5.3](https://broadrouter.com/ko/models/glm-5.3/).

## 문제 해결

-   **401.** 키가 없거나, 유효하지 않거나, 만료되었거나, 종량제 사용 가능 금액이 소진된 경우입니다. 키 앞뒤에 공백이 섞여 있지 않은지 확인하세요.
-   **model 필드 오류.** 표에서 ID를 복사하세요. ID에는 `broadnet/` 접두사가 포함됩니다. 유료 모델은 충전하기 전까지 초기 크레딧으로는 호출에 실패합니다.
-   **413.** 오디오 파일이 26,214,400바이트를 넘었습니다. 파일을 나누세요.
-   **403.** 키의 IP 허용 목록, 모델 정책 또는 경로 정책이 요청을 거부했습니다. [API 키의 IP 허용 목록](https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/)을 참고하세요.
-   **429.** 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. 잠시 기다렸다가 재시도하세요. [BroadNet 오류 코드와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)를 참고하세요.
-   **무제한 플랜 사용 시.** 각 [플랜 세션](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)은 한 번에 요청 하나만 처리하므로, curl 루프를 병렬로 돌리려면 세션을 나누세요. 플랜 키는 `broadnet/deepseek-v4.1-flash` 모델에서만 작동합니다.

문제를 신고할 때는 `X-Request-ID` 응답 헤더를 저장해 두세요(`curl -D headers.txt ...`).

## 이 가이드의 용어

[종량제(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 용량을 차지하기 때문입니다.

[서버 전송 이벤트(SSE, Server-Sent Events)](https://broadrouter.com/ko/glossary/sse/)

서버 전송 이벤트(SSE, Server-Sent Events)는 서버가 text/event-stream 콘텐츠 타입의 오래 유지되는 HTTP 응답 하나로 클라이언트에 텍스트 이벤트 스트림을 보내는 웹 표준입니다. 각 이벤트는 data: 같은 필드 줄 하나 이상으로 이루어지며 빈 줄로 끝납니다.

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

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

[스트리밍(streaming)](https://broadrouter.com/ko/glossary/streaming/)

스트리밍은 언어 모델의 응답을 마지막에 한 번에 돌려주는 대신, 아직 생성 중일 때 작은 청크로 나눠 돌려주는 방식입니다. OpenAI 호환 API는 요청에서 stream을 true로 설정하면 서버 전송 이벤트(SSE)로 스트리밍합니다.

[음성 인식(Speech-to-text, STT)](https://broadrouter.com/ko/glossary/speech-to-text/)

음성 인식(STT)은 자동 음성 인식(ASR)이라고도 하며, 말소리 오디오를 글로 변환하는 기술입니다. 음성 인식 API는 오디오 파일이나 스트림을 받아 전사 텍스트를 반환하며, 보통 오디오 분당 요금이 붙습니다. 정확도는 단어 오류율로 측정하며 억양, 방언, 녹음 품질에 따라 달라집니다.

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

Chat Completions API는 OpenAI의 HTTP 엔드포인트인 POST /v1/chat/completions로, 모델 이름과 역할이 붙은 메시지 목록을 받아 모델의 다음 메시지를 반환합니다. 이 요청과 응답 구조는 OpenAI 호환 제공업체와 SDK가 재사용하는 공통 형식이 되었습니다.

[OpenAI 호환 API(OpenAI-compatible API)](https://broadrouter.com/ko/glossary/openai-compatible-api/)

OpenAI 호환 API는 POST /v1/chat/completions처럼 OpenAI API와 같은 요청 및 응답 형식을 받는 HTTP API입니다. 그래서 OpenAI SDK와 도구는 base URL, API 키, 모델 이름만 바꾸면 이 API를 그대로 사용할 수 있습니다.

## 자주 묻는 질문

### 무료 초기 크레딧으로 어떤 모델을 호출할 수 있나요?

모델 ID가 broadnet/gemma-4-26b-a4b인 BroadNet Gemma 4 VL 26B와 두 전사 모델입니다. GLM 5.3, Qwen3.8 27B, DeepSeek V4.1 Flash는 충전이 필요합니다.

### curl 응답에서 message content가 비어 있는 이유는 무엇인가요?

추론 모델은 max\_tokens를 먼저 추론에 씁니다. finish\_reason이 length라면 max\_tokens를 1,000 이상으로 늘리세요.

### 아랍어 전사 결과가 라틴 문자로 나오는 이유는 무엇인가요?

요청에 language 필드가 없었기 때문입니다. 아랍어는 language=ar을, 다른 언어는 해당 ISO 639-1 코드를 보내세요.

### GET /v1/models가 호출 가능한 모든 모델을 보여 주나요?

BroadNet 문서에 따르면 GET /v1/models는 "supplies public catalogue metadata for external monitors"(번역: 외부 모니터링 도구를 위한 공개 카탈로그 메타데이터를 제공합니다). 요청에는 API 레퍼런스나 pricing.json에 있는 모델 ID를 쓰세요.

## 관련 가이드

-   [BroadNet Inference에서 OpenAI Python SDK 사용하기](https://broadrouter.com/ko/guides/openai-python-sdk/)
-   [채팅 완성 스트리밍과 끊긴 연결 처리하기](https://broadrouter.com/ko/guides/streaming-chat-completions/)
-   [아랍어 음성 인식(STT) API 사용법: 단계별 가이드](https://broadrouter.com/ko/guides/arabic-speech-to-text-api/)
-   [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-curl-quickstart&utm_content=page-cta) ·

**출처**

-   [BroadNet Inference API 레퍼런스 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-curl-quickstart&utm_content=sources)
-   [기계 판독용 모델 목록과 가격표(pricing.json) (영어)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-curl-quickstart&utm_content=sources)
