BroadRouter
Başlayın

JSON modu (JSON mode)

Güncellendi

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:

{"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ı 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 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ı, 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 kullanın. JSON modu ve json_schema yazısı onarım ve izlemeyi anlatır, fatura rehberi 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.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor