---
title: "Mula pantas BroadNet Inference API: Python dan cURL | BroadRouter"
description: "Hantar permintaan chat dan transkripsi pertama anda ke BroadNet Inference dengan Python atau cURL, kemudian ikuti senarai semak migrasi untuk model anda."
url: https://broadrouter.com/ms/developers/
lang: ms
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

# Pembangun

Dikemas kini 2026-11-15

BroadNet Inference menggunakan bentuk permintaan OpenAI di `https://inference.broadnet.ai/v1`. Cipta kunci dalam konsol, simpan dalam pembolehubah persekitaran, dan hantar permintaan ke `/chat/completions` atau `/audio/transcriptions` dengan ID model yang tepat. Sebelum memindahkan trafik pengeluaran, semak parameter, penstriman, alatan, had dan ralat untuk model itu.

-   Mula pantas chat
-   Mula pantas transkripsi
-   ID model
-   Senarai semak migrasi
-   Ralat dan cuba semula
-   Dokumentasi dan panduan

## Bagaimanakah saya menghantar permintaan chat pertama?

1.  Log masuk di [inference.broadnet.ai (Bahasa Inggeris)](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-developers&utm_content=quickstart-account) dan cipta kunci inferens. Ia dipaparkan sekali sahaja; konsol hanya menyimpan cincangnya (hash).
2.  Pasang SDK OpenAI dan tetapkan kunci dalam shell anda. Simpan kunci di pelayan anda, jangan sekali-kali dalam kod pelayar.
3.  Hantar permintaan. Baca jawapan daripada `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 menggunakan BroadNet Gemma 4 VL 26B, yang diliputi oleh kredit permulaan US$5. DeepSeek V4.1 Flash, GLM 5.3 dan Qwen3.8 27B memerlukan tambah nilai terlebih dahulu. Simpan pengepala respons `X-Request-ID` untuk sokongan.

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.

### Penstriman

Tetapkan `stream=true` dan baca Server-Sent Events sehingga `data: [DONE]`. Dengan `stream_options.include_usage`, penggunaan token tiba dalam cebisan terakhir. Jika strim tamat sebelum `[DONE]`, anggap jawapan itu tidak lengkap. BroadNet meminta anda mengesahkan penstriman bagi setiap model sebelum bergantung padanya dalam pengeluaran.

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."}]}'
```

## Bagaimanakah saya mentranskripsikan audio?

Hantar WAV atau MP3, sehingga 26,214,400 bait setiap fail, ke `/audio/transcriptions`. Sentiasa tetapkan `language`: tanpanya, bahasa Arab boleh dikembalikan dalam huruf Rumi. Gunakan `language=ar` untuk bahasa Arab. Tukar `.ogg` atau `.m4a` terlebih dahulu: `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
```

