이 페이지를 따라 하면 새 키 하나로 채팅 완성, 스트리밍 응답, 전사 세 가지 호출을 실행할 수 있습니다. 필요한 것은 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 ...).
