---
title: "Output berstruktur dalam API LLM: JSON Schema vs JSON mode"
description: "Output berstruktur menjadikan balasan LLM sepadan dengan format anda, biasanya JSON Schema. Bezanya dengan JSON mode, cara memintanya, dan perkara yang boleh gagal."
url: https://broadrouter.com/ms/glossary/structured-output/
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/structured-output/) (dikemas kini 2026-11-15).

# Output berstruktur (structured output)

Dikemas kini 2026-11-15

Output berstruktur ialah ciri API LLM yang mengehadkan balasan model kepada format yang ditetapkan oleh pembangun, biasanya JSON Schema, supaya kod boleh menghuraikannya dengan boleh dipercayai. Ia lebih ketat daripada JSON mode, yang menjamin JSON yang sah tetapi bukan bentuk tertentu.

Juga dikenali sebagai: output berstruktur, output JSON, structured output, structured outputs, JSON schema output, response\_format

Kod memerlukan input yang boleh diramal. Output berstruktur menukar teks bebas model kepada data yang boleh dipercayai oleh program anda.

## Cara ia berfungsi

Terdapat tiga tahap kawalan:

| Kaedah | Apa yang anda dapat |
| --- | --- |
| Minta dalam prompt | Biasanya JSON, kadangkala dengan teks tambahan atau medan yang hilang |
| JSON mode | JSON yang sah, apa-apa bentuk |
| Output berstruktur dengan skema | JSON yang sepadan dengan skema anda |

Dalam format OpenAI, JSON mode ialah `response_format: {"type": "json_object"}`. Output berstruktur menghantar skema:

```json
"response_format": {
  "type": "json_schema",
  "json_schema": {
    "name": "invoice",
    "strict": true,
    "schema": {
      "type": "object",
      "properties": {
        "vendor": { "type": "string" },
        "total": { "type": "number" }
      },
      "required": ["vendor", "total"],
      "additionalProperties": false
    }
  }
}
```

Rujukan OpenAI menyatakan jenis `json_schema` “ensures the model will match your supplied JSON schema.” (Terjemahan BroadRouter: “memastikan model akan sepadan dengan JSON schema yang anda berikan.”) Banyak penyedia melakukannya dengan penyahkodan terkekang (constrained decoding): mengehadkan token yang boleh dihasilkan model pada setiap langkah, supaya output yang melanggar skema tidak dapat dijana.

## Mengapa ia penting

-   **Kurang ralat penghuraian.** Saluran paip pengekstrakan, pengelas dan ejen boleh membaca medan secara terus.
-   **Prompt lebih ringkas.** Skema menggantikan arahan format yang panjang.
-   **Bukan jaminan penuh.** Panduan OpenAI menyatakan aplikasi anda masih perlu mengendalikan penolakan, respons tidak lengkap dan ralat. Balasan yang terpotong oleh [`max_tokens`](https://broadrouter.com/ms/glossary/max-tokens/) ialah JSON yang rosak, walau apa pun kata skema.

Sokongan berbeza merentas [API serasi OpenAI](https://broadrouter.com/ms/glossary/openai-compatible-api/). Sesetengahnya hanya menerima `json_schema`, sesetengahnya hanya `json_object`, dan sesetengahnya mengabaikan medan itu. Semak sebelum anda bergantung padanya.

## Di BroadNet Inference

Dokumentasi BroadNet menyenaraikan 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/). Dokumentasi itu tidak menamakan parameter permintaan, jadi uji `response_format` pada model anda, dan kekalkan penghurai JSON dengan pengendalian ralat walau apa pun hasilnya. [Pengesah output JSON LLM](https://broadrouter.com/tools/llm-json-output-validator/) menunjukkan di mana balasan rosak dan menyemaknya berbanding skema anda. Kedua-dua model membuat penaakulan dahulu, jadi beri ruang dalam `max_tokens` untuk berfikir serta JSON.

Output berstruktur sesuai digandingkan dengan [model penglihatan](https://broadrouter.com/ms/glossary/vision-language-model/). [Panduan invois bahasa Arab](https://broadrouter.com/ms/guides/read-arabic-invoices-with-vision/) menghantar imej dan meminta medan sebagai JSON. Untuk tindakan dan bukan jawapan, gunakan [tool calling](https://broadrouter.com/ms/glossary/tool-calling/).

## Kesilapan biasa

-   Terlupa `additionalProperties: false`, atau tidak menyenaraikan setiap medan dalam `required`, apabila menggunakan strict mode.
-   Tidak menyemak `finish_reason` sebelum menghurai.

## Soalan lazim

### Apakah perbezaan antara JSON mode dan output berstruktur?

JSON mode hanya menjanjikan balasan boleh dihurai sebagai JSON. Output berstruktur dengan skema juga menjanjikan medan, jenis dan kunci wajib yang anda tetapkan. Panduan OpenAI menyatakan hanya Structured Outputs yang memastikan pematuhan skema.

### Adakah saya masih perlu mengesahkan output?

Ya. Balasan masih boleh menjadi penolakan atau terpotong oleh max\_tokens, dan skema tidak dapat menyatakan setiap peraturan perniagaan, seperti jumlah yang mesti sama dengan hasil tambah item baris.

### Patutkah saya menggunakan output berstruktur atau tool calling?

Gunakan output berstruktur apabila anda mahu jawapan akhir dalam bentuk tetap. Gunakan tool calling apabila model perlu meminta kod anda melakukan sesuatu dan kemudian meneruskan.

## Lihat juga

-   [Tool calling (panggilan alatan)](https://broadrouter.com/ms/glossary/tool-calling/) (istilah)
-   [max\_tokens](https://broadrouter.com/ms/glossary/max-tokens/) (istilah)
-   [Model bahasa-penglihatan (vision-language model)](https://broadrouter.com/ms/glossary/vision-language-model/) (istilah)
-   [API serasi OpenAI (OpenAI-compatible API)](https://broadrouter.com/ms/glossary/openai-compatible-api/) (istilah)
-   [Mod JSON (JSON mode)](https://broadrouter.com/ms/glossary/json-mode/) (istilah)
-   [Guardrails (pagar keselamatan LLM)](https://broadrouter.com/ms/glossary/guardrails/) (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)
-   [Memilih API LLM untuk bahasa Arab: apa yang perlu diuji](https://broadrouter.com/ms/blog/choosing-an-llm-for-arabic/) (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-structured-output&utm_content=page-cta) ·

**Sumber**

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