Trang này đưa bạn từ một key mới đến ba lệnh gọi chạy được: một chat completion, một phản hồi streaming và một bản chép lời. Bạn chỉ cần curl. BroadNet Inference dùng cấu trúc request của OpenAI, nên khi ba lệnh này chạy được thì mọi SDK tương thích OpenAI hay công cụ tương thích OpenAI cũng sẽ chạy được.
1. Đặt key
Tạo một key trong console của BroadNet. Tài khoản mới được tặng $5 tín dụng ban đầu.
export BROADNET_API_KEY='paste-your-key'
Chỉ gửi key trong header Authorization: Bearer.
2. Chat completion đầu tiên
BroadNet Gemma 4 VL 26B là model chat duy nhất chạy được bằng tín dụng ban đầu, nên hãy bắt đầu với nó:
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."}]
}'
Phản hồi là JSON chat completions chuẩn. Câu trả lời nằm trong choices[0].message.content, còn usage chứa số token mà bạn phải trả tiền.
3. Thử một model suy luận
Sau khi nạp tiền, hãy đổi model. GLM 5.3, Qwen3.8 27B và DeepSeek V4.1 Flash suy luận trước khi trả lời, và phần suy luận đó được tính vào 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."}]
}'
Nếu content trống và finish_reason là length, ngân sách token đã hết ngay trong lúc suy luận. Xem vì sao model suy luận trả về câu trả lời trống.
4. Stream phản hồi
Thêm "stream": true và tắt bộ đệm của curl bằng -N:
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."}]}'
Bạn nhận về Server-Sent Events. Luồng kết thúc bằng đúng dòng data: [DONE], và khi có include_usage thì chunk cuối cùng mang số token. Xem thêm ở streaming chat completions.
5. Chép lời âm thanh
Chép lời nhận một form multipart. Hãy gửi WAV hoặc MP3, tối đa 26.214.400 byte, và luôn gửi kèm 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
Phản hồi là JSON, bản chép lời nằm trong text. Tin nhắn thoại .ogg của WhatsApp và bản ghi .m4a cần được chuyển đổi trước; xem cách chép lời tin nhắn thoại WhatsApp. Với tiếng Ả Rập, hãy dùng broadnet/cohere-transcribe-arabic cùng language=ar; xem hướng dẫn chuyển giọng nói tiếng Ả Rập thành văn bản. Model đa ngôn ngữ có giá $0.002 mỗi phút âm thanh, còn model tiếng Ả Rập là $0.0042.
Nên chọn model nào
| Model | ID | Endpoint | Tín dụng miễn phí |
|---|---|---|---|
| BroadNet Gemma 4 VL 26B | broadnet/gemma-4-26b-a4b |
/v1/chat/completions |
Có |
| GLM 5.3 | broadnet/glm-5.3 |
/v1/chat/completions |
Không |
| Qwen3.8 27B | broadnet/qwen3.8-27b |
/v1/chat/completions |
Không |
| DeepSeek V4.1 Flash | broadnet/deepseek-v4.1-flash |
/v1/chat/completions |
Không |
| BroadNet Transcribe | broadnet/cohere-transcribe |
/v1/audio/transcriptions |
Có |
| BroadNet Transcribe Arabic | broadnet/cohere-transcribe-arabic |
/v1/audio/transcriptions |
Có |
Giá theo token và theo phút có trên trang bảng giá. Mỗi model có trang riêng, ví dụ GLM 5.3.
Xử lý sự cố
- 401. Key bị thiếu, không hợp lệ hoặc đã hết hạn, hoặc hạn mức trả theo mức dùng đã hết. Hãy kiểm tra khoảng trắng thừa quanh key.
- Lỗi ở trường model. Hãy sao chép ID từ bảng; ID có tiền tố
broadnet/. Các model trả phí sẽ báo lỗi khi dùng tín dụng ban đầu cho đến khi bạn nạp tiền. - 413. Tệp âm thanh vượt quá 26.214.400 byte. Hãy chia nhỏ tệp.
- 403. Danh sách IP được phép, model hoặc chính sách route của key đã từ chối request. Xem danh sách IP được phép cho API key.
- 429. Một key trả theo mức dùng cho phép 30 request mỗi phút và 4 request đồng thời. Hãy chờ rồi thử lại. Xem mã lỗi BroadNet và cách thử lại.
- Khi dùng gói không giới hạn. Mỗi phiên của gói chạy một request tại một thời điểm, nên hãy chạy các vòng lặp curl song song trên các phiên riêng. Key của gói chỉ dùng được với
broadnet/deepseek-v4.1-flash.
Hãy lưu header phản hồi X-Request-ID (curl -D headers.txt ...) khi báo cáo sự cố.
