Halaman ini membawa Anda dari kunci baru ke tiga panggilan yang berjalan: chat completion, balasan streaming, dan transkripsi. Yang Anda perlukan hanya curl. BroadNet Inference memakai format permintaan OpenAI, jadi begitu ketiganya berjalan, SDK kompatibel OpenAI atau tool apa pun juga akan berjalan.
1. Atur kunci Anda
Buat kunci di konsol BroadNet. Akun baru mendapat kredit awal $5.
export BROADNET_API_KEY='paste-your-key'
Kirim kunci hanya di header Authorization: Bearer.
2. Chat completion pertama Anda
BroadNet Gemma 4 VL 26B adalah satu-satunya model chat yang berjalan dengan kredit awal, jadi mulailah dari sana:
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."}]
}'
Balasannya berupa JSON chat completions standar. Jawabannya ada di choices[0].message.content, dan usage berisi jumlah token yang Anda bayar.
3. Coba model penalaran
Setelah top up, ganti modelnya. GLM 5.3, Qwen3.8 27B, dan DeepSeek V4.1 Flash bernalar sebelum menjawab, dan penalaran itu dihitung dalam 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."}]
}'
Jika content kosong dan finish_reason bernilai length, anggarannya habis saat model bernalar. Lihat kenapa model penalaran mengembalikan jawaban kosong.
4. Streaming balasan
Tambahkan "stream": true dan matikan buffering curl dengan -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."}]}'
Anda akan menerima Server-Sent Events. Stream diakhiri baris literal data: [DONE], dan dengan include_usage chunk terakhir membawa jumlah token. Selengkapnya di streaming chat completions.
5. Transkripsikan audio
Transkripsi memakai form multipart. Kirim WAV atau MP3 hingga 26.214.400 byte, dan selalu sertakan 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
Responsnya berupa JSON dengan transkrip di text. Voice note WhatsApp .ogg dan rekaman .m4a harus dikonversi dulu; lihat cara mentranskripsikan voice note WhatsApp. Untuk bahasa Arab, gunakan broadnet/cohere-transcribe-arabic dengan language=ar; lihat panduan speech-to-text bahasa Arab. Model multibahasa dikenai $0.002 per menit audio dan model bahasa Arab $0.0042.
Model mana yang dipilih
| Model | ID | Endpoint | Kredit gratis |
|---|---|---|---|
| BroadNet Gemma 4 VL 26B | broadnet/gemma-4-26b-a4b |
/v1/chat/completions |
Ya |
| GLM 5.3 | broadnet/glm-5.3 |
/v1/chat/completions |
Tidak |
| Qwen3.8 27B | broadnet/qwen3.8-27b |
/v1/chat/completions |
Tidak |
| DeepSeek V4.1 Flash | broadnet/deepseek-v4.1-flash |
/v1/chat/completions |
Tidak |
| BroadNet Transcribe | broadnet/cohere-transcribe |
/v1/audio/transcriptions |
Ya |
| BroadNet Transcribe Arabic | broadnet/cohere-transcribe-arabic |
/v1/audio/transcriptions |
Ya |
Harga per token dan per menit ada di halaman harga. Setiap model punya halamannya sendiri, misalnya GLM 5.3.
Pemecahan masalah
- 401. Kunci tidak ada, tidak valid, atau kedaluwarsa, atau jatah bayar sesuai pemakaian sudah habis. Periksa spasi yang terselip di sekitar kunci.
- Error pada field model. Salin ID dari tabel; ID-nya menyertakan prefiks
broadnet/. Model berbayar gagal dengan kredit awal sampai Anda melakukan top up. - 413. File audio melebihi 26.214.400 byte. Pecah file-nya.
- 403. Permintaan ditolak oleh daftar IP yang diizinkan, kebijakan model, atau kebijakan rute pada kunci. Lihat daftar IP yang diizinkan untuk kunci API.
- 429. Kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 permintaan yang berjalan bersamaan. Tunggu sebentar lalu coba lagi. Lihat kode error BroadNet dan percobaan ulang.
- Jika Anda memakai paket unlimited. Setiap sesi paket menjalankan satu permintaan dalam satu waktu, jadi jalankan loop curl paralel di sesi yang berbeda. Kunci paket hanya berfungsi dengan
broadnet/deepseek-v4.1-flash.
Simpan header respons X-Request-ID (curl -D headers.txt ...) saat Anda melaporkan masalah.
