---
title: "OpenAI Python SDK dengan base_url tersuai (BroadNet)"
description: "Halakan OpenAI Python SDK rasmi ke BroadNet Inference dengan satu perubahan base_url. Pasang, tetapkan kunci, buat permintaan pertama dan strim jawapan."
url: https://broadrouter.com/ms/guides/openai-python-sdk/
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/openai-python-sdk/) (dikemas kini 2026-11-16).

# Cara guna OpenAI Python SDK dengan BroadNet Inference

Dikemas kini 2026-11-16

Pasang pakej openai, kemudian cipta klien dengan base\_url ditetapkan kepada https://inference.broadnet.ai/v1 dan kunci BroadNet anda sebagai api\_key. Setiap panggilan chat.completions berfungsi tanpa perubahan; hanya ID model yang bertukar, contohnya broadnet/deepseek-v4.1-flash. BroadNet menyediakan chat completions dan transkripsi, bukan Responses API.

Anda memerlukan akaun BroadNet Inference dan kunci inferens. Akaun baharu bermula dengan kredit $5 tanpa kad; [cipta akaun di inference.broadnet.ai](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-openai-python-sdk&utm_content=body). Konsol memaparkan kunci sekali sahaja dan hanya menyimpan hash kunci itu, jadi salin terus ke persekitaran anda.

## 1\. Pasang dan tetapkan kunci

Pakej `openai` semasa (3.x) memerlukan Python 3.10 atau lebih baharu.

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

## 2\. Buat permintaan pertama

Simpan kod ini sebagai `first_request.py`:

```python
from openai import OpenAI
import os

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

Jalankan dengan `python first_request.py`. Contoh ini menggunakan `broadnet/gemma-4-26b-a4b` kerana ia berfungsi pada kredit percuma. Model chat lain tersedia selepas tambah nilai.

## 3\. Tukar kepada model yang anda mahu

Tukar `model` sahaja:

| Anda mahu | ID model |
| --- | --- |
| Tanpa had pada pelan harga tetap, konteks 1M | `broadnet/deepseek-v4.1-flash` |
| Alatan dan output berstruktur, konteks 1M | `broadnet/glm-5.3` |
| Teks dan imej bahasa Arab | `broadnet/qwen3.8-27b` |
| Harga rendah, berfungsi pada kredit percuma | `broadnet/gemma-4-26b-a4b` |

DeepSeek V4.1 Flash, GLM 5.3 dan Qwen3.8 27B membuat penaakulan sebelum menjawab, dan penaakulan itu dikira dalam `max_tokens`. Beri mereka 1,000 token atau lebih. [Inilah sebabnya had yang kecil memulangkan jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).

## 4\. Strim jawapan

```python
stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash",
    stream=True,
    stream_options={"include_usage": True},
    messages=[{"role": "user", "content": "Count from one to three."}],
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:
        print("\n", chunk.usage)
