---
title: "Pydantic AI ile özel OpenAI uyumlu base_url | BroadRouter"
description: "Pydantic AI ajanlarını OpenAIChatModel ve OpenAICompatibleProvider ile BroadNet Inference'ta çalıştırın: araçlar, yapılandırılmış çıktı, model profili."
url: https://broadrouter.com/tr/guides/pydantic-ai-openai-compatible/
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/pydantic-ai-openai-compatible/) (güncelleme: 2026-11-16).

# Pydantic AI ve BroadNet Inference (OpenAICompatibleProvider)

Güncellendi 2026-11-16

pydantic-ai-slim\[openai\] paketini kurun, ardından broadnet/glm-5.3 gibi bir BroadNet model kimliği ve base URL'si https://inference.broadnet.ai/v1, API anahtarı BroadNet anahtarınız olan bir OpenAICompatibleProvider ile OpenAIChatModel oluşturun. Modeli Agent'a verin. BroadNet chat completions sunduğu için Responses modelini değil OpenAIChatModel'i kullanın. Pydantic AI belgelerine göre base\_url ile OpenAIProvider, OpenAI'nin kendisi içindir.

Pydantic AI, Pydantic ekibinin geliştirdiği bir Python ajan çerçevesidir. Yerleşik sağlayıcısı olmayan bir servis için belgeleri, servisin `base_url` değeriyle `OpenAICompatibleProvider` kullanmayı söyler. BroadNet Inference standart chat completions’ı `https://inference.broadnet.ai/v1` adresinde sunar, dolayısıyla izlenecek yol budur. BroadRouter, BroadNet’in kendi sitesidir; bu rehber 2.68 sürümü itibarıyla Pydantic AI belgelerini izler.

## Kurulum

```bash
pip install "pydantic-ai-slim[openai]"
export BROADNET_API_KEY='your-broadnet-key'
```

## Bağlanın

```python
import os
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai_compatible import OpenAICompatibleProvider

model = OpenAIChatModel(
    'broadnet/glm-5.3',
    provider=OpenAICompatibleProvider(
        'broadnet',
        base_url='https://inference.broadnet.ai/v1',
        api_key=os.environ['BROADNET_API_KEY'],
    ),
)

agent = Agent(model)
result = agent.run_sync('Give me three names for a Go linting tool.')
print(result.output)
```

Bunu çalıştırmak testin kendisidir: ekrana bir yanıt yazdırılıyorsa anahtar, URL ve model kimliği doğrudur.

-   **İlk argüman**, BroadNet’e gönderilen model kimliğidir. `broadnet/` önekiyle birlikte birebir kullanın.
-   **Sağlayıcı adı** (burada `'broadnet'`) her yanıtta kaydedilir. Pydantic AI belgeleri bu adı sabit tutmanızı söyler, çünkü önceki yanıtlardan hangi verilerin servise geri gönderileceğine bu ad karar verir.
-   **`OpenAIChatModel`’de kalın.** Pydantic AI belgelerine göre `OpenAIResponsesModel` yalnızca servis Responses API’yi uyguluyorsa kullanılmalıdır. BroadNet bu API’yi listelemez.

## Araçlar ve yapılandırılmış çıktı

```python
from pydantic import BaseModel

class City(BaseModel):
    name: str
    country: str

agent = Agent(model, output_type=City)
print(agent.run_sync('Which city hosts the Burj Khalifa?').output)
```

Araçlar ve yapılandırılmış çıktı için `broadnet/glm-5.3` veya `broadnet/qwen3.8-27b` kullanın; BroadNet’in belgeleri bu iki özelliği yalnızca bu iki model için listeler.

## Model profili ne zaman ayarlanmalı

Pydantic AI, istek profilini model adına göre seçer. Bir özellik yok sayılıyor veya reddediliyorsa belgeleri kendi `OpenAIModelProfile` nesnenizi vermenizi söyler. BroadNet için bilinmesi gereken iki ayar var:

```python
from pydantic_ai.profiles.openai import OpenAIModelProfile

model = OpenAIChatModel(
    'broadnet/glm-5.3',
    provider=OpenAICompatibleProvider('broadnet', base_url='https://inference.broadnet.ai/v1', api_key=os.environ['BROADNET_API_KEY']),
    profile=OpenAIModelProfile(
        openai_chat_supports_max_completion_tokens=False,  # send max_tokens, the field BroadNet documents
        openai_supports_strict_tool_definition=False,      # only if strict tool schemas are rejected
    ),
)
```

Çıktı sınırını model ayarlarıyla verin, örneğin `agent.run_sync(prompt, model_settings={'max_tokens': 2000})`. DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B’de akıl yürütme bu sınıra dahildir.

## Hangi modeli seçmeli

