---
title: "OpenAI Python SDK ile özel base_url (BroadNet) | BroadRouter"
description: "Resmi OpenAI Python SDK'yı tek bir base_url değişikliğiyle BroadNet Inference'a yönlendirin. Kurun, anahtarı ayarlayın, ilk isteği gönderin ve yanıtı akışla alın."
url: https://broadrouter.com/tr/guides/openai-python-sdk/
lang: tr
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

İngilizceden yapay zekâ desteğiyle çevrilmiştir. [İngilizce aslını okuyun](https://broadrouter.com/guides/openai-python-sdk/) (güncelleme: 2026-11-16).

# OpenAI Python SDK'yı BroadNet Inference ile kullanın

Güncellendi 2026-11-16

openai paketini kurun, ardından istemciyi base\_url değeri https://inference.broadnet.ai/v1 ve api\_key değeri BroadNet anahtarınız olacak şekilde oluşturun. Her chat.completions çağrısı değişmeden çalışır; yalnızca model kimliği değişir, örneğin broadnet/deepseek-v4.1-flash. BroadNet, Responses API'yi değil, chat completions ve transkripsiyon uç noktalarını sunar.

Bir BroadNet Inference hesabına ve bir çıkarım anahtarına ihtiyacınız var. Yeni hesaplar kart gerekmeden $5 krediyle başlar; [inference.broadnet.ai adresinde hesap oluşturun](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-openai-python-sdk&utm_content=body). Konsol anahtarı yalnızca bir kez gösterir ve yalnızca hash değerini saklar; anahtarı doğrudan ortamınıza kopyalayın.

## 1\. Kurun ve anahtarı ayarlayın

Güncel `openai` paketi (3.x) Python 3.10 veya daha yenisini gerektirir.

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

## 2\. İlk isteği gönderin

Bunu `first_request.py` olarak kaydedin:

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

`python first_request.py` ile çalıştırın. Örnek, ücretsiz krediyle çalıştığı için `broadnet/gemma-4-26b-a4b` kullanıyor. Diğer sohbet modelleri bakiye yükledikten sonra kullanılabilir.

## 3\. İstediğiniz modele geçin

Yalnızca `model` değerini değiştirin:

| İhtiyacınız | Model kimliği |
| --- | --- |
| Sabit fiyatlı planda sınırsız, 1M bağlam | `broadnet/deepseek-v4.1-flash` |
| Araçlar ve yapılandırılmış çıktı, 1M bağlam | `broadnet/glm-5.3` |
| Arapça metin ve görseller | `broadnet/qwen3.8-27b` |
| Düşük fiyat, ücretsiz krediyle çalışır | `broadnet/gemma-4-26b-a4b` |

DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B yanıt vermeden önce akıl yürütür ve akıl yürütme `max_tokens` sınırına dahildir. Bu modellere 1.000 veya daha fazla token verin. [Küçük bir sınırın neden boş yanıt döndürdüğünü burada okuyun](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).

## 4\. Yanıtı akışla alın

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

`include_usage` ile token sayıları, `choices` içermeyen son parçada gelir. Kopan bağlantılar [akış rehberinde](https://broadrouter.com/tr/guides/streaming-chat-completions/) ele alınıyor.

## 5\. İstek kimliğini saklayın

Her yanıt bir `X-Request-ID` başlığı taşır. Bunu kaydedin: BroadNet desteği bu değeri ister. Ayrıştırılmış yanıtlarda `response._request_id` olarak erişilebilir. Diğer başlıklarla birlikte okumak için:

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

Kullandıkça öde anahtarları dakikada 30 isteğe ve aynı anda 4 isteğe izin verir. [Her hata kodunun anlamı ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/).

## Sorun giderme

-   **`AuthenticationError` (401).** Anahtar yanlış, süresi dolmuş veya kullandıkça öde kullanım hakkı bitmiş. `BROADNET_API_KEY` değişkeninin kodunuzu çalıştıran süreçte tanımlı olduğunu kontrol edin.
-   **`NotFoundError` (404).** `base_url` değerinin `/v1` ile bittiğini ve `responses` değil `chat.completions` çağırdığınızı kontrol edin. Ardından model kimliğini `broadnet/` önekiyle birlikte kontrol edin.
-   **Ücretli model yeni hesapta çalışmıyor.** $5 başlangıç kredisi BroadNet Gemma 4 VL 26B’yi (`broadnet/gemma-4-26b-a4b`) ve iki BroadNet Transcribe modelini kapsar. Diğer sohbet modellerini (DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B) kullanmak için bakiye yükleyin.
-   **Boş `content`.** Akıl yürütme `max_tokens` sınırına dahildir. Değeri 1.000 veya daha yukarı çıkarın. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **`RateLimitError` (429).** Dakika başına veya eşzamanlı istek sınırını aştınız. SDK varsayılan olarak iki kez yeniden dener; bunu değiştirmek için istemcide `max_retries` ayarlayın.
-   **Yükseltmeden sonra özel HTTP istemcisi hataları.** 3.x SDK, HTTPX2 kullanır. Kendi `http_client` nesnenizi veriyorsanız SDK’nın HTTPX2 geçiş rehberini izleyin.

## Bu rehberdeki terimler

[Kullandıkça öde (pay-as-you-go)](https://broadrouter.com/tr/glossary/pay-as-you-go/)

Kullandıkça öde, abonelik veya asgari taahhüt olmadan yalnızca kullandığınız kadar ödediğiniz, token, istek veya ses dakikası gibi birimler üzerinden ölçülen bir fiyatlandırma modelidir. LLM API'lerinin çoğu bu şekilde, ön ödemeli bir bakiyeden veya dönemsel faturayla ücretlendirir.

[Eşzamanlılık (concurrency)](https://broadrouter.com/tr/glossary/concurrency/)

Eşzamanlılık (concurrency), bir istemcinin aynı anda işlemde olan istek sayısıdır. LLM API'leri bunu genellikle dakikadaki istek sayısından ayrı olarak anahtar veya plan başına sınırlar, çünkü açık her istek yanıtı bitene kadar GPU kapasitesi tutar.

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

Token, bir dil modelinin okuduğu ve yazdığı metin birimidir: modelin tokenizer'ının ürettiği bir kelime, kelime parçası, noktalama işareti veya bayt dizisi. LLM API'leri kullanımı token cinsinden sayar, sınırlar ve genellikle faturalandırır.

[Akış (streaming)](https://broadrouter.com/tr/glossary/streaming/)

Akış (streaming), bir dil modeli yanıtını sonda tek parça halinde değil, hâlâ üretilirken küçük parçalar halinde döndürme yöntemidir. OpenAI uyumlu API'ler, istekte stream değeri true olduğunda server-sent events (SSE) üzerinden akış yapar.

[Hız sınırı (rate limit)](https://broadrouter.com/tr/glossary/rate-limit/)

Hız sınırı (rate limit), bir API'nin bir istemcinin belirli bir zaman aralığındaki kullanımına koyduğu üst sınırdır; örneğin dakika başına istek veya dakika başına token. Sınırı aşan istekler, kullanım tekrar sınırın altına inene kadar genellikle HTTP 429 Too Many Requests ile reddedilir.

[Yapılandırılmış çıktı (structured output)](https://broadrouter.com/tr/glossary/structured-output/)

Yapılandırılmış çıktı, modelin yanıtını geliştiricinin belirlediği bir biçimle, genellikle bir JSON Schema ile sınırlayan bir LLM API özelliğidir; böylece kod yanıtı güvenilir şekilde ayrıştırabilir. Geçerli JSON'u garanti eden ama belirli bir yapıyı garanti etmeyen JSON modundan daha katıdır.

## Sık sorulan sorular

### Farklı bir SDK gerekir mi?

Hayır. BroadNet Inference OpenAI'nin chat completions ve audio transcriptions yapılarını kullanır; resmi openai paketi farklı bir base\_url ile çalışır.

### OPENAI\_API\_KEY kullanmaya devam edebilir miyim?

Edebilirsiniz, ancak ayrı bir BROADNET\_API\_KEY değişkeni, bir sağlayıcının anahtarını yanlışlıkla başka bir sağlayıcıya göndermenizi önler.

### SDK OPENAI\_BASE\_URL değişkenini okuyor mu?

Evet. base\_url vermezseniz istemci OPENAI\_BASE\_URL değerini kullanır. Bunu https://inference.broadnet.ai/v1 olarak, OPENAI\_API\_KEY değişkenini de BroadNet anahtarınız olarak ayarlarsanız OpenAI() hiç argüman gerektirmez.

### BroadNet ile client.responses.create kullanabilir miyim?

Hayır. SDK'nın README dosyası Responses API ile başlasa da BroadNet'in belgeleri yalnızca chat completions ve audio transcriptions uç noktalarını listeler. client.chat.completions.create kullanın.

## İlgili rehberler

-   [OpenAI Node.js SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-node-sdk/)
-   [Chat completions akışı ve kopan bağlantıları ele alma](https://broadrouter.com/tr/guides/streaming-chat-completions/)
-   [Akıl yürüten model neden boş yanıt döndürür?](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/)

Gerçek iş yükünüzle deneyin. Yeni hesaplar şunlar için US$5 kredi ile başlar: Gemma ve transkripsiyon. Bakiye yüklemesi gerekenler: DeepSeek, GLM ve Qwen3.8.

[Başlayın](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-openai-python-sdk&utm_content=page-cta) ·

**Kaynaklar**

-   [BroadNet Inference API referansı, ilk istek (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-openai-python-sdk&utm_content=sources#base-url)
-   [PyPI'daki OpenAI Python kütüphanesi (3.x, Python 3.10+, 2026-11-14 tarihinde kontrol edildi)](https://pypi.org/project/openai/)