```

Dengan `include_usage`, bilangan token tiba dalam chunk terakhir, yang tidak mempunyai `choices`. [Panduan penstriman](https://broadrouter.com/ms/guides/streaming-chat-completions/) menerangkan sambungan yang terputus.

## 5\. Simpan ID permintaan

Setiap respons membawa pengepala `X-Request-ID`. Log nilai itu: sokongan BroadNet akan memintanya. Respons yang telah dihurai mendedahkannya sebagai `response._request_id`. Untuk membacanya bersama pengepala lain:

```python
raw = client.chat.completions.with_raw_response.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Hi"}],
)
print(raw.headers.get("x-request-id"))
response = raw.parse()
```

Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 permintaan serentak. [Maksud setiap kod ralat dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).

## Penyelesaian masalah

-   **`AuthenticationError` (401).** Kunci salah, tamat tempoh, atau elaun bayar ikut guna telah habis. Pastikan `BROADNET_API_KEY` ditetapkan dalam proses yang menjalankan kod anda.
-   **`NotFoundError` (404).** Pastikan `base_url` berakhir dengan `/v1` dan anda memanggil `chat.completions`, bukan `responses`. Kemudian semak ID model, termasuk awalan `broadnet/`.
-   **Model berbayar gagal pada akaun baharu.** Kredit permulaan $5 meliputi BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) dan dua model BroadNet Transcribe. Buat tambah nilai untuk menggunakan model chat lain: DeepSeek V4.1 Flash, GLM 5.3 dan Qwen3.8 27B.
-   **`content` kosong.** Penaakulan dikira dalam `max_tokens`. Naikkan kepada 1,000 atau lebih. [Mengapa jawapan kembali kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
-   **`RateLimitError` (429).** Anda melebihi had seminit atau had serentak. Secara lalai, SDK mencuba semula dua kali; tetapkan `max_retries` pada klien untuk mengubahnya.
-   **Ralat klien HTTP tersuai selepas naik taraf.** SDK 3.x menggunakan HTTPX2. Jika anda menghantar `http_client` sendiri, ikut panduan migrasi HTTPX2 SDK tersebut.

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

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

[Tetingkap konteks (context window)](https://broadrouter.com/ms/glossary/context-window/)

Tetingkap konteks ialah bilangan maksimum token yang boleh dikendalikan oleh model bahasa dalam satu permintaan. Ia meliputi prompt, sejarah perbualan, definisi alatan, imej dan output yang dijana, termasuk token penaakulan. Apa-apa yang tidak muat mesti dipotong, diringkaskan atau dipecahkan kepada beberapa permintaan.

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

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

[Kunci API (API key)](https://broadrouter.com/ms/glossary/api-key/)

Kunci API ialah rentetan rahsia yang mengenal pasti dan membenarkan klien yang memanggil sesuatu API. API LLM biasanya menjangkakannya dalam pengepala Authorization: Bearer, dan sesiapa yang memegang kunci itu boleh membuat permintaan yang dibilkan kepada akaun pemiliknya.

[Output berstruktur (structured output)](https://broadrouter.com/ms/glossary/structured-output/)

Output berstruktur ialah ciri API LLM yang mengehadkan balasan model kepada format yang ditetapkan oleh pembangun, biasanya JSON Schema, supaya kod boleh menghuraikannya dengan boleh dipercayai. Ia lebih ketat daripada JSON mode, yang menjamin JSON yang sah tetapi bukan bentuk tertentu.

## Soalan lazim

### Adakah saya memerlukan SDK lain?

Tidak. BroadNet Inference menggunakan bentuk chat completions dan audio transcriptions OpenAI, jadi pakej openai rasmi berfungsi dengan base\_url yang berbeza.

### Bolehkah saya terus menggunakan OPENAI\_API\_KEY?

Boleh, tetapi pembolehubah BROADNET\_API\_KEY yang berasingan mengelakkan anda tersilap menghantar kunci satu penyedia kepada penyedia lain.

### Adakah SDK membaca OPENAI\_BASE\_URL?

Ya. Jika anda tidak menghantar base\_url, klien menggunakan OPENAI\_BASE\_URL. Tetapkan nilainya kepada https://inference.broadnet.ai/v1 dan tetapkan OPENAI\_API\_KEY kepada kunci BroadNet anda, maka OpenAI() tidak memerlukan sebarang argumen.

### Bolehkah saya menggunakan client.responses.create dengan BroadNet?

Tidak. README SDK itu mengutamakan Responses API, tetapi dokumentasi BroadNet hanya menyenaraikan chat completions dan audio transcriptions. Gunakan client.chat.completions.create.

## Panduan berkaitan

-   [Cara guna OpenAI Node.js SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-node-sdk/)
-   [Strim chat completions dan kendalikan sambungan yang terputus](https://broadrouter.com/ms/guides/streaming-chat-completions/)
-   [Mengapa model penaakulan memulangkan jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/)
-   [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-openai-python-sdk&utm_content=page-cta) ·

**Sumber**

-   [Rujukan API BroadNet Inference, permintaan pertama (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-openai-python-sdk&utm_content=sources#base-url)
-   [Pustaka OpenAI Python di PyPI (3.x, Python 3.10+, disemak 2026-11-14)](https://pypi.org/project/openai/)
