---
title: "JSON modu nedir? json_object ve json_schema farkı | BroadRouter"
description: "JSON modu, LLM yanıtının geçerli JSON olarak ayrışmasını sağlar ama şema dayatmaz. response_format json_object nasıl çalışır, ne zaman structured outputs seçilir?"
url: https://broadrouter.com/tr/glossary/json-mode/
lang: tr
updated: 2026-11-14
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-mode/) (güncelleme: 2026-11-14).

# JSON modu (JSON mode)

Güncellendi 2026-11-14

JSON modu, OpenAI tarzı API'lerde response\_format {"type": "json\_object"} ile açılan ve modelin yanıtını geçerli, ayrıştırılabilir JSON yapan bir LLM API ayarıdır. JSON Schema kullanan yapılandırılmış çıktıların aksine, nesnenin hangi anahtarları, türleri veya değerleri içereceğini garanti etmez.

Diğer adları: JSON modu, JSON çıktı modu, json\_object, JSON mode, JSON output mode, JSON response mode

JSON modu tek bir soruyu yanıtlar: `json.loads()` başarılı olacak mı? İkinci soruyu yanıtlamaz: bu, kodumun beklediği nesne mi?

## Nasıl çalışır

Chat Completions API’sinde tek bir alanla açılır:

```json
{"response_format": {"type": "json_object"},
 "messages": [
   {"role": "system", "content": "Return JSON with keys name and email."},
   {"role": "user", "content": "Reach me at Sara, sara@example.com"}]}
```

OpenAI’nin API referansı bunu “the older JSON mode, which ensures the message the model generates is valid JSON” (çeviri: modelin ürettiği mesajın geçerli JSON olmasını sağlayan eski JSON modu) olarak tanımlar. Beraberinde iki kural gelir. Birincisi, bir mesajda JSON istemeniz gerekir: OpenAI’nin rehberine göre API “will throw an error if the string ‘JSON’ does not appear somewhere in the context” (çeviri: bağlamın bir yerinde ‘JSON’ metni geçmiyorsa hata verir). İkincisi, yapıyı model belirler. Rehber, JSON modunun “will not guarantee the output matches any specific schema” (çeviri: çıktının belirli bir şemaya uyduğunu garanti etmeyeceğini) belirtir.

[Yapılandırılmış çıktı](https://broadrouter.com/tr/glossary/structured-output/) daha katı seçenektir. `{"type": "json_schema", ...}` ile bir JSON Schema gönderir ve model bu şemayla sınırlanır.

|  | JSON modu (`json_object`) | Structured outputs (`json_schema`) |
| --- | --- | --- |
| Geçerli JSON | evet | evet |
| Zorunlu anahtarlar ve türler | hayır | evet |
| Şemayı siz sağlarsınız | hayır | evet |
| İstemde “JSON” geçmeli | evet (OpenAI) | hayır |

OpenAI, “always using Structured Outputs instead of JSON mode when possible” (çeviri: mümkün olduğunda JSON modu yerine her zaman Structured Outputs kullanılmasını) önerir.

## Neden önemli

-   **Doğrulama yine sizin işiniz.** JSON modunda eksik bir anahtar veya metin olarak gönderilmiş bir sayı sorunsuz ayrıştırılır ve sonra hataya yol açar. Kodda bir şemaya göre doğrulayın.
-   **Kesilme.** Yanıt [`max_tokens`](https://broadrouter.com/tr/glossary/max-tokens/) sınırına ulaşırsa JSON eksik kalır. Akıl yürütme modelleri daha açıktır, çünkü düşünme aynı bütçeyi kullanır.
-   **Yedek çözüm.** OpenAI’nin rehberi, `json_schema` desteği olmayan eski modellerde JSON modunu listeler. Destek sağlayıcıya ve modele göre değişir; bu yüzden bir şema kabul edilmediğinde yedek çözüm, JSON modu artı kendi doğrulamanızdır.

## BroadNet Inference’ta

BroadNet’in [API referansı](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-glossary-json-mode&utm_content=body#models), GLM 5.3 ve Qwen3.8 27B için yapılandırılmış çıktıyı listeler. Desteklenen `response_format` değerinin `json_object` mi yoksa `json_schema` mı olduğunu, DeepSeek V4.1 Flash ve BroadNet Gemma 4 VL 26B’nin bunlardan birini kabul edip etmediğini belirtmez. Modelinizde ikisini de test edin. Şemayı yazmak için [JSON Schema oluşturucuyu](https://broadrouter.com/tools/json-schema-generator/) kullanın. [JSON modu ve json\_schema](https://broadrouter.com/tr/blog/structured-output-json-schema/) yazısı onarım ve izlemeyi anlatır, [fatura rehberi](https://broadrouter.com/tr/guides/read-arabic-invoices-with-vision/) ise görsellerden JSON çıkarmayı gösterir.

## Sık sorulan sorular

### JSON modu ile structured outputs aynı şey mi?

Hayır. OpenAI'nin rehberine göre ikisi de geçerli JSON üretir, ancak şemaya uyumu yalnızca Structured Outputs sağlar. JSON modu herhangi bir geçerli nesne döndürebilir.

### JSON modu neden JSON kelimesiyle ilgili hata veriyor?

OpenAI, mesajların bir yerinde JSON üretme talimatı ister ve bağlamda "JSON" metni geçmiyorsa hata döndürür.

### JSON modu yine de bozuk JSON döndürebilir mi?

Evet, yanıt max\_tokens veya bağlam sınırı nedeniyle kesilirse. Ayrıştırmadan önce finish\_reason değerini kontrol edin.

## Ayrıca bakın

-   [Yapılandırılmış çıktı (structured output)](https://broadrouter.com/tr/glossary/structured-output/) (terim)
-   [Araç çağırma (tool calling)](https://broadrouter.com/tr/glossary/tool-calling/) (terim)
-   [max\_tokens](https://broadrouter.com/tr/glossary/max-tokens/) (terim)
-   [Sistem istemi (system prompt)](https://broadrouter.com/tr/glossary/system-prompt/) (terim)
-   [OpenAI uyumlu API](https://broadrouter.com/tr/glossary/openai-compatible-api/) (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)
-   [JSON modu ve json\_schema: sağlam yapılandırılmış çıktı](https://broadrouter.com/tr/blog/structured-output-json-schema/) (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ı)
-   [LLM'den gelen geçersiz JSON: nedenler, onarım ve yeniden deneme](https://broadrouter.com/tr/blog/fix-invalid-json-from-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-mode&utm_content=page-cta) ·

**Kaynaklar**

-   [OpenAI, Structured Outputs rehberi (JSON modu ve Structured Outputs)](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ı, model kimlikleri (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-glossary-json-mode&utm_content=sources#models)
