---
title: "Apa itu JSON mode? Beda json_object dan json_schema | BroadRouter"
description: "JSON mode membuat balasan LLM bisa di-parse sebagai JSON valid, tetapi tanpa skema. Cara kerja response_format json_object dan kapan memakai structured outputs."
url: https://broadrouter.com/id/glossary/json-mode/
lang: id
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan dari bahasa Inggris dengan bantuan AI. [Baca versi asli bahasa Inggris](https://broadrouter.com/glossary/json-mode/) (diperbarui 2026-11-14).

# JSON mode (mode JSON)

Diperbarui 2026-11-14

JSON mode adalah pengaturan API LLM, yaitu response\_format {"type": "json\_object"} di API bergaya OpenAI, yang membuat balasan model berupa JSON yang valid dan bisa di-parse. Berbeda dengan structured outputs yang memakai JSON Schema, mode ini tidak menjamin key, tipe, atau nilai apa yang ada di objek.

Disebut juga: mode JSON, output JSON, json\_object, JSON mode, JSON output mode, JSON response mode

JSON mode menjawab satu pertanyaan: apakah `json.loads()` akan berhasil? Ia tidak menjawab pertanyaan kedua: apakah ini objek yang diharapkan kode saya?

## Cara kerjanya

Di Chat Completions API, Anda mengaktifkannya dengan satu field:

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

Referensi API OpenAI menyebutnya “the older JSON mode, which ensures the message the model generates is valid JSON.” (terjemahan: JSON mode versi lama, yang memastikan pesan yang dihasilkan model adalah JSON valid.) Ada dua aturan yang menyertainya. Anda harus meminta JSON di sebuah pesan: panduan OpenAI menyebutkan API “will throw an error if the string ‘JSON’ does not appear somewhere in the context.” (terjemahan: akan memunculkan error jika string ‘JSON’ tidak muncul di mana pun dalam konteks.) Dan bentuknya diserahkan pada model. Panduan itu menyatakan JSON mode “will not guarantee the output matches any specific schema.” (terjemahan: tidak menjamin output cocok dengan skema tertentu.)

[Output terstruktur](https://broadrouter.com/id/glossary/structured-output/) adalah opsi yang lebih ketat. Opsi ini mengirim JSON Schema dengan `{"type": "json_schema", ...}`, dan model dibatasi mengikutinya.

|  | JSON mode (`json_object`) | Structured outputs (`json_schema`) |
| --- | --- | --- |
| JSON valid | ya | ya |
| Key dan tipe wajib | tidak | ya |
| Anda menyediakan skema | tidak | ya |
| Wajib menyebut “JSON” di prompt | ya (OpenAI) | tidak |

OpenAI merekomendasikan “always using Structured Outputs instead of JSON mode when possible.” (terjemahan: selalu memakai Structured Outputs alih-alih JSON mode bila memungkinkan.)

## Kenapa ini penting

-   **Validasi tetap tugas Anda.** Dengan JSON mode, key yang hilang atau angka yang dikirim sebagai string tetap lolos parsing lalu gagal belakangan. Validasi terhadap skema di kode.
-   **Pemotongan.** Jika balasan mencapai [`max_tokens`](https://broadrouter.com/id/glossary/max-tokens/), JSON-nya tidak lengkap. Model penalaran lebih rentan, karena proses berpikir memakai anggaran yang sama.
-   **Cadangan.** Panduan OpenAI mencantumkan JSON mode pada model lama yang belum mendukung `json_schema`. Dukungan berbeda per penyedia dan model, jadi JSON mode plus validasi Anda sendiri menjadi cadangan saat skema tidak diterima.

## Di BroadNet Inference

[Referensi API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-glossary-json-mode&utm_content=body#models) BroadNet mencantumkan output terstruktur untuk GLM 5.3 dan Qwen3.8 27B. Referensi itu tidak menyebutkan apakah `response_format` yang didukung adalah `json_object` atau `json_schema`, atau apakah DeepSeek V4.1 Flash dan BroadNet Gemma 4 VL 26B menerima salah satunya. Uji keduanya di model Anda. Untuk menulis skema, gunakan [generator JSON Schema](https://broadrouter.com/tools/json-schema-generator/). Artikel [JSON mode vs json\_schema](https://broadrouter.com/id/blog/structured-output-json-schema/) membahas perbaikan dan pemantauan, dan [panduan faktur](https://broadrouter.com/id/guides/read-arabic-invoices-with-vision/) menunjukkan ekstraksi JSON dari gambar.

## Pertanyaan umum

### Apakah JSON mode sama dengan structured outputs?

Tidak. Panduan OpenAI menyebutkan keduanya menghasilkan JSON valid, tetapi hanya Structured Outputs yang menjamin kepatuhan pada skema. JSON mode bisa mengembalikan objek valid apa pun.

### Kenapa JSON mode memberi error soal kata JSON?

OpenAI mewajibkan instruksi untuk menghasilkan JSON di salah satu pesan dan mengembalikan error jika string "JSON" tidak muncul di konteks.

### Apakah JSON mode masih bisa mengembalikan JSON rusak?

Bisa, jika balasan terpotong oleh max\_tokens atau batas konteks. Periksa finish\_reason sebelum mem-parse.

## Lihat juga

-   [Output terstruktur (structured output)](https://broadrouter.com/id/glossary/structured-output/) (istilah)
-   [Tool calling (function calling)](https://broadrouter.com/id/glossary/tool-calling/) (istilah)
-   [max\_tokens](https://broadrouter.com/id/glossary/max-tokens/) (istilah)
-   [System prompt (prompt sistem)](https://broadrouter.com/id/glossary/system-prompt/) (istilah)
-   [API kompatibel OpenAI](https://broadrouter.com/id/glossary/openai-compatible-api/) (istilah)
-   [JSON Schema (skema JSON)](https://broadrouter.com/id/glossary/json-schema/) (istilah)
-   [Membaca faktur dan struk berbahasa Arab dengan model vision](https://broadrouter.com/id/guides/read-arabic-invoices-with-vision/) (panduan)
-   [Memakai OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/id/guides/openai-python-sdk/) (panduan)
-   [JSON mode vs json\_schema: output terstruktur yang andal](https://broadrouter.com/id/blog/structured-output-json-schema/) (artikel)
-   [Ekstrak data faktur, struk, dan formulir ke JSON dengan vision LLM](https://broadrouter.com/id/blog/extract-data-from-documents-with-vision-llm/) (artikel)
-   [Cara memperbaiki JSON tidak valid dari LLM: penyebab, perbaikan, retry](https://broadrouter.com/id/blog/fix-invalid-json-from-llm/) (artikel)

Coba dengan beban kerja Anda yang sebenarnya. Akun baru mendapat kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM, dan Qwen3.8 memerlukan top up.

[Mulai](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-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)
-   [Referensi API OpenAI, membuat chat completion (response\_format)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Referensi API BroadNet Inference, ID model (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-glossary-json-mode&utm_content=sources#models)
