---
title: "Apakah itu mod JSON? json_object vs json_schema | BroadRouter"
description: "Mod JSON memastikan jawapan LLM ialah JSON yang sah tetapi tidak menguatkuasakan skema. Cara response_format json_object berfungsi dan bila guna structured outputs."
url: https://broadrouter.com/ms/glossary/json-mode/
lang: ms
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/glossary/json-mode/) (dikemas kini 2026-11-14).

# Mod JSON (JSON mode)

Dikemas kini 2026-11-14

Mod JSON ialah tetapan API LLM, response\_format {"type": "json\_object"} dalam API gaya OpenAI, yang menjadikan jawapan model JSON yang sah dan boleh dihurai. Tidak seperti structured outputs dengan JSON Schema, ia tidak menjamin kunci, jenis atau nilai yang terkandung dalam objek itu.

Juga dikenali sebagai: mod JSON, output JSON LLM, JSON mode, json\_object, JSON output mode, JSON response mode

Mod JSON menjawab satu soalan: adakah `json.loads()` akan berjaya? Ia tidak menjawab soalan kedua: adakah ini objek yang dijangka oleh kod saya?

## Cara ia berfungsi

Dalam Chat Completions API, anda menghidupkannya dengan satu medan:

```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"}]}
```

Rujukan API OpenAI memanggilnya “the older JSON mode, which ensures the message the model generates is valid JSON.” (Terjemahan BroadRouter: “mod JSON yang lebih lama, yang memastikan mesej yang dijana model ialah JSON yang sah.”) Dua peraturan datang bersamanya. Anda mesti meminta JSON dalam mesej: panduan OpenAI menyatakan API itu “will throw an error if the string ‘JSON’ does not appear somewhere in the context.” (Terjemahan BroadRouter: “akan memulangkan ralat jika rentetan ‘JSON’ tidak muncul di mana-mana dalam konteks.”) Dan bentuknya terserah kepada model. Panduan itu menyatakan mod JSON “will not guarantee the output matches any specific schema.” (Terjemahan BroadRouter: “tidak akan menjamin output sepadan dengan mana-mana skema tertentu.”)

[Output berstruktur](https://broadrouter.com/ms/glossary/structured-output/) ialah pilihan yang lebih ketat. Ia menghantar JSON Schema dengan `{"type": "json_schema", ...}`, dan model dikekang kepadanya.

|  | Mod JSON (`json_object`) | Structured outputs (`json_schema`) |
| --- | --- | --- |
| JSON yang sah | ya | ya |
| Kunci dan jenis wajib | tidak | ya |
| Anda membekalkan skema | tidak | ya |
| Mesti menyebut “JSON” dalam prompt | ya (OpenAI) | tidak |

OpenAI mengesyorkan “always using Structured Outputs instead of JSON mode when possible.” (Terjemahan BroadRouter: “sentiasa menggunakan Structured Outputs dan bukannya mod JSON apabila boleh.”)

## Mengapa ia penting

-   **Pengesahan masih tanggungjawab anda.** Dengan mod JSON, kunci yang hilang atau nombor yang dihantar sebagai rentetan masih boleh dihurai dan hanya gagal kemudian. Sahkan terhadap skema dalam kod.
-   **Pemotongan.** Jika jawapan mencapai [`max_tokens`](https://broadrouter.com/ms/glossary/max-tokens/), JSON itu tidak lengkap. Model penaakulan lebih terdedah, kerana pemikiran menggunakan bajet yang sama.
-   **Sandaran.** Panduan OpenAI menyenaraikan mod JSON pada model lama yang tidak mempunyai `json_schema`. Sokongan berbeza mengikut penyedia dan model, jadi mod JSON bersama pengesahan anda sendiri ialah sandaran apabila skema tidak diterima.

## Di BroadNet Inference

[Rujukan API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-json-mode&utm_content=body#models) BroadNet menyenaraikan output berstruktur untuk GLM 5.3 dan Qwen3.8 27B. Ia tidak menyatakan sama ada `json_object` atau `json_schema` ialah `response_format` yang disokong, atau sama ada DeepSeek V4.1 Flash dan BroadNet Gemma 4 VL 26B menerima salah satunya. Uji kedua-duanya pada model anda. Untuk menulis skema, gunakan [penjana JSON Schema](https://broadrouter.com/tools/json-schema-generator/). Artikel [JSON mode vs json\_schema](https://broadrouter.com/ms/blog/structured-output-json-schema/) merangkumi pembaikan dan pemantauan, dan [panduan invois](https://broadrouter.com/ms/guides/read-arabic-invoices-with-vision/) menunjukkan pengekstrakan JSON daripada imej.

## Soalan lazim

### Adakah mod JSON sama dengan structured outputs?

Tidak. Panduan OpenAI menyatakan kedua-duanya menghasilkan JSON yang sah, tetapi hanya Structured Outputs memastikan skema dipatuhi. Mod JSON boleh memulangkan apa-apa objek yang sah.

### Mengapa mod JSON memulangkan ralat tentang perkataan JSON?

OpenAI mewajibkan arahan untuk menghasilkan JSON di mana-mana dalam mesej, dan memulangkan ralat jika rentetan "JSON" tidak muncul dalam konteks.

### Bolehkah mod JSON masih memulangkan JSON yang rosak?

Ya, jika jawapan terpotong oleh max\_tokens atau had konteks. Semak finish\_reason sebelum menghurai.

## Lihat juga

-   [Output berstruktur (structured output)](https://broadrouter.com/ms/glossary/structured-output/) (istilah)
-   [Tool calling (panggilan alatan)](https://broadrouter.com/ms/glossary/tool-calling/) (istilah)
-   [max\_tokens](https://broadrouter.com/ms/glossary/max-tokens/) (istilah)
-   [Prompt sistem (system prompt)](https://broadrouter.com/ms/glossary/system-prompt/) (istilah)
-   [API serasi OpenAI (OpenAI-compatible API)](https://broadrouter.com/ms/glossary/openai-compatible-api/) (istilah)
-   [JSON Schema (skema JSON)](https://broadrouter.com/ms/glossary/json-schema/) (istilah)
-   [Baca invois dan resit Arab dengan model vision](https://broadrouter.com/ms/guides/read-arabic-invoices-with-vision/) (panduan)
-   [Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/) (panduan)
-   [JSON mode vs json\_schema: output berstruktur yang boleh diharap](https://broadrouter.com/ms/blog/structured-output-json-schema/) (artikel)
-   [Ekstrak data invois, resit dan borang ke JSON dengan LLM visi](https://broadrouter.com/ms/blog/extract-data-from-documents-with-vision-llm/) (artikel)
-   [Cara membaiki JSON tidak sah daripada LLM: punca, baiki, cuba semula](https://broadrouter.com/ms/blog/fix-invalid-json-from-llm/) (artikel)

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

[Mulakan](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-json-mode&utm_content=page-cta) ·

**Sumber**

-   [OpenAI, panduan Structured Outputs (JSON mode vs Structured Outputs)](https://developers.openai.com/api/docs/guides/structured-outputs)
-   [Rujukan API OpenAI, create chat completion (response\_format)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Rujukan API BroadNet Inference, ID model (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-json-mode&utm_content=sources#models)
