---
title: "Panduan cepat API LLM dengan curl: chat, streaming, audio"
description: "Kirim panggilan pertama Anda ke BroadNet Inference dengan curl: chat completion, balasan streaming, dan transkripsi audio. Lalu baca respons, usage, dan error-nya."
url: https://broadrouter.com/id/guides/curl-quickstart/
lang: id
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan dari bahasa Inggris dengan bantuan AI. [Baca versi asli bahasa Inggris](https://broadrouter.com/guides/curl-quickstart/) (diperbarui 2026-11-16).

# Permintaan pertama ke BroadNet Inference dengan curl

Diperbarui 2026-11-16

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](https://broadrouter.com/id/guides/openai-python-sdk/) atau tool apa pun juga akan berjalan.

## 1\. Atur kunci Anda

Buat kunci di konsol BroadNet. Akun baru mendapat kredit awal $5.

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

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

```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` bernilai `length`, anggarannya habis saat model bernalar. Lihat [kenapa model penalaran mengembalikan jawaban kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).

## 4\. Streaming balasan

Tambahkan `"stream": true` dan matikan buffering 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. Stream diakhiri baris literal `data: [DONE]`, dan dengan `include_usage` chunk terakhir membawa jumlah token. Selengkapnya di [streaming chat completions](https://broadrouter.com/id/guides/streaming-chat-completions/).

## 5\. Transkripsikan audio

Transkripsi memakai form multipart. Kirim WAV atau MP3 hingga 26.214.400 byte, dan selalu sertakan `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 berupa JSON dengan transkrip di `text`. Voice note WhatsApp `.ogg` dan rekaman `.m4a` harus dikonversi dulu; lihat [cara mentranskripsikan voice note WhatsApp](https://broadrouter.com/id/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/id/guides/arabic-speech-to-text-api/). 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](https://broadrouter.com/id/pricing/). Setiap model punya halamannya sendiri, misalnya [GLM 5.3](https://broadrouter.com/id/models/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](https://broadrouter.com/id/guides/api-keys-ip-allow-lists/).
-   **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](https://broadrouter.com/id/guides/errors-and-retries/).
-   **Jika Anda memakai paket unlimited.** Setiap [sesi paket](https://broadrouter.com/id/guides/unlimited-llm-api-sessions/) 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.

## Istilah dalam panduan ini

[Streaming (respons streaming)](https://broadrouter.com/id/glossary/streaming/)

Streaming adalah cara mengembalikan respons model bahasa dalam potongan-potongan kecil selagi masih dihasilkan, bukan sebagai satu balasan utuh di akhir. API yang kompatibel dengan OpenAI melakukan streaming lewat server-sent events jika permintaan mengatur stream ke true.

[Bayar sesuai pemakaian (pay-as-you-go)](https://broadrouter.com/id/glossary/pay-as-you-go/)

Bayar sesuai pemakaian (pay-as-you-go) adalah model harga di mana Anda hanya membayar yang Anda pakai, dihitung per satuan seperti token, permintaan, atau menit audio, tanpa langganan atau komitmen minimum. Sebagian besar API LLM menagih dengan cara ini, dari saldo prabayar atau tagihan berkala.

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

Token adalah satuan teks yang dibaca dan ditulis model bahasa: sebuah kata, bagian kata, tanda baca, atau urutan byte yang dihasilkan tokenizer model. API LLM menghitung, membatasi, dan biasanya menagih pemakaian dalam token.

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

Chat Completions API adalah endpoint HTTP milik OpenAI, POST /v1/chat/completions, yang menerima nama model dan daftar pesan bertanda peran lalu mengembalikan pesan berikutnya dari model. Bentuk request dan response-nya menjadi format umum yang dipakai ulang oleh penyedia dan SDK yang kompatibel dengan OpenAI.

[IP allow list (daftar IP yang diizinkan)](https://broadrouter.com/id/glossary/ip-allow-list/)

IP allow list adalah kontrol keamanan yang hanya menerima request dari alamat IP atau rentang CIDR yang terdaftar dan menolak semua yang lain. Pada API, kontrol ini membatasi kerusakan akibat kunci yang bocor, karena kunci tidak berfungsi dari jaringan yang tidak ada di daftar.

[Konkurensi (concurrency)](https://broadrouter.com/id/glossary/concurrency/)

Konkurensi (concurrency) adalah jumlah permintaan yang sedang berjalan dari sebuah client pada saat yang sama. API LLM sering membatasinya per kunci atau per paket, terpisah dari batas permintaan per menit, karena setiap permintaan yang terbuka menahan kapasitas GPU sampai responsnya selesai.

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

Kredit prabayar adalah uang yang diisi ke akun API sebelum dipakai. Setiap request memotong biayanya dari saldo, dan saat saldo habis, request berbayar per pemakaian berhenti sampai Anda melakukan top up. Dengan begitu, pengeluaran dibatasi sebesar uang yang sudah Anda setor.

[Rate limit (batas laju)](https://broadrouter.com/id/glossary/rate-limit/)

Rate limit adalah batas yang diterapkan API pada seberapa banyak client boleh memakainya dalam rentang waktu tertentu, misalnya permintaan per menit atau token per menit. Permintaan yang melebihi batas ditolak, biasanya dengan HTTP 429 Too Many Requests, sampai pemakaian kembali di bawah batas.

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

## Panduan terkait

-   [Memakai OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-python-sdk/)
-   [Streaming chat completions dan menangani koneksi terputus](https://broadrouter.com/id/guides/streaming-chat-completions/)
-   [API speech-to-text bahasa Arab, langkah demi langkah](https://broadrouter.com/id/guides/arabic-speech-to-text-api/)
-   [Kode error BroadNet Inference dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/)

Coba dengan beban kerja Anda yang sebenarnya. Akun baru mendapat kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM, dan Qwen3.8 memerlukan top up.

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

**Sumber**

-   [Referensi API BroadNet Inference (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-curl-quickstart&utm_content=sources)
-   [Daftar model dan harga yang dapat dibaca mesin (pricing.json) (bahasa Inggris)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-curl-quickstart&utm_content=sources)
