---
title: "OpenAI Python SDK dengan base_url kustom (BroadNet) | BroadRouter"
description: "Arahkan OpenAI Python SDK resmi ke BroadNet Inference cukup dengan mengganti base_url. Instal, atur kunci, kirim permintaan pertama, dan stream jawabannya."
url: https://broadrouter.com/id/guides/openai-python-sdk/
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/openai-python-sdk/) (diperbarui 2026-11-16).

# Memakai OpenAI Python SDK dengan BroadNet Inference

Diperbarui 2026-11-16

Instal paket openai, lalu buat client dengan base\_url https://inference.broadnet.ai/v1 dan kunci BroadNet Anda sebagai api\_key. Semua panggilan chat.completions berjalan tanpa perubahan; yang berubah hanya ID model, misalnya broadnet/deepseek-v4.1-flash. BroadNet melayani chat completions dan transkripsi, bukan Responses API.

Anda memerlukan akun BroadNet Inference dan kunci inferensi. Akun baru dimulai dengan kredit $5 tanpa kartu; [buat akun di inference.broadnet.ai](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-openai-python-sdk&utm_content=body). Konsol hanya menampilkan kunci sekali dan hanya menyimpan hash-nya, jadi salin kunci langsung ke environment Anda.

## 1\. Instal dan atur kunci

Paket `openai` versi terbaru (3.x) memerlukan Python 3.10 atau lebih baru.

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

## 2\. Kirim permintaan pertama

Simpan kode 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 memakai `broadnet/gemma-4-26b-a4b` karena model itu berjalan dengan kredit gratis. Model chat lainnya tersedia setelah top up.

## 3\. Ganti ke model yang Anda inginkan

Ubah hanya `model`:

| Yang Anda perlukan | ID model |
| --- | --- |
| Unlimited dengan paket harga tetap, konteks 1M | `broadnet/deepseek-v4.1-flash` |
| Tools dan output terstruktur, konteks 1M | `broadnet/glm-5.3` |
| Teks dan gambar berbahasa Arab | `broadnet/qwen3.8-27b` |
| Harga rendah, berjalan dengan kredit gratis | `broadnet/gemma-4-26b-a4b` |

DeepSeek V4.1 Flash, GLM 5.3, dan Qwen3.8 27B bernalar sebelum menjawab, dan penalarannya dihitung dalam `max_tokens`. Beri mereka 1.000 token atau lebih. [Ini alasan batas yang kecil menghasilkan jawaban kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).

## 4\. Stream jawabannya

```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`, jumlah token tiba di chunk terakhir, yang tidak memiliki `choices`. [Panduan streaming](https://broadrouter.com/id/guides/streaming-chat-completions/) membahas koneksi yang terputus.

## 5\. Simpan request ID

Setiap respons membawa header `X-Request-ID`. Catat nilainya: tim dukungan BroadNet akan memintanya. Respons yang sudah di-parse menyediakannya sebagai `response._request_id`. Untuk membacanya bersama header 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 sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 permintaan yang berjalan bersamaan. [Arti setiap kode error dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/).

## Pemecahan masalah

-   **`AuthenticationError` (401).** Kunci salah, kedaluwarsa, atau jatah bayar sesuai pemakaian sudah habis. Pastikan `BROADNET_API_KEY` diatur di proses yang menjalankan kode Anda.
-   **`NotFoundError` (404).** Pastikan `base_url` diakhiri `/v1` dan Anda memanggil `chat.completions`, bukan `responses`. Lalu periksa ID model, lengkap dengan prefiks `broadnet/`.
-   **Model berbayar gagal di akun baru.** Kredit awal $5 mencakup BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) dan dua model BroadNet Transcribe. Lakukan top up untuk memakai model chat lainnya: DeepSeek V4.1 Flash, GLM 5.3, dan Qwen3.8 27B.
-   **`content` kosong.** Penalaran dihitung dalam `max_tokens`. Naikkan menjadi 1.000 atau lebih. [Kenapa jawaban kembali kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).
-   **`RateLimitError` (429).** Anda melewati batas per menit atau batas permintaan bersamaan. Secara default SDK mencoba ulang dua kali; atur `max_retries` pada client untuk mengubahnya.
-   **Error custom HTTP client setelah upgrade.** SDK 3.x memakai HTTPX2. Jika Anda mengirim `http_client` sendiri, ikuti panduan migrasi HTTPX2 dari SDK.

## Istilah dalam panduan ini

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

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

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

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

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

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

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

Kunci API adalah string rahasia yang mengidentifikasi dan mengotorisasi client yang memanggil API. API LLM biasanya mengharapkannya di header Authorization: Bearer, dan siapa pun yang memegang kunci itu bisa membuat permintaan yang ditagihkan ke akun pemiliknya.

[Output terstruktur (structured output)](https://broadrouter.com/id/glossary/structured-output/)

Output terstruktur adalah fitur API LLM yang membatasi balasan model pada format yang ditentukan developer, biasanya JSON Schema, agar kode bisa mem-parse-nya dengan andal. Fitur ini lebih ketat daripada JSON mode, yang menjamin JSON valid tetapi tidak menjamin bentuk tertentu.

## Pertanyaan umum

### Apakah saya perlu SDK lain?

Tidak. BroadNet Inference memakai format chat completions dan audio transcriptions OpenAI, jadi paket openai resmi bisa dipakai dengan base\_url yang berbeda.

### Bisakah saya tetap memakai OPENAI\_API\_KEY?

Bisa, tetapi variabel BROADNET\_API\_KEY yang terpisah mencegah Anda tidak sengaja mengirim kunci satu penyedia ke penyedia lain.

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

Ya. Jika Anda tidak mengisi base\_url, client memakai OPENAI\_BASE\_URL. Atur ke https://inference.broadnet.ai/v1 dan isi OPENAI\_API\_KEY dengan kunci BroadNet Anda, maka OpenAI() tidak perlu argumen apa pun.

### Bisakah saya memakai client.responses.create dengan BroadNet?

Tidak. README SDK memang mengedepankan Responses API, tetapi dokumentasi BroadNet hanya mencantumkan chat completions dan audio transcriptions. Gunakan client.chat.completions.create.

## Panduan terkait

-   [Memakai OpenAI Node.js SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-node-sdk/)
-   [Streaming chat completions dan menangani koneksi terputus](https://broadrouter.com/id/guides/streaming-chat-completions/)
-   [Kenapa model reasoning mengembalikan jawaban kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/)
-   [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-openai-python-sdk&utm_content=page-cta) ·

**Sumber**

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