---
title: "JSON Schema nedir? LLM çıktısı için JSON şeması | BroadRouter"
description: "JSON Schema, JSON verisinin yapısını tanımlayan standarttır. LLM API'leri onu araç parametreleri ve yapılandırılmış çıktı için nasıl kullanır, hangileri desteklenir?"
url: https://broadrouter.com/tr/glossary/json-schema/
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/json-schema/) (güncelleme: 2026-11-15).

# JSON Schema (JSON şeması)

Güncellendi 2026-11-15

JSON Schema, JSON verisinin yapısını tanımlamak ve doğrulamak için JSON ile yazılan bir sözlüktür: türler, zorunlu alanlar, izin verilen değerler ve iç içe yapı. Güncel sürüm 2020-12'dir. LLM API'leri onu araç parametrelerini ve yapılandırılmış çıktının izlemesi gereken kesin yapıyı tanımlamak için kullanır.

Diğer adları: JSON şeması, JSON şema doğrulama, json\_schema, JSON Schema, JSON Schema draft 2020-12

“JSON ile yanıt ver” diyen bir istem, yapıyı şansa bırakır. JSON Schema ise yapıyı, bir makinenin kontrol edebileceği şekilde yazıya döker.

## Nasıl çalışır

Spesifikasyonun iki ana bölümü vardır: “defines the basic foundation of JSON Schema” (çeviri: JSON Schema’nın temel altyapısını tanımlar) olan Core ve “defines the validation keywords” (çeviri: doğrulama anahtar kelimelerini tanımlar) olan Validation. Güncel sürüm 2020-12’dir; bir önceki 2019-09’du.

```json
{
  "type": "object",
  "properties": {
    "name":    {"type": "string"},
    "amount":  {"type": "number", "minimum": 0},
    "currency": {"type": "string", "enum": ["SAR", "AED", "USD"]},
    "note":    {"type": ["string", "null"]}
  },
  "required": ["name", "amount", "currency", "note"],
  "additionalProperties": false
}
```

