---
title: "Panduan cepat BroadNet Inference: API dengan Python dan cURL"
description: "Kirim permintaan chat dan transkripsi pertama Anda ke BroadNet Inference dengan Python atau cURL, lalu ikuti checklist migrasi untuk model pilihan Anda."
url: https://broadrouter.com/id/developers/
lang: id
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

# Developer

Diperbarui 2026-11-15

BroadNet Inference memakai format permintaan OpenAI di `https://inference.broadnet.ai/v1`. Buat kunci di konsol, simpan di environment variable, lalu kirim permintaan ke `/chat/completions` atau `/audio/transcriptions` dengan ID model yang persis. Sebelum memindahkan trafik produksi, periksa parameter, streaming, tools, batas, dan error untuk model tersebut.

-   Panduan cepat chat
-   Panduan cepat transkripsi
-   ID model
-   Checklist migrasi
-   Error dan percobaan ulang
-   Dokumentasi dan panduan

## Bagaimana cara mengirim permintaan chat pertama?

1.  Masuk di [inference.broadnet.ai (bahasa Inggris)](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-developers&utm_content=quickstart-account) lalu buat kunci inferensi. Kunci hanya ditampilkan sekali; konsol hanya menyimpan hash-nya.
2.  Instal OpenAI SDK dan atur kunci di shell Anda. Simpan kunci di server, jangan pernah di kode yang berjalan di browser.
3.  Kirim permintaan. Baca jawabannya dari `choices[0].message.content`.

setup

```
python -m pip install openai
export BROADNET_API_KEY='paste-the-key-once'
```

first\_request.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)
print(response.choices[0].message.content)
```

request.sh

```
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":"Reply with one short sentence."}]}'
```

Contoh ini memakai BroadNet Gemma 4 VL 26B, yang dicakup kredit awal US$5. DeepSeek V4.1 Flash, GLM 5.3, dan Qwen3.8 27B memerlukan top up terlebih dahulu. Simpan header respons `X-Request-ID` untuk keperluan dukungan.

How a request reaches a model

1.  01**Your app**Key kept in an environment variable
    
2.  02**OpenAI SDK**Two settings change
    
    `base_url` `api_key`
    
3.  03**BroadNet Inference**OpenAI-compatible API`inference.broadnet.ai/v1``POST /chat/completions`
    
4.  04**The model you name**Set in every request
    
    -   `broadnet/deepseek-v4.1-flash`
    -   `broadnet/glm-5.3`
    -   `broadnet/qwen3.8-27b`
    -   `broadnet/gemma-4-26b-a4b`your choice
    
5.  05**Response**From that model
    

You choose the model in each request. There is no automatic routing: the request runs on the model ID you sent.

Your app calls the OpenAI SDK with BroadNet’s base URL and your key. The request goes to BroadNet Inference with the model ID you wrote, and that model answers. Nothing picks or switches the model for you.

### Streaming

Atur `stream=true` dan baca Server-Sent Events sampai `data: [DONE]`. Dengan `stream_options.include_usage`, pemakaian token dikirim di chunk terakhir. Jika stream berhenti sebelum `[DONE]`, anggap jawabannya belum lengkap. BroadNet meminta Anda memverifikasi streaming untuk setiap model sebelum mengandalkannya di produksi.

stream.sh

```
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 from one to three."}]}'
```

## Bagaimana cara mentranskripsi audio?

Kirim WAV atau MP3, maksimal 26.214.400 byte per file, ke `/audio/transcriptions`. Selalu isi `language`: tanpa itu, bahasa Arab bisa kembali dalam huruf Latin. Gunakan `language=ar` untuk bahasa Arab. Ubah dulu file `.ogg` atau `.m4a`: `ffmpeg -i voice-note.ogg -ar 16000 -ac 1 voice-note.wav`

transcribe.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
with open("recording.wav", "rb") as audio:
    result = client.audio.transcriptions.create(
        model="broadnet/cohere-transcribe-arabic",
        file=audio,
        language="ar",
    )
print(result.text)
```

transcribe.sh

```
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe-arabic \
  -F language=ar \
  -F file=@voice-note.wav
```

