BroadRouter
Mulai

Permintaan pertama ke BroadNet Inference dengan curl

Diperbarui

Kirim POST ke https://inference.broadnet.ai/v1/chat/completions dengan header Authorization Bearer berisi kunci Anda, dan body JSON berisi model (misalnya broadnet/gemma-4-26b-a4b) serta messages. Tambahkan stream true untuk streaming. Untuk audio, kirim form multipart berisi model, language, dan file ke /v1/audio/transcriptions.

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.

Pertanyaan umum

Model mana yang bisa saya pakai dengan kredit awal gratis?

BroadNet Gemma 4 VL 26B (ID model broadnet/gemma-4-26b-a4b) dan kedua model transkripsi. GLM 5.3, Qwen3.8 27B, dan DeepSeek V4.1 Flash memerlukan top up.

Kenapa isi pesan di respons curl saya kosong?

Model penalaran menghabiskan max_tokens untuk bernalar terlebih dahulu. Jika finish_reason bernilai length, naikkan max_tokens menjadi 1.000 atau lebih.

Kenapa transkrip bahasa Arab saya ditulis dengan huruf Latin?

Permintaan Anda tidak menyertakan field language. Kirim language=ar untuk bahasa Arab dan kode ISO 639-1 yang sesuai untuk bahasa lain.

Apakah GET /v1/models menampilkan semua model yang bisa saya panggil?

Dokumentasi BroadNet menyebutkan bahwa GET /v1/models "supplies public catalogue metadata for external monitors" (Terjemahan BroadRouter: menyediakan metadata katalog publik untuk pemantau eksternal). Untuk permintaan, gunakan ID model dari referensi API atau pricing.json.

Baca sebagai MarkdownTanya ChatGPTTanya ClaudeTanya Perplexity