BroadRouter
Mulakan

Permintaan pertama ke BroadNet Inference dengan curl

Dikemas kini

Hantar POST ke https://inference.broadnet.ai/v1/chat/completions dengan pengepala Authorization Bearer dan kunci anda, serta badan JSON yang mengandungi model, contohnya broadnet/gemma-4-26b-a4b, dan messages. Tambah stream true untuk penstriman. Untuk audio, hantar borang multipart dengan model, language dan file ke /v1/audio/transcriptions.

Halaman ini membawa anda daripada kunci baharu kepada tiga panggilan yang berfungsi: satu chat completion, satu jawapan distrim dan satu transkripsi. Anda hanya perlukan curl. BroadNet Inference menggunakan bentuk permintaan OpenAI, jadi apabila ini berfungsi, mana-mana SDK serasi OpenAI atau alat lain juga akan berfungsi.

1. Tetapkan kunci anda

Cipta kunci dalam konsol BroadNet. Akaun baharu mendapat kredit permulaan $5.

export BROADNET_API_KEY='paste-your-key'

Hantar kunci hanya dalam pengepala Authorization: Bearer.

2. Chat completion pertama anda

BroadNet Gemma 4 VL 26B ialah satu-satunya model chat yang berjalan pada kredit permulaan, jadi mulakan di situ:

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 ialah JSON chat-completions standard. Jawapan berada dalam choices[0].message.content, dan usage mengandungi bilangan token yang anda bayar.

3. Cuba model penaakulan

Selepas tambah nilai, tukar model. GLM 5.3, Qwen3.8 27B dan DeepSeek V4.1 Flash membuat penaakulan sebelum menjawab, dan penaakulan itu dikira 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 ialah length, bajet habis semasa penaakulan. Lihat mengapa model penaakulan memulangkan jawapan kosong.

4. Strim jawapan

Tambah "stream": true dan matikan penimbalan 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. Strim berakhir dengan baris literal data: [DONE], dan dengan include_usage, chunk terakhir membawa bilangan token. Maklumat lanjut dalam penstriman chat completions.

5. Transkripsikan audio

Transkripsi menerima borang multipart. Hantar WAV atau MP3, sehingga 26,214,400 bait, dan sentiasa hantar 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 ialah JSON dengan transkrip dalam text. Nota suara .ogg WhatsApp dan rakaman .m4a perlu ditukar dahulu; lihat cara mentranskripsikan nota suara WhatsApp. Untuk bahasa Arab, gunakan broadnet/cohere-transcribe-arabic dengan language=ar; lihat panduan speech-to-text bahasa Arab. Model berbilang bahasa berharga $0.002 seminit audio dan model bahasa Arab $0.0042.

Model mana yang patut dipilih

Model ID Endpoint Kredit percuma
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 setiap token dan setiap minit ada di halaman harga. Setiap model mempunyai halaman sendiri, contohnya GLM 5.3.

Penyelesaian masalah

  • 401. Kunci tiada, tidak sah atau tamat tempoh, atau elaun bayar ikut guna telah habis. Semak sama ada terdapat ruang kosong di sekeliling kunci.
  • Ralat pada medan model. Salin ID daripada jadual; ia termasuk awalan broadnet/. Model berbayar gagal pada kredit permulaan sehingga anda membuat tambah nilai.
  • 413. Fail audio melebihi 26,214,400 bait. Pecahkannya.
  • 403. Senarai IP dibenarkan, dasar model atau dasar laluan kunci itu menolak permintaan. Lihat senarai IP dibenarkan untuk kunci API.
  • 429. Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 permintaan serentak. Tunggu sebentar dan cuba semula. Lihat kod ralat BroadNet dan cuba semula.
  • Pada pelan tanpa had. Setiap sesi pelan menjalankan satu permintaan pada satu masa, jadi jalankan gelung curl selari pada sesi berasingan. Kunci pelan hanya berfungsi dengan broadnet/deepseek-v4.1-flash.

Simpan pengepala respons X-Request-ID (curl -D headers.txt ...) apabila anda melaporkan masalah.

Soalan lazim

Model manakah yang boleh saya panggil dengan kredit permulaan percuma?

BroadNet Gemma 4 VL 26B, dengan ID model broadnet/gemma-4-26b-a4b, dan kedua-dua model transkripsi. GLM 5.3, Qwen3.8 27B dan DeepSeek V4.1 Flash memerlukan tambah nilai.

Mengapakah message content kosong dalam respons curl saya?

Model penaakulan menggunakan max_tokens untuk penaakulan terlebih dahulu. Jika finish_reason ialah length, naikkan max_tokens kepada 1,000 atau lebih.

Mengapakah transkrip bahasa Arab saya dalam huruf Rumi?

Permintaan itu tiada medan language. Hantar language=ar untuk bahasa Arab dan kod ISO 639-1 yang sepadan untuk bahasa lain.

Adakah GET /v1/models menyenaraikan setiap model yang boleh saya panggil?

Dokumentasi BroadNet menyatakan GET /v1/models "supplies public catalogue metadata for external monitors" (Terjemahan: menyediakan metadata katalog awam untuk pemantau luaran). Untuk permintaan, gunakan ID model daripada rujukan API atau pricing.json.

Baca sebagai MarkdownTanya ChatGPTTanya ClaudeTanya Perplexity