---
title: "Yapılandırılmış çıktı nedir? JSON Schema ve JSON modu"
description: "Yapılandırılmış çıktı, LLM yanıtını genellikle JSON Schema ile tanımladığınız bir biçime uydurur. JSON modundan farkı, nasıl istenir ve yine de neler ters gidebilir?"
url: https://broadrouter.com/tr/glossary/structured-output/
lang: tr
updated: 2026-11-15
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/glossary/structured-output/) (güncelleme: 2026-11-15).

# Yapılandırılmış çıktı (structured output)

Güncellendi 2026-11-15

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.

Diğer adları: yapılandırılmış çıktı, yapılandırılmış çıkış, JSON şeması çıktısı, JSON modu, structured output, structured outputs, JSON schema output, response\_format

Kod öngörülebilir girdiye ihtiyaç duyar. Yapılandırılmış çıktı, bir modelin serbest metnini programınızın güvenebileceği veriye dönüştürür.

## Nasıl çalışır

Üç kontrol düzeyi vardır:

| Yöntem | Ne elde edersiniz |
| --- | --- |
| İstemde rica etmek | Genellikle JSON; bazen fazladan metin veya eksik alanlarla |
| JSON modu | Geçerli JSON, herhangi bir yapıda |
| Şemalı yapılandırılmış çıktı | Şemanıza uyan JSON |

OpenAI biçiminde JSON modu `response_format: {"type": "json_object"}` şeklindedir. Yapılandırılmış çıktı ise bir şema verir:

```json
"response_format": {
  "type": "json_schema",
  "json_schema": {
    "name": "invoice",
    "strict": true,
    "schema": {
      "type": "object",
      "properties": {
        "vendor": { "type": "string" },
        "total": { "type": "number" }
      },
      "required": ["vendor", "total"],
      "additionalProperties": false
    }
  }
}
```

OpenAI’nin referansı, `json_schema` türünün “ensures the model will match your supplied JSON schema” (çeviri: modelin verdiğiniz JSON şemasına uymasını sağladığını) söyler. Birçok sağlayıcı bunu kısıtlı kod çözme (constrained decoding) ile yapar: modelin her adımda üretebileceği token’ları sınırlar, böylece şemayı bozan çıktı üretilemez.

## Neden önemli

-   **Daha az ayrıştırma hatası.** Bilgi çıkarma hatları, sınıflandırıcılar ve ajanlar alanları doğrudan okuyabilir.
-   **Daha basit istemler.** Şema, uzun biçim talimatlarının yerini alır.
-   **Tam bir garanti değil.** OpenAI’nin rehberi uygulamanızın retleri, eksik yanıtları ve hataları yine de ele alması gerektiğini söyler. [`max_tokens`](https://broadrouter.com/tr/glossary/max-tokens/) nedeniyle kesilmiş bir yanıt, şema ne derse desin bozuk JSON’dur.

Destek [OpenAI uyumlu API’ler](https://broadrouter.com/tr/glossary/openai-compatible-api/) arasında farklılık gösterir. Bazıları yalnızca `json_schema`, bazıları yalnızca `json_object` kabul eder, bazıları ise alanı yok sayar. Ona güvenmeden önce kontrol edin.

## BroadNet Inference’ta

BroadNet’in belgeleri [GLM 5.3](https://broadrouter.com/tr/models/glm-5.3/) ve [Qwen3.8 27B](https://broadrouter.com/tr/models/qwen3.8-27b/) için yapılandırılmış çıktıyı listeler. Belgeler istek parametresinin adını vermez; bu yüzden `response_format` alanını modelinizde test edin ve her durumda hata yönetimi olan bir JSON ayrıştırıcısı kullanın. [LLM JSON çıktı doğrulayıcısı](https://broadrouter.com/tools/llm-json-output-validator/) yanıtın nerede bozulduğunu gösterir ve onu şemanıza göre kontrol eder. İki model de önce akıl yürütür; bu yüzden `max_tokens` değerinde düşünme artı JSON için pay bırakın.

Yapılandırılmış çıktı [görsel modelleriyle](https://broadrouter.com/tr/glossary/vision-language-model/) iyi bir ikili oluşturur. [Arapça fatura rehberi](https://broadrouter.com/tr/guides/read-arabic-invoices-with-vision/) bir görsel gönderir ve alanları JSON olarak ister. Yanıt yerine eylem istiyorsanız [araç çağırmayı](https://broadrouter.com/tr/glossary/tool-calling/) kullanın.

## Sık yapılan hatalar

-   Strict modu kullanırken `additionalProperties: false` eklemeyi ya da her alanı `required` içinde listelemeyi unutmak.
-   Ayrıştırmadan önce `finish_reason` değerini kontrol etmemek.

## Sık sorulan sorular

### JSON modu ile yapılandırılmış çıktı arasındaki fark nedir?

JSON modu yalnızca yanıtın JSON olarak ayrıştırılabileceğini taahhüt eder. Şemalı yapılandırılmış çıktı ise tanımladığınız alanları, türleri ve zorunlu anahtarları da taahhüt eder. OpenAI'nin rehberine göre şemaya uyumu yalnızca Structured Outputs sağlar.

### Çıktıyı yine de doğrulamam gerekir mi?

Evet. Yanıt yine bir ret olabilir veya max\_tokens nedeniyle kesilebilir; ayrıca bir şema, kalem tutarlarının toplamına eşit olması gereken bir toplam gibi her iş kuralını ifade edemez.

### Yapılandırılmış çıktı mı, araç çağırma mı kullanmalıyım?

Nihai yanıtı sabit bir yapıda istiyorsanız yapılandırılmış çıktı kullanın. Modelin kodunuzdan bir şey yapmasını isteyip ardından devam etmesi gerekiyorsa araç çağırma (tool calling) kullanın.

## Ayrıca bakın

-   [Araç çağırma (tool calling)](https://broadrouter.com/tr/glossary/tool-calling/) (terim)
-   [max\_tokens](https://broadrouter.com/tr/glossary/max-tokens/) (terim)
-   [Görsel-dil modeli (VLM)](https://broadrouter.com/tr/glossary/vision-language-model/) (terim)
-   [OpenAI uyumlu API](https://broadrouter.com/tr/glossary/openai-compatible-api/) (terim)
-   [JSON modu (JSON mode)](https://broadrouter.com/tr/glossary/json-mode/) (terim)
-   [Guardrails (koruma bariyerleri)](https://broadrouter.com/tr/glossary/guardrails/) (terim)
-   [JSON Schema (JSON şeması)](https://broadrouter.com/tr/glossary/json-schema/) (terim)
-   [Arapça faturaları ve fişleri bir görü modeliyle okuyun](https://broadrouter.com/tr/guides/read-arabic-invoices-with-vision/) (rehber)
-   [OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/) (rehber)
-   [Arapça için LLM API seçimi: neler test edilmeli?](https://broadrouter.com/tr/blog/choosing-an-llm-for-arabic/) (yazı)

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-glossary-structured-output&utm_content=page-cta) ·

**Kaynaklar**

-   [OpenAI, Structured Outputs rehberi](https://developers.openai.com/api/docs/guides/structured-outputs)
-   [OpenAI API referansı, chat completion oluşturma (response\_format)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [BroadNet Inference API referansı, modeller (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-glossary-structured-output&utm_content=sources#models)