| Ajan | Model |
| --- | --- |
| Araçlar, yapılandırılmış çıktı | `broadnet/glm-5.3` |
| Görseller veya Arapça metin, araçlarla | `broadnet/qwen3.8-27b` |
| Uzun belgeler, sabit fiyatlı plan | `broadnet/deepseek-v4.1-flash` |
| Ücretsiz başlangıç kredisi | `broadnet/gemma-4-26b-a4b` (32.768 token’lık bağlam) |

[Tüm modellerin fiyatları](https://broadrouter.com/tr/pricing/).

## Sorun giderme

-   **401.** Anahtar yanlış, süresi dolmuş veya kullanım hakkı tükenmiş.
-   **404 veya model bulunamadı.** `base_url` `/v1` ile bitmelidir. Model kimliğini kontrol edin. Ücretli modeller bakiye yüklemesi gerektirir; $5 kredi yalnızca `broadnet/gemma-4-26b-a4b` modelini kapsar.
-   **Boş çıktı veya doğrulama yeniden deneme döngüsü.** Çıktı bütçesini akıl yürütme tüketmiş. `max_tokens` değerini yükseltin. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **Araç tanımlarında 400.** Profilde `openai_supports_strict_tool_definition=False` ayarlayın ve BroadNet’in araçlarla listelediği bir model kullanın.
-   **Ajanları eşzamanlı çalıştırırken 429.** Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda işlemde 4 isteğe izin verir. [Hatalar ve yeniden denemeler](https://broadrouter.com/tr/guides/errors-and-retries/) rehberine bakın.

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

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

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

[Chat Completions API](https://broadrouter.com/tr/glossary/chat-completions-api/)

Chat Completions API, OpenAI'nin bir model adı ile rollerle etiketlenmiş mesaj listesini alıp modelin sonraki mesajını döndüren HTTP uç noktasıdır: POST /v1/chat/completions. İstek ve yanıt yapısı, OpenAI uyumlu sağlayıcıların ve SDK'ların yeniden kullandığı ortak format hâline geldi.

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

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

## Sık sorulan sorular

### BroadNet için OpenAIProvider mı yoksa OpenAICompatibleProvider mı kullanmalıyım?

OpenAICompatibleProvider. Pydantic AI belgelerine göre OpenAIProvider da base\_url alır, ancak OpenAI'nin kendisi ya da ona şeffaf bir proxy içindir ve OpenAI'nin modellerini ve özelliklerini varsayar.

### Neden varsayılan OpenAI modelini değil de OpenAIChatModel'i kullanmalıyım?

Pydantic AI'ın varsayılan OpenAI modeli Responses API'yi kullanır. BroadNet ise chat completions'ı /v1/chat/completions adresinde sunar; OpenAIChatModel de tam olarak bunu çağırır.

### Araçlar ve yapılandırılmış çıktı çalışır mı?

BroadNet'in araçlar ve yapılandırılmış çıktıyla listelediği GLM 5.3 ve Qwen3.8 27B modellerinde evet. BroadNet'in belgeleri DeepSeek V4.1 Flash için araçları listelemez; bu yüzden araç kullanan ajanları önce bu modelde test edin.

### Pydantic AI'ın max\_completion\_tokens göndermesini nasıl durdururum?

OpenAIChatModel'e profile=OpenAIModelProfile(openai\_chat\_supports\_max\_completion\_tokens=False) verin. Pydantic AI bu durumda BroadNet'in API referansının anlattığı eski max\_tokens alanını gönderir.

## İlgili rehberler

-   [OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/)
-   [LangChain'i BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/langchain-openai-base-url/)
-   [CrewAI'ı özel OpenAI uç noktası olarak BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/crewai-custom-openai-endpoint/)
-   [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 ile çalışan tüm araçlar (İngilizce)](https://broadrouter.com/integrations/): SDK'lar, kodlama ajanları, sohbet arayüzleri ve otomasyon araçları, her biri için tam ayarlarıyla

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-pydantic-ai-openai-compatible&utm_content=page-cta) ·

**Kaynaklar**

-   [Pydantic AI belgeleri, Other compatible APIs (Other endpoints, Model profile) (2026-11-15 tarihinde kontrol edildi)](https://pydantic.dev/docs/ai/models/compatible-apis/)
-   [Pydantic AI belgeleri, OpenAI modelleri (2026-11-15 tarihinde kontrol edildi)](https://pydantic.dev/docs/ai/models/openai/)
-   [PyPI, pydantic-ai 2.68.0, Python 3.11+ (2026-11-15 tarihinde kontrol edildi)](https://pypi.org/project/pydantic-ai/)
-   [BroadNet Inference API referansı (2026-11-15 tarihinde kontrol edildi) (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-pydantic-ai-openai-compatible&utm_content=sources)
