---
title: "Mula pantas API LLM dengan curl: chat, strim, transkripsi"
description: "Buat panggilan pertama ke BroadNet Inference dengan curl: chat completion, jawapan distrim dan transkripsi audio, kemudian baca respons, usage dan ralat."
url: https://broadrouter.com/ms/guides/curl-quickstart/
lang: ms
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/guides/curl-quickstart/) (dikemas kini 2026-11-16).

# Permintaan pertama ke BroadNet Inference dengan curl

Dikemas kini 2026-11-16

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](https://broadrouter.com/ms/guides/openai-python-sdk/) atau alat lain juga akan berfungsi.

## 1\. Tetapkan kunci anda

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

```bash
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:

```bash
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`:

```bash
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](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).

## 4\. Strim jawapan

Tambah `"stream": true` dan matikan penimbalan curl dengan `-N`:

```bash
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](https://broadrouter.com/ms/guides/streaming-chat-completions/).

## 5\. Transkripsikan audio

Transkripsi menerima borang multipart. Hantar WAV atau MP3, sehingga 26,214,400 bait, dan sentiasa hantar `language`:

```bash
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](https://broadrouter.com/ms/guides/transcribe-whatsapp-voice-notes/). Untuk bahasa Arab, gunakan `broadnet/cohere-transcribe-arabic` dengan `language=ar`; lihat [panduan speech-to-text bahasa Arab](https://broadrouter.com/ms/guides/arabic-speech-to-text-api/). 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](https://broadrouter.com/ms/pricing/). Setiap model mempunyai halaman sendiri, contohnya [GLM 5.3](https://broadrouter.com/ms/models/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](https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/).
-   **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](https://broadrouter.com/ms/guides/errors-and-retries/).
-   **Pada pelan tanpa had.** Setiap [sesi pelan](https://broadrouter.com/ms/guides/unlimited-llm-api-sessions/) 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.

## Istilah dalam panduan ini

[Bayar ikut guna (pay-as-you-go)](https://broadrouter.com/ms/glossary/pay-as-you-go/)

Bayar ikut guna ialah model harga di mana anda hanya membayar apa yang anda guna, dimeter mengikut unit seperti token, permintaan atau minit audio, tanpa langganan atau komitmen minimum. Kebanyakan API LLM mengebil dengan cara ini, daripada baki prabayar atau invois berkala.

[Keserentakan (concurrency)](https://broadrouter.com/ms/glossary/concurrency/)

Keserentakan ialah bilangan permintaan yang sedang berjalan serentak daripada satu klien. API LLM sering mengehadkannya bagi setiap kunci atau pelan, berasingan daripada permintaan seminit, kerana setiap permintaan yang terbuka memegang kapasiti GPU sehingga responsnya selesai.

[Token](https://broadrouter.com/ms/glossary/token/)

Token ialah unit teks yang dibaca dan ditulis oleh model bahasa: satu perkataan, sebahagian perkataan, tanda baca atau jujukan bait yang dihasilkan oleh tokenizer model itu. API LLM mengira, mengehadkan dan biasanya mengebil penggunaan dalam token.

[Kredit prabayar (prepaid credit)](https://broadrouter.com/ms/glossary/prepaid-credit/)

Kredit prabayar ialah wang yang ditambah ke akaun API sebelum digunakan. Setiap permintaan menolak kosnya daripada baki, dan apabila baki habis, permintaan bermeter berhenti sehingga anda menambah nilai. Ia mengehadkan perbelanjaan kepada jumlah yang telah anda bayar.

[Penstriman (streaming)](https://broadrouter.com/ms/glossary/streaming/)

Penstriman ialah cara memulangkan respons model bahasa dalam cebisan kecil semasa ia masih dijana, dan bukan sebagai satu jawapan di penghujung. API serasi OpenAI menstrim melalui server-sent events apabila permintaan menetapkan stream kepada true.

[Baris Arab (tashkeel, Arabic diacritics)](https://broadrouter.com/ms/glossary/arabic-diacritics/)

Baris Arab, atau tashkeel, ialah tanda kecil yang ditulis di atas atau di bawah huruf untuk menunjukkan vokal pendek, konsonan berganda dan ketiadaan vokal. Ia pilihan: kebanyakan teks Arab, termasuk berita, meninggalkannya, jadi pembaca dan perisian meneka vokal daripada konteks.

[Chat Completions API](https://broadrouter.com/ms/glossary/chat-completions-api/)

Chat Completions API ialah endpoint HTTP OpenAI, POST /v1/chat/completions, yang menerima nama model dan senarai mesej bertanda peranan, lalu memulangkan mesej seterusnya daripada model. Bentuk permintaan dan responsnya menjadi format biasa yang digunakan semula oleh penyedia dan SDK yang serasi OpenAI.

[Had kadar (rate limit)](https://broadrouter.com/ms/glossary/rate-limit/)

Had kadar ialah had yang ditetapkan oleh API ke atas jumlah penggunaan klien dalam satu tempoh masa, seperti permintaan seminit atau token seminit. Permintaan yang melebihi had ditolak, biasanya dengan HTTP 429 Too Many Requests, sehingga penggunaan turun semula di bawahnya.

## 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.

## Panduan berkaitan

-   [Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/)
-   [Strim chat completions dan kendalikan sambungan yang terputus](https://broadrouter.com/ms/guides/streaming-chat-completions/)
-   [API speech-to-text bahasa Arab, langkah demi langkah](https://broadrouter.com/ms/guides/arabic-speech-to-text-api/)
-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/)

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

[Mulakan](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-curl-quickstart&utm_content=page-cta) ·

**Sumber**

-   [Rujukan API BroadNet Inference (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-curl-quickstart&utm_content=sources)
-   [Senarai model dan harga yang boleh dibaca mesin (pricing.json) (Bahasa Inggeris)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-curl-quickstart&utm_content=sources)