Responsnya berupa JSON dengan transkrip di `text`. [Model Arab atau multibahasa, dan berapa biaya audio](https://broadrouter.com/id/arabic-transcription/).

## ID model apa saja yang bisa saya pakai?

Kirim ID yang persis sebagai `model`. Jangan mengandalkan `/v1/models` untuk menemukan model chat; gunakan daftar ini atau [referensi (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-developers&utm_content=models-docs#models).

| Model | ID | Endpoint | Input | Terdokumentasi | Akses |
| --- | --- | --- | --- | --- | --- |
| [DeepSeek V4.1 Flash](https://broadrouter.com/id/models/deepseek-v4.1-flash/) | `broadnet/deepseek-v4.1-flash` | `/chat/completions` | Teks + Gambar | Penalaran | Perlu top up |
| [GLM 5.3](https://broadrouter.com/id/models/glm-5.3/) | `broadnet/glm-5.3` | `/chat/completions` | Teks | Tools, Output terstruktur, Penalaran | Perlu top up |
| [Qwen3.8 27B](https://broadrouter.com/id/models/qwen3.8-27b/) | `broadnet/qwen3.8-27b` | `/chat/completions` | Teks + Gambar | Tools, Output terstruktur, Penalaran | Perlu top up |
| [BroadNet Gemma 4 VL 26B](https://broadrouter.com/id/models/gemma-4-vl-26b/) | `broadnet/gemma-4-26b-a4b` | `/chat/completions` | Teks + Gambar | — | Kredit awal |
| [BroadNet Transcribe Arabic](https://broadrouter.com/id/models/cohere-transcribe-arabic/) | `broadnet/cohere-transcribe-arabic` | `/audio/transcriptions` | Audio bahasa Arab | — | Kredit awal |
| [BroadNet Transcribe](https://broadrouter.com/id/models/cohere-transcribe/) | `broadnet/cohere-transcribe` | `/audio/transcriptions` | Audio, 14 bahasa | — | Kredit awal |

Kolom "Terdokumentasi" mencantumkan tools, output terstruktur, dan penalaran yang disebut referensi BroadNet untuk setiap model (diperiksa 2026-11-15). Tanda hubung berarti referensi tidak menyebutnya; bukan berarti fitur itu tidak ada.

## Pindah dari API lain yang kompatibel dengan OpenAI: checklist

Format permintaannya sudah familier, tetapi setiap model berbeda. Periksa setiap poin untuk model pilihan Anda, dan uji dulu sebelum memindahkan trafik.

1.  **Endpoint.** Atur base URL ke `https://inference.broadnet.ai/v1`.
2.  **Kunci.** Gunakan kunci inferensi BroadNet dari environment variable. Kunci paket dan kunci bayar sesuai pemakaian itu terpisah.
3.  **ID model.** Gunakan ID yang persis, misalnya `broadnet/gemma-4-26b-a4b`.
4.  **Parameter.** Pastikan setiap parameter yang Anda kirim terdokumentasi untuk model tersebut. Hapus yang tidak tercantum.
5.  **Streaming.** Pastikan klien Anda membaca SSE sampai `[DONE]` dan menangani stream yang berhenti lebih awal.
6.  **Tools dan output terstruktur.** Referensi mendokumentasikannya untuk GLM 5.3 dan Qwen3.8 27B. Uji model lain sebelum mengandalkannya.
7.  **Penalaran.** Penalaran bisa memakai sebagian anggaran output. Sisakan ruang di `max_tokens`; lihat [jawaban kosong dari model penalaran](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).
8.  **Batas.** Kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 permintaan bersamaan. Sesi paket mengizinkan satu permintaan dalam satu waktu. Kunci per jam Gemma mengizinkan satu stream, 120 permintaan per menit, dan 300.000 token per menit.
9.  **Konteks.** Konteks mencakup input dan jawaban. Periksa batas model di [halaman modelnya](https://broadrouter.com/id/models/).
10.  **Error.** Petakan kode status di bawah ke tindakan coba ulang atau perbaikan, dan catat `X-Request-ID`.
11.  **Biaya.** Buat estimasi dengan [kalkulator harga](https://broadrouter.com/id/pricing/). Pada bayar sesuai pemakaian, gambar dihitung sebagai token input.

## Error mana yang perlu dicoba ulang?

| Status | Arti | Tindakan |
| --- | --- | --- |
| 400 / 422 | Permintaan atau field tidak valid | Perbaiki permintaan; jangan dicoba ulang apa adanya |
| 401 | Kunci tidak ada, tidak valid, atau kedaluwarsa, atau jatah sudah habis | Periksa kunci dan akun |
| 402 | `insufficient_balance` | Top up, lalu coba lagi |
| 413 | Permintaan melebihi batas byte atau teks | Kirim lebih sedikit, misalnya file audio yang lebih kecil |
| 429 | Batas laju, konkurensi, token per menit, atau pengeluaran | Tunggu dengan batas percobaan, lalu coba lagi |
| 500–504 | Masalah di sisi server | Coba ulang dengan exponential backoff yang dibatasi |

Diringkas dari [tabel error di referensi (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-developers&utm_content=errors-docs#errors), diperiksa 2026-11-15. [Contoh kode untuk percobaan ulang](https://broadrouter.com/id/guides/errors-and-retries/).

## Di mana dokumentasi dan panduan lengkapnya?

-   [**Referensi developer (bahasa Inggris)**Format permintaan, batas, error, dan feed harga. Sumber resmi.](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-developers&utm_content=docs)
-   [**Integrasi (bahasa Inggris)**Pengaturan untuk Aider, Cline, LangChain, n8n, LiteLLM, dan tool lain yang kompatibel dengan OpenAI.](https://broadrouter.com/integrations/)
-   [**Panduan**SDK, streaming, percobaan ulang, daftar IP yang diizinkan, dan suara bahasa Arab.](https://broadrouter.com/id/guides/)
-   [**Panduan SDK Python**Instalasi, permintaan pertama, dan streaming dengan OpenAI Python SDK.](https://broadrouter.com/id/guides/openai-python-sdk/)
-   [**Panduan SDK Node**Hal yang sama di JavaScript dan TypeScript, dengan ID permintaan.](https://broadrouter.com/id/guides/openai-node-sdk/)
-   [**Panduan cepat cURL**Semua permintaan dari shell.](https://broadrouter.com/id/guides/curl-quickstart/)
-   [**Kunci dan daftar IP yang diizinkan**Batasi kunci hanya untuk server Anda.](https://broadrouter.com/id/guides/api-keys-ip-allow-lists/)
-   [**Pembuat permintaan API (bahasa Inggris)**Susun permintaan di browser lalu salin.](https://broadrouter.com/tools/api-request-builder/)

Butuh endpoint privat atau model yang tidak ada di daftar? [Hubungi BroadNet](https://broadrouter.com/id/contact/#private).

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-developers&utm_content=page-cta) ·

**Sumber**

-   [Referensi developer BroadNet Inference (diperiksa 2026-11-15) (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-developers&utm_content=sources)
-   [Harga BroadNet Inference (bahasa Inggris)](https://inference.broadnet.ai/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-developers&utm_content=sources)
-   [pricing.json, daftar tarif resmi (bahasa Inggris)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-developers&utm_content=sources)
