---
title: "Instructor ile OpenAI uyumlu base_url (Pydantic) | BroadRouter"
description: "Instructor ile BroadNet Inference'tan Pydantic nesneleri çıkarın: özel base_url ile from_openai veya from_provider kullanın ve doğru Mode'u seçin."
url: https://broadrouter.com/tr/guides/instructor-structured-output/
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/instructor-structured-output/) (güncelleme: 2026-11-16).

# BroadNet Inference üzerinde Instructor ile yapılandırılmış çıktı alın

Güncellendi 2026-11-16

base\_url değeri https://inference.broadnet.ai/v1 olan ve BroadNet anahtarınızı taşıyan bir OpenAI istemcisini instructor.from\_openai ile sarın, ardından chat.completions.create'i response\_model olarak Pydantic sınıfınızla ve model olarak broadnet/glm-5.3 veya broadnet/qwen3.8-27b ile çağırın. BroadNet'in araçlar ve yapılandırılmış çıktıyla listelediği iki model bunlardır. Varsayılan Mode.TOOLS'tur; Mode.JSON\_SCHEMA da çalışır.

Instructor, LLM yanıtlarını doğrulanmış Pydantic nesnelerine dönüştüren ve doğrulama başarısız olduğunda yeniden deneyebilen bir Python kütüphanesidir. OpenAI istemcisini yamalar ve belgeleri OpenAI uyumlu sunucuları `base_url` üzerinden ele alır. BroadNet Inference chat completions isteklerini `https://inference.broadnet.ai/v1` adresinde sunar ve araçlarla yapılandırılmış çıktıyı GLM 5.3 ve Qwen3.8 27B için listeler. BroadRouter, BroadNet’in kendi sitesidir; bu rehber Instructor’ın 1.17.0 sürümü itibarıyla belgelerini izler.

## Kurulum

```bash
pip install instructor
export BROADNET_API_KEY='your-broadnet-key'
```

## Bir nesne çıkarın

```python
import os
import instructor
from openai import OpenAI
from pydantic import BaseModel

class Invoice(BaseModel):
    vendor: str
    total: float
    currency: str

client = instructor.from_openai(
    OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"]),
    mode=instructor.Mode.TOOLS,
)

invoice = client.chat.completions.create(
    model="broadnet/glm-5.3",
    response_model=Invoice,
    max_tokens=4000,
    messages=[{"role": "user", "content": "Acme Trading invoice, total 1,250.00 SAR"}],
)
print(invoice)
```

Instructor `Invoice` sınıfını bir araç şemasına dönüştürür, `tool_choice` ile modeli bu aracı çağırmaya zorlar ve argümanları doğrular. Nesne doğrulanmadığında doğrulama hatasıyla kaç kez yeniden soracağını `max_retries` ile belirleyin.

## Ya da from\_provider kullanın

```python
pclient = instructor.from_provider(
    "openai/broadnet/glm-5.3",
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
invoice = pclient.create(response_model=Invoice, max_tokens=4000,
                         messages=[{"role": "user", "content": "Acme Trading, 1,250.00 SAR"}])
```

`openai/` kısmı istemciyi seçer. Geri kalanı, yani `broadnet/glm-5.3`, model kimliği olarak gönderilir.

## Hangi mod

| Mod | Ne gönderir | BroadNet ile kullanım |
| --- | --- | --- |
| `Mode.TOOLS` (varsayılan) | Şemanızla zorunlu bir araç çağrısı | Evet, GLM 5.3 veya Qwen3.8 27B üzerinde |
| `Mode.JSON_SCHEMA` | `json_schema` türünde `response_format` | Evet, GLM 5.3 veya Qwen3.8 27B üzerinde |
| `Mode.MD_JSON` | Düz bir istek; JSON metinden ayrıştırılır | Diğer modeller için yedek yol; önce test edin |
| `Mode.RESPONSES_TOOLS` | Responses API | Hayır: BroadNet chat completions sunar |

## Görseller

Qwen3.8 27B araçların yanında görsel de kabul eder; bu yüzden bir fotoğrafı veya taramayı doğrudan modelinize okuyabilir:

```python
import base64
img = base64.b64encode(open("invoice.jpg", "rb").read()).decode()
invoice = client.chat.completions.create(
    model="broadnet/qwen3.8-27b",
    response_model=Invoice,
    max_tokens=4000,
    messages=[{"role": "user", "content": [
        {"type": "text", "text": "Extract the invoice fields."},
        {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64," + img}},
    ]}],
)
```

