BroadRouter
시작하기

curl로 BroadNet Inference에 첫 요청 보내기

업데이트

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나 도구도 모두 작동합니다.

1. 키 설정하기

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

export BROADNET_API_KEY='paste-your-key'

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

2. 첫 번째 채팅 완성

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

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에 포함됩니다.

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라면 추론하는 동안 예산이 바닥난 것입니다. 추론 모델이 빈 응답을 반환하는 이유를 참고하세요.

4. 응답 스트리밍하기

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

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를 켜면 마지막 청크에 토큰 수가 담깁니다. 자세한 내용은 채팅 완성 스트리밍을 참고하세요.

5. 오디오 전사하기

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

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 음성 메시지 전사 방법을 참고하세요. 아랍어는 broadnet/cohere-transcribe-arabic 모델에 language=ar을 함께 쓰세요. 아랍어 음성 인식 가이드를 참고하세요. 다국어 모델은 오디오 분당 $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 가능

토큰당 가격과 분당 가격은 가격 페이지에 있습니다. 모델마다 전용 페이지가 있습니다. 예: GLM 5.3.

문제 해결

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

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

자주 묻는 질문

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

모델 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를 쓰세요.

Markdown으로 읽기ChatGPT에 질문하기Claude에 질문하기Perplexity에 질문하기