---
title: "Apa itu JSON Schema? Skema JSON untuk output LLM | BroadRouter"
description: "JSON Schema adalah standar untuk mendeskripsikan bentuk data JSON. Cara API LLM memakainya untuk parameter tool dan output terstruktur, serta keyword yang didukung."
url: https://broadrouter.com/id/glossary/json-schema/
lang: id
updated: 2026-11-15
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-schema/) (diperbarui 2026-11-15).

# JSON Schema (skema JSON)

Diperbarui 2026-11-15

JSON Schema adalah kosakata yang ditulis dalam JSON untuk mendeskripsikan dan memvalidasi struktur data JSON: tipe, field wajib, nilai yang diizinkan, dan susunan bertingkat. Versi terbarunya 2020-12. API LLM memakainya untuk mendefinisikan parameter tool dan bentuk persis yang harus diikuti output terstruktur.

Disebut juga: skema JSON, validasi JSON Schema, json\_schema, JSON Schema draft 2020-12

Prompt yang berbunyi “balas dalam JSON” menyerahkan bentuknya pada kebetulan. JSON Schema menuliskan bentuk itu agar bisa diperiksa mesin.

## Cara kerjanya

Spesifikasinya punya dua bagian utama: Core, yang “defines the basic foundation of JSON Schema” (terjemahan: mendefinisikan fondasi dasar JSON Schema), dan Validation, yang “defines the validation keywords” (terjemahan: mendefinisikan keyword validasi). Versi terbarunya 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 memakai skema di dua tempat. Definisi tool menaruh satu skema di `parameters` untuk mendeskripsikan argumen. [Output terstruktur](https://broadrouter.com/id/glossary/structured-output/) mengirim satu skema di `response_format` sebagai `{"type": "json_schema", "json_schema": {...}}`, yang menurut OpenAI “ensures the model will match your supplied JSON schema” (terjemahan: memastikan model akan cocok dengan JSON schema yang Anda berikan).

Mode strict OpenAI hanya menerima sebagian. Dari bagian skema yang didukung:

-   Tipe: string, number, boolean, integer, object, array, enum, dan anyOf.
-   Root harus berupa objek dan tidak boleh memakai `anyOf`.
-   `additionalProperties: false` dan setiap field tercantum di `required`; buat field menjadi opsional dengan mengizinkan `null`, seperti `note` di atas.
-   Hingga 5000 properti objek dan 10 tingkat nesting, serta total hingga 1000 nilai enum.
-   Tidak didukung: `allOf`, `not`, `dependentRequired`, `dependentSchemas`, `if`, `then`, `else`.

## Kenapa ini penting

-   **Validasi.** Skema yang sama yang memandu model juga memeriksa balasannya di kode Anda. Pemeriksaan yang gagal memberi error yang persis untuk dikirim balik.
-   **Portabilitas.** Skema yang ditulis dengan subset strict bekerja di lebih banyak penyedia daripada skema yang memakai semua keyword.
-   **Token.** Skema dalam definisi tool dikirim sebagai input di setiap permintaan. Deskripsi panjang memakan token di setiap giliran.

## Di BroadNet Inference

[Referensi API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-glossary-json-schema&utm_content=body) BroadNet mendokumentasikan tool calling dan output terstruktur untuk [GLM 5.3](https://broadrouter.com/id/models/glm-5.3/) dan [Qwen3.8 27B](https://broadrouter.com/id/models/qwen3.8-27b/), tetapi tidak menyebut keyword skema mana yang ditegakkan. Batasi skema pada subset sederhana di atas dan validasi setiap balasan. Buat skema dengan [generator JSON Schema](https://broadrouter.com/tools/json-schema-generator/), periksa balasan dengan [validator output JSON LLM](https://broadrouter.com/tools/llm-json-output-validator/), dan lihat [artikel output terstruktur](https://broadrouter.com/id/blog/structured-output-json-schema/) untuk contoh lengkap. Di model lain, minta JSON di prompt dan validasi balasannya; [JSON mode](https://broadrouter.com/id/glossary/json-mode/) tidak didokumentasikan oleh BroadNet, jadi uji sebelum mengandalkannya.

## Kesalahan umum

-   Memakai `allOf` atau keyword kondisional dan mengira server menegakkannya.
-   Membuat field opsional dengan mengeluarkannya dari `required` di mode strict, alih-alih mengizinkan `null`.

## Pertanyaan umum

### Apakah API LLM mendukung seluruh JSON Schema?

Tidak. OpenAI mendukung sebagian saja: misalnya root harus berupa objek, setiap field harus wajib, additionalProperties harus false, dan keyword seperti allOf, not, dan if/then/else tidak didukung.

### Apa bedanya JSON Schema dan JSON mode?

JSON mode hanya menjanjikan JSON yang valid. JSON Schema memberi tahu model, dan validator Anda, field dan tipe apa yang harus dimiliki JSON itu.

### Bisakah saya memakai JSON Schema dengan BroadNet Inference?

Parameter tool dan output terstruktur, yang sama-sama memakai skema, didokumentasikan untuk GLM 5.3 dan Qwen3.8 27B. BroadNet tidak mendokumentasikan keyword skema mana yang ditegakkan, jadi validasi setiap balasan.

## Lihat juga

-   [Output terstruktur (structured output)](https://broadrouter.com/id/glossary/structured-output/) (istilah)
-   [JSON mode (mode JSON)](https://broadrouter.com/id/glossary/json-mode/) (istilah)
-   [Tool calling (function calling)](https://broadrouter.com/id/glossary/tool-calling/) (istilah)
-   [tool\_choice](https://broadrouter.com/id/glossary/tool-choice/) (istilah)
-   [MCP (Model Context Protocol)](https://broadrouter.com/id/glossary/mcp/) (istilah)
-   [Named entity recognition (NER, pengenalan entitas bernama)](https://broadrouter.com/id/glossary/named-entity-recognition/) (istilah)
-   [JSON mode vs json\_schema: output terstruktur yang andal](https://broadrouter.com/id/blog/structured-output-json-schema/) (artikel)
-   [Cara memperbaiki JSON tidak valid dari LLM: penyebab, perbaikan, retry](https://broadrouter.com/id/blog/fix-invalid-json-from-llm/) (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)

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

**Sumber**

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