Kullandıkça öde anahtarında bir görsel girdi token’ı olarak sayılır. [Arapça faturaları görüntü işlemeyle okuma](https://broadrouter.com/tr/guides/read-arabic-invoices-with-vision/) rehberine bakın.

## Bunu nasıl test ettik

2026-11-15’te instructor 1.17.0’ı openai 3.3.0 ile temiz bir sanal ortama kurduk ve yukarıdaki örnekleri BroadNet’in chat completions yapısını konuşan yerel bir mock sunucuya karşı çalıştırdık. Kaydedilen istekleri okuduk. `Mode.TOOLS` şemayı zorunlu bir `tool_choice` ile araç olarak gönderdi, `Mode.JSON_SCHEMA` ise `json_schema` türünde bir yanıt biçimi gönderdi; ikisi de geçerli bir `Invoice` döndürdü. `from_provider` model kimliğini değiştirmeden gönderdi. Mock sunucumuz serbest metin JSON yazmadığı için `Mode.MD_JSON`’u test etmedik; görsel örneğini de göndermedik. Elimizde bir BroadNet anahtarı yoktu; bu yüzden gerçek model çıktısını test etmedik.

## Sorun giderme

-   **Hiç başarılı olmayan doğrulama denemeleri.** GLM 5.3 ve Qwen3.8 27B’de akıl yürütme `max_tokens` sınırına dahildir. Düşük bir sınır araç argümanlarını yarıda kesebilir. Değeri artırın. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **İstekte 400.** GLM 5.3 veya Qwen3.8 27B kullandığınızı kontrol edin. Zorunlu `tool_choice` reddedilirse `Mode.JSON_SCHEMA`’yı deneyin.
-   **401.** Anahtar yanlış, süresi dolmuş veya kullanım hakkı tükenmiş.
-   **404.** `base_url` `/v1` ile bitmelidir. GLM 5.3 ve Qwen3.8 27B bakiye yüklemesi gerektirir; $5 kredi bunları kapsamaz.
-   **Toplu veri çıkarmada 429.** Kullandıkça öde anahtarı dakikada 30 isteğe ve işlemde aynı anda 4 isteğe izin verir. Her doğrulama denemesi ayrı bir istektir. [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.

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

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

[Araç çağırma (tool calling)](https://broadrouter.com/tr/glossary/tool-calling/)

Araç çağırma (tool calling), fonksiyon çağırma (function calling) olarak da bilinir; modelin, geliştiricinin tanımladığı bir fonksiyonu çalıştırmak için JSON argümanlı yapılandırılmış bir istek döndürdüğü bir LLM API özelliğidir. Fonksiyonu uygulama çalıştırır ve sonucu geri gönderir; model hiçbir zaman kodu kendisi çalıştırmaz.

[Girdi ve çıktı token'ları](https://broadrouter.com/tr/glossary/input-and-output-tokens/)

Girdi token'ları, bir dil modelinin istekte okuduğu token'lardır: sistem istemi, konuşma geçmişi, araç tanımları ve görseller dahil. Çıktı token'ları ise modelin yanıt olarak ürettikleridir, akıl yürütme dahil. LLM API'leri bunları genellikle ayrı fiyatlandırır ve çıktı genellikle daha pahalıdır.

[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 ile hangi Instructor modunu kullanmalıyım?

Varsayılan mod olan Mode.TOOLS'u, BroadNet'in araçlar ve yapılandırılmış çıktıyla listelediği GLM 5.3 veya Qwen3.8 27B üzerinde kullanın. Mode.JSON\_SCHEMA bunun yerine json\_schema türünde bir response\_format gönderir. Mock sunucu testimizde ikisi de geçerli nesneler üretti.

### Mode.RESPONSES\_TOOLS kullanabilir miyim?

Hayır. Instructor'ın belgeleri, sunucu Responses API'yi uygulamıyorsa bu modu seçmemenizi söyler. BroadNet yalnızca chat completions sunar.

### Instructor, BroadNet'te DeepSeek V4.1 Flash veya Gemma ile çalışır mı?

BroadNet bu modeller için araçları veya yapılandırılmış çıktıyı listelemez. Mode.MD\_JSON düz metin içinde JSON ister ve onu ayrıştırır; bu işe yarayabilir, ancak güvenmeden önce kendi verilerinizle test edin.

### from\_provider için model dizesini nasıl yazmalıyım?

openai/broadnet/glm-5.3 kullanın. Instructor ilk bölümü sağlayıcı olarak ayırır; testimizde sunucuya broadnet/glm-5.3 değerini değiştirmeden gönderdi.

## İlgili rehberler

-   [OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/)
-   [Pydantic AI ve BroadNet Inference (OpenAICompatibleProvider)](https://broadrouter.com/tr/guides/pydantic-ai-openai-compatible/)
-   [Arapça faturaları ve fişleri bir görü modeliyle okuyun](https://broadrouter.com/tr/guides/read-arabic-invoices-with-vision/)
-   [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-instructor-structured-output&utm_content=page-cta) ·

**Kaynaklar**

-   [Instructor belgeleri, OpenAI ve OpenAI uyumlu sunucular (2026-11-15 tarihinde kontrol edildi)](https://python.useinstructor.com/integrations/openai/)
-   [PyPI, instructor 1.17.0 (2026-11-15 tarihinde kontrol edildi)](https://pypi.org/project/instructor/)
-   [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-instructor-structured-output&utm_content=sources)
