---
title: "JSON Schema là gì? Mô tả cấu trúc JSON cho đầu ra LLM"
description: "JSON Schema là chuẩn mô tả cấu trúc dữ liệu JSON. Cách các API LLM dùng nó cho tham số tool và structured output, và những keyword nào được hỗ trợ."
url: https://broadrouter.com/vi/glossary/json-schema/
lang: vi
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Được dịch từ tiếng Anh với sự hỗ trợ của AI. [Đọc bản gốc tiếng Anh](https://broadrouter.com/glossary/json-schema/) (cập nhật ngày 2026-11-15).

# JSON Schema

Cập nhật 2026-11-15

JSON Schema là một bộ từ vựng viết bằng JSON để mô tả và kiểm tra cấu trúc dữ liệu JSON: kiểu, trường bắt buộc, giá trị cho phép và cách lồng nhau. Phiên bản hiện tại là 2020-12. Các API LLM dùng nó để định nghĩa tham số tool và cấu trúc chính xác mà structured output phải theo.

Còn gọi là: JSON Schema là gì, lược đồ JSON, schema JSON, kiểm tra JSON Schema, json\_schema, JSON Schema draft 2020-12

Một prompt nói “trả lời bằng JSON” để cấu trúc cho may rủi. JSON Schema viết cấu trúc đó ra để máy có thể kiểm tra.

## Cách hoạt động

Đặc tả có hai phần chính: Core, phần “defines the basic foundation of JSON Schema” (Bản dịch: định nghĩa nền tảng cơ bản của JSON Schema), và Validation, phần “defines the validation keywords” (Bản dịch: định nghĩa các keyword kiểm tra). Phiên bản hiện tại là 2020-12; phiên bản trước là 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
}
```

Các API LLM dùng schema ở hai chỗ. Định nghĩa tool đặt một schema trong `parameters` để mô tả đối số. [Structured output](https://broadrouter.com/vi/glossary/structured-output/) gửi một schema trong `response_format` dưới dạng `{"type": "json_schema", "json_schema": {...}}`, mà OpenAI nói là “ensures the model will match your supplied JSON schema” (Bản dịch: đảm bảo model sẽ khớp với JSON schema bạn cung cấp).

Chế độ strict của OpenAI chỉ chấp nhận một tập con. Theo phần schema được hỗ trợ:

-   Kiểu: string, number, boolean, integer, object, array, enum và anyOf.
-   Gốc phải là object và không được dùng `anyOf`.
-   `additionalProperties: false` và mọi trường đều có trong `required`; muốn một trường là tùy chọn thì cho phép `null`, như `note` ở trên.
-   Tối đa 5000 thuộc tính object và 10 cấp lồng nhau, tổng cộng tối đa 1000 giá trị enum.
-   Không hỗ trợ: `allOf`, `not`, `dependentRequired`, `dependentSchemas`, `if`, `then`, `else`.

## Vì sao quan trọng

-   **Kiểm tra.** Chính schema dùng để dẫn dắt model cũng kiểm tra câu trả lời của nó trong code. Một lần kiểm tra thất bại cho ra lỗi chính xác để gửi ngược lại.
-   **Tính di động.** Một schema viết theo tập con strict chạy được ở nhiều nhà cung cấp hơn schema dùng mọi keyword.
-   **Token.** Schema trong định nghĩa tool được gửi làm đầu vào ở mọi request. Mô tả dài tốn token ở mỗi lượt.

## Trên BroadNet Inference

[Tài liệu tham chiếu API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-glossary-json-schema&utm_content=body) của BroadNet ghi tool calling và structured output cho [GLM 5.3](https://broadrouter.com/vi/models/glm-5.3/) và [Qwen3.8 27B](https://broadrouter.com/vi/models/qwen3.8-27b/), nhưng không ghi keyword schema nào được áp dụng. Hãy giữ schema trong tập con đơn giản ở trên và kiểm tra mọi câu trả lời. Tạo schema bằng [công cụ tạo JSON Schema](https://broadrouter.com/tools/json-schema-generator/), kiểm tra câu trả lời bằng [công cụ kiểm tra đầu ra JSON của LLM](https://broadrouter.com/tools/llm-json-output-validator/), và xem [bài viết về structured output](https://broadrouter.com/vi/blog/structured-output-json-schema/) để có ví dụ đầy đủ. Với các model khác, yêu cầu JSON trong prompt và kiểm tra câu trả lời; [JSON mode](https://broadrouter.com/vi/glossary/json-mode/) không được BroadNet ghi trong tài liệu, nên hãy thử trước khi dựa vào nó.

## Lỗi thường gặp

-   Dùng `allOf` hoặc keyword điều kiện rồi mặc định server sẽ áp dụng chúng.
-   Ở chế độ strict, làm trường thành tùy chọn bằng cách bỏ nó khỏi `required`, thay vì cho phép `null`.

## Câu hỏi thường gặp

### API LLM có hỗ trợ toàn bộ JSON Schema không?

Không. OpenAI hỗ trợ một tập con: ví dụ, gốc phải là object, mọi trường phải nằm trong required, additionalProperties phải là false, và các keyword như allOf, not và if/then/else không được hỗ trợ.

### JSON Schema khác JSON mode thế nào?

JSON mode chỉ hứa JSON hợp lệ. JSON Schema cho model, và bộ kiểm tra của bạn, biết JSON đó phải có những trường và kiểu nào.

### Tôi có dùng được JSON Schema với BroadNet Inference không?

Tham số tool và structured output, cả hai đều dùng schema, được ghi trong tài liệu cho GLM 5.3 và Qwen3.8 27B. BroadNet không ghi keyword schema nào được áp dụng, nên hãy kiểm tra mọi câu trả lời.

## Xem thêm

-   [Đầu ra có cấu trúc (structured output)](https://broadrouter.com/vi/glossary/structured-output/) (thuật ngữ)
-   [JSON mode (chế độ JSON)](https://broadrouter.com/vi/glossary/json-mode/) (thuật ngữ)
-   [Tool calling (gọi tool, function calling)](https://broadrouter.com/vi/glossary/tool-calling/) (thuật ngữ)
-   [tool\_choice (tham số chọn tool)](https://broadrouter.com/vi/glossary/tool-choice/) (thuật ngữ)
-   [MCP (Model Context Protocol)](https://broadrouter.com/vi/glossary/mcp/) (thuật ngữ)
-   [Nhận dạng thực thể có tên (NER)](https://broadrouter.com/vi/glossary/named-entity-recognition/) (thuật ngữ)
-   [JSON mode và json\_schema: đầu ra có cấu trúc đáng tin cậy](https://broadrouter.com/vi/blog/structured-output-json-schema/) (bài viết)
-   [Sửa JSON không hợp lệ từ LLM: nguyên nhân, sửa lỗi, thử lại](https://broadrouter.com/vi/blog/fix-invalid-json-from-llm/) (bài viết)
-   [Trích xuất hóa đơn, biên lai, biểu mẫu sang JSON bằng LLM vision](https://broadrouter.com/vi/blog/extract-data-from-documents-with-vision-llm/) (bài viết)

Hãy thử với khối lượng công việc thực tế của bạn. Tài khoản mới được tặng US$5 tín dụng ban đầu cho Gemma và chuyển giọng nói thành văn bản. DeepSeek, GLM và Qwen3.8 cần nạp tiền.

[Bắt đầu](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-glossary-json-schema&utm_content=page-cta) ·

**Nguồn**

-   [Đặc tả JSON Schema, phiên bản 2020-12 (Core và Validation) (kiểm tra ngày 2026-11-15)](https://json-schema.org/specification)
-   [OpenAI, hướng dẫn structured outputs (schema được hỗ trợ) (kiểm tra ngày 2026-11-15)](https://developers.openai.com/api/docs/guides/structured-outputs)
-   [Tài liệu tham chiếu API OpenAI, tạo chat completion (response\_format json\_schema) (kiểm tra ngày 2026-11-15)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