LLM API’leri şemaları iki yerde kullanır. Araç tanımları, argümanları tanımlamak için `parameters` alanına bir şema koyar. [Yapılandırılmış çıktı](https://broadrouter.com/tr/glossary/structured-output/) ise `response_format` içinde `{"type": "json_schema", "json_schema": {...}}` biçiminde bir şema gönderir; OpenAI bunun “ensures the model will match your supplied JSON schema” (çeviri: modelin sağladığınız JSON şemasına uymasını sağlar) olduğunu söyler.

OpenAI’nin strict modu yalnızca bir alt kümeyi kabul eder. Desteklenen şemalar bölümünden:

-   Türler: string, number, boolean, integer, object, array, enum ve anyOf.
-   Kök bir nesne olmalı ve `anyOf` kullanamaz.
-   `additionalProperties: false` olmalı ve her alan `required` içinde listelenmeli; bir alanı isteğe bağlı yapmak için yukarıdaki `note` gibi `null` değerine izin verin.
-   En fazla 5000 nesne özelliği ve 10 iç içe seviye, toplamda en fazla 1000 enum değeri.
-   Desteklenmeyenler: `allOf`, `not`, `dependentRequired`, `dependentSchemas`, `if`, `then`, `else`.

## Neden önemli

-   **Doğrulama.** Modele yol gösteren aynı şema, kodunuzda modelin yanıtını kontrol eder. Başarısız bir kontrol, modele geri gönderebileceğiniz kesin bir hata mesajı verir.
-   **Taşınabilirlik.** Strict alt kümeye göre yazılmış bir şema, her anahtar kelimeyi kullanan bir şemadan daha fazla sağlayıcıda çalışır.
-   **Token’lar.** Araç tanımlarındaki şemalar her istekte girdi olarak gönderilir. Uzun açıklamalar her turda token harcar.

## BroadNet Inference’ta

BroadNet’in [API referansı](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-glossary-json-schema&utm_content=body), [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 araç çağırmayı ve yapılandırılmış çıktıyı belgeler, ancak hangi şema anahtar kelimelerinin uygulandığını belgelemez. Şemaları yukarıdaki basit alt kümeyle sınırlı tutun ve her yanıtı doğrulayın. Şemayı [JSON Schema oluşturucuyla](https://broadrouter.com/tools/json-schema-generator/) hazırlayın, yanıtları [LLM JSON çıktı doğrulayıcısıyla](https://broadrouter.com/tools/llm-json-output-validator/) kontrol edin ve tam bir örnek için [yapılandırılmış çıktı yazısına](https://broadrouter.com/tr/blog/structured-output-json-schema/) bakın. Diğer modellerde istemde JSON isteyin ve yanıtı doğrulayın; [JSON modu](https://broadrouter.com/tr/glossary/json-mode/) BroadNet tarafından belgelenmemiştir, bu yüzden güvenmeden önce test edin.

## Sık yapılan hatalar

-   `allOf` veya koşullu anahtar kelimeler kullanıp sunucunun bunları uyguladığını varsaymak.
-   Strict modda alanları `null` değerine izin vermek yerine `required` dışında bırakarak isteğe bağlı yapmaya çalışmak.

## Sık sorulan sorular

### LLM API'leri JSON Schema'nın tamamını destekliyor mu?

Hayır. OpenAI bir alt kümeyi destekler: örneğin kök bir nesne olmalı, her alan zorunlu olmalı, additionalProperties false olmalı ve allOf, not ve if/then/else gibi anahtar kelimeler desteklenmez.

### JSON Schema ile JSON modu arasındaki fark nedir?

JSON modu yalnızca geçerli JSON vaat eder. JSON Schema ise modele ve doğrulayıcınıza o JSON'un hangi alanlara ve türlere sahip olması gerektiğini söyler.

### BroadNet Inference ile JSON Schema kullanabilir miyim?

İkisi de şema kullanan araç parametreleri ve yapılandırılmış çıktı, GLM 5.3 ve Qwen3.8 27B için belgelenmiştir. BroadNet hangi şema anahtar kelimelerini uyguladığını belgelemez; bu yüzden her yanıtı doğrulayın.

## Ayrıca bakın

-   [Yapılandırılmış çıktı (structured output)](https://broadrouter.com/tr/glossary/structured-output/) (terim)
-   [JSON modu (JSON mode)](https://broadrouter.com/tr/glossary/json-mode/) (terim)
-   [Araç çağırma (tool calling)](https://broadrouter.com/tr/glossary/tool-calling/) (terim)
-   [tool\_choice](https://broadrouter.com/tr/glossary/tool-choice/) (terim)
-   [MCP (Model Context Protocol)](https://broadrouter.com/tr/glossary/mcp/) (terim)
-   [Varlık ismi tanıma (named entity recognition, NER)](https://broadrouter.com/tr/glossary/named-entity-recognition/) (terim)
-   [JSON modu ve json\_schema: sağlam yapılandırılmış çıktı](https://broadrouter.com/tr/blog/structured-output-json-schema/) (yazı)
-   [LLM'den gelen geçersiz JSON: nedenler, onarım ve yeniden deneme](https://broadrouter.com/tr/blog/fix-invalid-json-from-llm/) (yazı)
-   [Fatura, fiş ve formlardan görsel LLM ile JSON veri çıkarma](https://broadrouter.com/tr/blog/extract-data-from-documents-with-vision-llm/) (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-json-schema&utm_content=page-cta) ·

**Kaynaklar**

-   [JSON Schema spesifikasyonu, sürüm 2020-12 (Core ve Validation) (2026-11-15 tarihinde kontrol edildi)](https://json-schema.org/specification)
-   [OpenAI, yapılandırılmış çıktı rehberi (desteklenen şemalar) (2026-11-15 tarihinde kontrol edildi)](https://developers.openai.com/api/docs/guides/structured-outputs)
-   [OpenAI API referansı, chat completion oluşturma (response\_format json\_schema) (2026-11-15 tarihinde kontrol edildi)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
