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_tokenssı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_schemadesteğ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.