Respons ialah JSON dengan transkrip dalam `text`. [Model bahasa Arab atau berbilang bahasa, dan kos audio](https://broadrouter.com/ms/arabic-transcription/).

## ID model manakah yang boleh saya gunakan?

Hantar ID yang tepat sebagai `model`. Jangan bergantung pada `/v1/models` untuk mencari model chat; gunakan senarai ini atau [rujukan (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-developers&utm_content=models-docs#models).

| Model | ID | Endpoint | Input | Didokumenkan | Akses |
| --- | --- | --- | --- | --- | --- |
| [DeepSeek V4.1 Flash](https://broadrouter.com/ms/models/deepseek-v4.1-flash/) | `broadnet/deepseek-v4.1-flash` | `/chat/completions` | Teks + Imej | Penaakulan | Perlu tambah nilai |
| [GLM 5.3](https://broadrouter.com/ms/models/glm-5.3/) | `broadnet/glm-5.3` | `/chat/completions` | Teks | Alatan, Output berstruktur, Penaakulan | Perlu tambah nilai |
| [Qwen3.8 27B](https://broadrouter.com/ms/models/qwen3.8-27b/) | `broadnet/qwen3.8-27b` | `/chat/completions` | Teks + Imej | Alatan, Output berstruktur, Penaakulan | Perlu tambah nilai |
| [BroadNet Gemma 4 VL 26B](https://broadrouter.com/ms/models/gemma-4-vl-26b/) | `broadnet/gemma-4-26b-a4b` | `/chat/completions` | Teks + Imej | — | Kredit permulaan |
| [BroadNet Transcribe Arabic](https://broadrouter.com/ms/models/cohere-transcribe-arabic/) | `broadnet/cohere-transcribe-arabic` | `/audio/transcriptions` | Audio bahasa Arab | — | Kredit permulaan |
| [BroadNet Transcribe](https://broadrouter.com/ms/models/cohere-transcribe/) | `broadnet/cohere-transcribe` | `/audio/transcriptions` | Audio, 14 bahasa | — | Kredit permulaan |

"Didokumenkan" menyenaraikan alatan, output berstruktur dan penaakulan yang dinamakan oleh rujukan BroadNet untuk setiap model (disemak 2026-11-15). Sengkang bermaksud rujukan tidak menamakannya; ia tidak bermaksud ciri itu tiada.

## Berpindah daripada API lain yang serasi OpenAI: senarai semak

Bentuk permintaannya biasa, tetapi model berbeza. Semak setiap perkara untuk model yang anda pilih, dan uji sebelum mengalihkan trafik.

1.  **Endpoint.** Tetapkan URL asas kepada `https://inference.broadnet.ai/v1`.
2.  **Kunci.** Gunakan kunci inferens BroadNet daripada pembolehubah persekitaran. Kunci pelan dan kunci bayar ikut guna adalah berasingan.
3.  **ID model.** Gunakan ID yang tepat, contohnya `broadnet/gemma-4-26b-a4b`.
4.  **Parameter.** Pastikan setiap parameter yang anda hantar didokumenkan untuk model itu. Buang parameter yang tidak disenaraikan.
5.  **Penstriman.** Sahkan klien anda membaca SSE hingga `[DONE]` dan mengendalikan strim yang tamat awal.
6.  **Alatan dan output berstruktur.** Rujukan mendokumenkannya untuk GLM 5.3 dan Qwen3.8 27B. Uji model lain sebelum bergantung padanya.
7.  **Penaakulan.** Penaakulan boleh menggunakan sebahagian bajet output. Beri ruang dalam `max_tokens`; lihat [jawapan kosong daripada model penaakulan](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
8.  **Had.** Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak. Sesi pelan membenarkan satu permintaan pada satu masa. Kunci sejam Gemma membenarkan satu strim, 120 permintaan seminit dan 300,000 token seminit.
9.  **Konteks.** Konteks merangkumi input dan jawapan. Semak had model itu pada [halaman modelnya](https://broadrouter.com/ms/models/).
10.  **Ralat.** Petakan kod status di bawah kepada tindakan cuba semula atau pembetulan, dan log `X-Request-ID`.
11.  **Kos.** Anggarkan dengan [kalkulator harga](https://broadrouter.com/ms/pricing/). Imej dikira sebagai token input bagi bayar ikut guna.

## Ralat manakah yang patut saya cuba semula?

| Status | Maksud | Tindakan |
| --- | --- | --- |
| 400 / 422 | Permintaan atau medan tidak sah | Betulkan permintaan; jangan cuba semula tanpa perubahan |
| 401 | Kunci tiada, tidak sah atau tamat tempoh, atau peruntukan habis | Semak kunci dan akaun |
| 402 | `insufficient_balance` | Tambah nilai, kemudian cuba semula |
| 413 | Permintaan melebihi had bait atau teks | Hantar kurang, contohnya fail audio yang lebih kecil |
| 429 | Had kadar, keserentakan, kadar token atau perbelanjaan | Undur dengan had, kemudian cuba semula |
| 500–504 | Masalah di sebelah pelayan | Cuba semula dengan backoff eksponen yang terhad |

Diringkaskan daripada [jadual ralat rujukan (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-developers&utm_content=errors-docs#errors), disemak 2026-11-15. [Contoh kod cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).

## Di manakah dokumentasi dan panduan penuh?

-   [**Rujukan pembangun (Bahasa Inggeris)**Bentuk permintaan, had, ralat dan suapan harga. Sumber yang berwibawa.](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-developers&utm_content=docs)
-   [**Integrasi (Bahasa Inggeris)**Tetapan untuk Aider, Cline, LangChain, n8n, LiteLLM dan alatan lain yang serasi OpenAI.](https://broadrouter.com/integrations/)
-   [**Panduan**SDK, penstriman, cuba semula, senarai benar IP dan pertuturan Arab.](https://broadrouter.com/ms/guides/)
-   [**Panduan SDK Python**Pemasangan, permintaan pertama dan penstriman dengan SDK Python OpenAI.](https://broadrouter.com/ms/guides/openai-python-sdk/)
-   [**Panduan SDK Node**Perkara yang sama dalam JavaScript dan TypeScript, dengan ID permintaan.](https://broadrouter.com/ms/guides/openai-node-sdk/)
-   [**Mula pantas cURL**Setiap permintaan daripada shell.](https://broadrouter.com/ms/guides/curl-quickstart/)
-   [**Kunci dan senarai benar IP**Hadkan penggunaan kunci kepada pelayan anda.](https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/)
-   [**Pembina permintaan API (Bahasa Inggeris)**Bina permintaan dalam pelayar anda dan salinnya.](https://broadrouter.com/tools/api-request-builder/)

Perlukan endpoint persendirian atau model yang tidak disenaraikan? [Hubungi BroadNet](https://broadrouter.com/ms/contact/#private).

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

**Sumber**

-   [Rujukan pembangun BroadNet Inference (disemak 2026-11-15) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-developers&utm_content=sources)
-   [Harga BroadNet Inference (Bahasa Inggeris)](https://inference.broadnet.ai/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-developers&utm_content=sources)
-   [pricing.json, senarai kadar terbitan (Bahasa Inggeris)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-developers&utm_content=sources)
