---
title: "Apakah itu JSON Schema? Menerangkan JSON untuk output LLM"
description: "JSON Schema ialah piawaian untuk menerangkan bentuk data JSON. Cara API LLM menggunakannya untuk parameter alat dan output berstruktur, dan kata kunci yang disokong."
url: https://broadrouter.com/ms/glossary/json-schema/
lang: ms
updated: 2026-11-15
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-schema/) (dikemas kini 2026-11-15).

# JSON Schema (skema JSON)

Dikemas kini 2026-11-15

JSON Schema ialah perbendaharaan kata, ditulis dalam JSON, untuk menerangkan dan mengesahkan struktur data JSON: jenis, medan wajib, nilai yang dibenarkan dan penyarangan. Versi semasa ialah 2020-12. API LLM menggunakannya untuk mentakrifkan parameter alat dan bentuk tepat yang mesti diikuti oleh output berstruktur.

Juga dikenali sebagai: skema JSON, JSON Schema LLM, json\_schema, JSON Schema draft 2020-12

Prompt yang berkata “jawab dalam JSON” membiarkan bentuknya kepada nasib. JSON Schema menuliskan bentuk itu supaya mesin boleh menyemaknya.

## Cara ia berfungsi

Spesifikasinya ada dua bahagian utama: Core, yang “defines the basic foundation of JSON Schema” (Terjemahan BroadRouter: “mentakrifkan asas JSON Schema”), dan Validation, yang “defines the validation keywords” (Terjemahan BroadRouter: “mentakrifkan kata kunci pengesahan”). Versi semasa ialah 2020-12; versi sebelumnya 2019-09.

```json
{
  "type": "object",
  "properties": {
    "name":    {"type": "string"},
    "amount":  {"type": "number", "minimum": 0},
    "currency": {"type": "string", "enum": ["SAR", "AED", "USD"]},
    "note":    {"type": ["string", "null"]}
  },
  "required": ["name", "amount", "currency", "note"],
  "additionalProperties": false
}
```

API LLM menggunakan skema di dua tempat. Definisi alat meletakkan satu skema dalam `parameters` untuk menerangkan argumen. [Output berstruktur](https://broadrouter.com/ms/glossary/structured-output/) menghantar satu skema dalam `response_format` sebagai `{"type": "json_schema", "json_schema": {...}}`, yang menurut OpenAI “ensures the model will match your supplied JSON schema” (Terjemahan BroadRouter: “memastikan model akan sepadan dengan JSON schema yang anda bekalkan”).

Mod ketat OpenAI hanya menerima subset. Daripada bahagian skema yang disokong:

-   Jenis: string, number, boolean, integer, object, array, enum dan anyOf.
-   Akar mesti objek dan tidak boleh menggunakan `anyOf`.
-   `additionalProperties: false` dan setiap medan disenaraikan dalam `required`; jadikan medan pilihan dengan membenarkan `null`, seperti `note` di atas.
-   Sehingga 5000 sifat objek dan 10 aras penyarangan, dan sehingga 1000 nilai enum secara keseluruhan.
-   Tidak disokong: `allOf`, `not`, `dependentRequired`, `dependentSchemas`, `if`, `then`, `else`.

## Mengapa ia penting

-   **Pengesahan.** Skema yang sama yang membimbing model menyemak jawapannya dalam kod anda. Semakan yang gagal memberi ralat tepat untuk dihantar semula.
-   **Kebolehalihan.** Skema yang ditulis mengikut subset ketat berfungsi merentas lebih banyak penyedia berbanding skema yang menggunakan setiap kata kunci.
-   **Token.** Skema dalam definisi alat dihantar sebagai input pada setiap permintaan. Penerangan yang panjang memakan token setiap giliran.

## Di BroadNet Inference

[Rujukan API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-json-schema&utm_content=body) BroadNet mendokumenkan tool calling dan output berstruktur untuk [GLM 5.3](https://broadrouter.com/ms/models/glm-5.3/) dan [Qwen3.8 27B](https://broadrouter.com/ms/models/qwen3.8-27b/), tetapi tidak menyatakan kata kunci skema yang dikuatkuasakan. Hadkan skema kepada subset ringkas di atas dan sahkan setiap jawapan. Bina skema dengan [penjana JSON Schema](https://broadrouter.com/tools/json-schema-generator/), semak jawapan dengan [pengesah output JSON LLM](https://broadrouter.com/tools/llm-json-output-validator/), dan lihat [artikel output berstruktur](https://broadrouter.com/ms/blog/structured-output-json-schema/) untuk contoh penuh. Pada model lain, minta JSON dalam prompt dan sahkan jawapannya; [mod JSON](https://broadrouter.com/ms/glossary/json-mode/) tidak didokumenkan oleh BroadNet, jadi uji sebelum bergantung padanya.

## Kesilapan biasa

-   Menggunakan `allOf` atau kata kunci bersyarat dan menganggap pelayan menguatkuasakannya.
-   Menjadikan medan pilihan dalam mod ketat dengan mengeluarkannya daripada `required`, bukannya membenarkan `null`.

## Soalan lazim

### Adakah API LLM menyokong keseluruhan JSON Schema?

Tidak. OpenAI menyokong subset sahaja: contohnya, akar mesti objek, setiap medan mesti wajib, additionalProperties mesti false, dan kata kunci seperti allOf, not dan if/then/else tidak disokong.

### Apakah perbezaan antara JSON Schema dan mod JSON?

Mod JSON hanya menjanjikan JSON yang sah. JSON Schema memberitahu model, dan pengesah anda, medan dan jenis yang mesti ada dalam JSON itu.

### Bolehkah saya menggunakan JSON Schema dengan BroadNet Inference?

Parameter alat dan output berstruktur, yang kedua-duanya menggunakan skema, didokumenkan untuk GLM 5.3 dan Qwen3.8 27B. BroadNet tidak mendokumenkan kata kunci skema yang dikuatkuasakannya, jadi sahkan setiap jawapan.

## Lihat juga

-   [Output berstruktur (structured output)](https://broadrouter.com/ms/glossary/structured-output/) (istilah)
-   [Mod JSON (JSON mode)](https://broadrouter.com/ms/glossary/json-mode/) (istilah)
-   [Tool calling (panggilan alatan)](https://broadrouter.com/ms/glossary/tool-calling/) (istilah)
-   [tool\_choice](https://broadrouter.com/ms/glossary/tool-choice/) (istilah)
-   [MCP (Model Context Protocol)](https://broadrouter.com/ms/glossary/mcp/) (istilah)
-   [Pengecaman entiti bernama (NER)](https://broadrouter.com/ms/glossary/named-entity-recognition/) (istilah)
-   [JSON mode vs json\_schema: output berstruktur yang boleh diharap](https://broadrouter.com/ms/blog/structured-output-json-schema/) (artikel)
-   [Cara membaiki JSON tidak sah daripada LLM: punca, baiki, cuba semula](https://broadrouter.com/ms/blog/fix-invalid-json-from-llm/) (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)

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-schema&utm_content=page-cta) ·

**Sumber**

-   [Spesifikasi JSON Schema, versi 2020-12 (Core dan Validation) (disemak 2026-11-15)](https://json-schema.org/specification)
-   [OpenAI, panduan structured outputs (skema yang disokong) (disemak 2026-11-15)](https://developers.openai.com/api/docs/guides/structured-outputs)
-   [Rujukan API OpenAI, create chat completion (response\_format json\_schema) (disemak 2026-11-15)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
