---
title: "OpenAI Python SDK na may custom base_url (BroadNet) | BroadRouter"
description: "Ituro ang opisyal na OpenAI Python SDK sa BroadNet Inference sa isang palit lang ng base_url. Mag-install, i-set ang key, magpadala ng request at i-stream ang sagot."
url: https://broadrouter.com/fil/guides/openai-python-sdk/
lang: fil
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Isinalin mula sa Ingles sa tulong ng AI. [Basahin ang orihinal sa Ingles](https://broadrouter.com/guides/openai-python-sdk/) (na-update noong 2026-11-16).

# Paano gamitin ang OpenAI Python SDK sa BroadNet Inference

Na-update 2026-11-16

I-install ang openai package, saka gawin ang client na may base\_url na https://inference.broadnet.ai/v1 at ang BroadNet key mo bilang api\_key. Gumagana nang walang binabago ang bawat chat.completions call; ang model ID lang ang nagbabago, halimbawa broadnet/deepseek-v4.1-flash. Chat completions at transcriptions ang sinusuportahan ng BroadNet, hindi ang Responses API.

Kailangan mo ng BroadNet Inference account at inference key. Nagsisimula ang mga bagong account sa $5 na credit, walang card na kailangan; [gumawa ng account sa inference.broadnet.ai](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-openai-python-sdk&utm_content=body). Isang beses lang ipinapakita ng console ang key, at hash lang nito ang itinatago, kaya kopyahin ito agad sa environment mo.

## 1\. Mag-install at i-set ang key

Kailangan ng kasalukuyang `openai` package (3.x) ang Python 3.10 o mas bago.

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

## 2\. Magpadala ng unang request

I-save ito bilang `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)
```

Patakbuhin ito gamit ang `python first_request.py`. `broadnet/gemma-4-26b-a4b` ang gamit ng example dahil gumagana ito sa libreng credit. Magagamit ang ibang chat model pagkatapos mag-top up.

## 3\. Lumipat sa model na gusto mo

`model` lang ang palitan:

| Kailangan mo | Model ID |
| --- | --- |
| Unlimited sa flat plan, 1M na context | `broadnet/deepseek-v4.1-flash` |
| Tools at structured output, 1M na context | `broadnet/glm-5.3` |
| Arabic na text at mga larawan | `broadnet/qwen3.8-27b` |
| Mababang presyo, gumagana sa libreng credit | `broadnet/gemma-4-26b-a4b` |

Nagre-reason muna ang DeepSeek V4.1 Flash, GLM 5.3 at Qwen3.8 27B bago sumagot, at kasama ang reasoning sa `max_tokens`. Bigyan sila ng 1,000 token o higit pa. [Ito ang dahilan kung bakit walang laman ang sagot kapag maliit ang limit](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/).

## 4\. I-stream ang sagot

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

Kapag may `include_usage`, darating ang bilang ng token sa huling chunk, na walang `choices`. Tinatalakay ng [streaming guide](https://broadrouter.com/fil/guides/streaming-chat-completions/) ang mga naputol na connection.

## 5\. Itago ang request ID

May `X-Request-ID` header ang bawat response. I-log ito: hinihingi ito ng support ng BroadNet. Sa mga parsed na response, makukuha ito sa `response._request_id`. Para basahin ito kasama ng ibang header:

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

Ang mga pay-as-you-go key ay may 30 request kada minuto at 4 na sabay-sabay na request. [Ano ang ibig sabihin ng bawat error code at kailan dapat mag-retry](https://broadrouter.com/fil/guides/errors-and-retries/).

## Troubleshooting

-   **`AuthenticationError` (401).** Mali o expired ang key, o ubos na ang pay-as-you-go allowance. Tiyaking naka-set ang `BROADNET_API_KEY` sa process na nagpapatakbo ng code mo.
-   **`NotFoundError` (404).** Tiyaking nagtatapos sa `/v1` ang `base_url` at `chat.completions` ang tinatawag mo, hindi `responses`. Pagkatapos, suriin ang model ID, kasama ang `broadnet/` prefix.
-   **Pumapalya ang bayad na model sa bagong account.** Sakop ng $5 na panimulang credit ang BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) at ang dalawang BroadNet Transcribe model. Mag-top up para magamit ang ibang chat model: DeepSeek V4.1 Flash, GLM 5.3 at Qwen3.8 27B.
-   **Walang laman ang `content`.** Kasama ang reasoning sa `max_tokens`. Taasan ito sa 1,000 o higit pa. [Bakit walang laman ang mga sagot](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/).
-   **`RateLimitError` (429).** Lumampas ka sa per-minute o concurrent na limit. Dalawang beses nagre-retry ang SDK bilang default; i-set ang `max_retries` sa client para baguhin iyon.
-   **Mga error sa custom HTTP client pagkatapos mag-upgrade.** HTTPX2 ang gamit ng 3.x na SDK. Kung nagpapasa ka ng sarili mong `http_client`, sundan ang HTTPX2 migration guide ng SDK.

## Mga termino sa gabay na ito

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

Ang API key ay isang lihim na string na kumikilala at nagpapahintulot sa client na tumatawag sa isang API. Kadalasang hinihingi ito ng mga LLM API sa Authorization: Bearer header, at ang sinumang may hawak ng key ay makakagawa ng mga request na sisingilin sa account na may-ari nito.

[Pay-as-you-go](https://broadrouter.com/fil/glossary/pay-as-you-go/)

Ang pay-as-you-go ay paraan ng pagpepresyo kung saan ang nagamit mo lang ang binabayaran mo, sinusukat kada yunit gaya ng token, request o minuto ng audio, nang walang subscription o minimum na commitment. Ganito naniningil ang karamihan ng LLM API, mula sa prepaid na balance o sa pana-panahong invoice.

[Concurrency](https://broadrouter.com/fil/glossary/concurrency/)

Ang concurrency ay ang bilang ng request na sabay-sabay na in flight mula sa isang client. Madalas itong nililimitahan ng mga LLM API kada key o plan, hiwalay sa requests per minute, dahil humahawak ng GPU capacity ang bawat bukas na request hanggang matapos ang response nito.

[Context window](https://broadrouter.com/fil/glossary/context-window/)

Ang context window ay ang pinakamaraming token na kayang hawakan ng isang language model sa iisang request. Sakop nito ang prompt, history ng usapan, tool definitions, mga larawan at ang nabuong output, kasama ang anumang reasoning tokens. Ang hindi kasya ay kailangang bawasan, ibuod o hatiin sa ilang request.

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

Ang token ay ang yunit ng text na binabasa at isinusulat ng isang language model: isang salita, bahagi ng salita, bantas o byte sequence na ginawa ng tokenizer ng model. Sa token binibilang, nililimitahan at kadalasang sinisingil ng mga LLM API ang paggamit.

[Flat-rate LLM plan (unlimited na plan)](https://broadrouter.com/fil/glossary/flat-rate-llm-plan/)

Ang flat-rate LLM plan ay naniningil ng fixed na presyo para sa isang period, gaya ng isang buwan, para sa access sa language model API sa halip na maningil kada token. Kadalasang may ibang nililimitahan ang ganitong plan, gaya ng concurrency, bilis, mga model o usage window, kaya kasinghalaga ng presyo ang mga limit.

[Rate limit](https://broadrouter.com/fil/glossary/rate-limit/)

Ang rate limit ay hangganang itinatakda ng API sa dami ng paggamit ng isang client sa isang yugto ng oras, gaya ng request kada minuto o token kada minuto. Tinatanggihan ang mga request na lampas sa limit, kadalasan na may HTTP 429 Too Many Requests, hanggang bumaba ulit ang paggamit.

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

Ang streaming ay paraan ng pagbabalik ng sagot ng language model nang paunti-unting chunk habang binubuo pa ito, sa halip na iisang sagot sa dulo. Sa mga OpenAI-compatible na API, dumadaan ang streaming sa server-sent events kapag naka-set sa true ang stream sa request.

## Mga tanong

### Kailangan ko ba ng ibang SDK?

Hindi. Sinusunod ng BroadNet Inference ang format ng OpenAI chat completions at audio transcriptions, kaya gumagana ang opisyal na openai package basta iba ang base\_url.

### Puwede ko bang gamitin pa rin ang OPENAI\_API\_KEY?

Puwede, pero kapag hiwalay na BROADNET\_API\_KEY variable ang gamit mo, hindi mo aksidenteng maipapadala ang key ng isang provider sa ibang provider.

### Binabasa ba ng SDK ang OPENAI\_BASE\_URL?

Oo. Kapag hindi mo ipinasa ang base\_url, ang OPENAI\_BASE\_URL ang gagamitin ng client. I-set ito sa https://inference.broadnet.ai/v1 at i-set ang OPENAI\_API\_KEY sa BroadNet key mo, at hindi na kailangan ng arguments ang OpenAI().

### Puwede ko bang gamitin ang client.responses.create sa BroadNet?

Hindi. Responses API ang unang ipinapakita sa README ng SDK, pero chat completions at audio transcriptions lang ang nakalista sa docs ng BroadNet. Gamitin ang client.chat.completions.create.

## Mga kaugnay na gabay

-   [Paano gamitin ang OpenAI Node.js SDK sa BroadNet Inference](https://broadrouter.com/fil/guides/openai-node-sdk/)
-   [Paano mag-stream ng chat completions at ayusin ang naputol na stream](https://broadrouter.com/fil/guides/streaming-chat-completions/)
-   [Bakit walang laman ang sagot ng isang reasoning model](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/)
-   [Mga error code ng BroadNet Inference at kailan dapat mag-retry](https://broadrouter.com/fil/guides/errors-and-retries/)

Subukan ito sa totoong workload mo. May US$5 na panimulang credit ang mga bagong account para sa Gemma at transcription. Kailangan ng top-up para sa DeepSeek, GLM, at Qwen3.8.

[Magsimula](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-openai-python-sdk&utm_content=page-cta) ·

**Mga source**

-   [API reference ng BroadNet Inference, unang request (Ingles)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-openai-python-sdk&utm_content=sources#base-url)
-   [OpenAI Python library sa PyPI (3.x, Python 3.10+, sinuri noong 2026-11-14)](https://pypi.org/project/openai/)
