---
title: "Structured output là gì? JSON Schema khác JSON mode ra sao"
description: "Structured output buộc câu trả lời của LLM theo định dạng bạn đặt ra, thường là JSON Schema. Khác JSON mode thế nào, cách yêu cầu và những gì vẫn có thể hỏng."
url: https://broadrouter.com/vi/glossary/structured-output/
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/structured-output/) (cập nhật ngày 2026-11-15).

# Đầu ra có cấu trúc (structured output)

Cập nhật 2026-11-15

Đầu ra có cấu trúc (structured output) là tính năng của API LLM buộc câu trả lời của model theo định dạng do lập trình viên chỉ định, thường là JSON Schema, để code parse được tin cậy. Nó chặt hơn JSON mode, vốn chỉ đảm bảo JSON hợp lệ chứ không đảm bảo một cấu trúc cụ thể.

Còn gọi là: đầu ra có cấu trúc, đầu ra JSON theo schema, structured output, structured outputs, JSON schema output, response\_format

Code cần đầu vào dễ đoán. Structured output biến văn bản tự do của model thành dữ liệu mà chương trình của bạn có thể tin cậy.

## Cách hoạt động

Có ba mức kiểm soát:

| Cách làm | Kết quả nhận được |
| --- | --- |
| Yêu cầu trong prompt | Thường là JSON, đôi khi kèm văn bản thừa hoặc thiếu trường |
| JSON mode | JSON hợp lệ, cấu trúc bất kỳ |
| Structured output có schema | JSON khớp với schema của bạn |

Ở định dạng OpenAI, JSON mode là `response_format: {"type": "json_object"}`. Structured output thì truyền vào một schema:

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

Tài liệu tham chiếu của OpenAI cho biết kiểu `json_schema` “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). Nhiều nhà cung cấp làm điều này bằng constrained decoding (giải mã có ràng buộc): giới hạn những token mà model được phép sinh ở mỗi bước, để đầu ra vi phạm schema không thể được tạo ra.

## Vì sao quan trọng

-   **Ít lỗi parse hơn.** Pipeline trích xuất, bộ phân loại và agent có thể đọc trực tiếp các trường.
-   **Prompt đơn giản hơn.** Schema thay cho những chỉ dẫn định dạng dài dòng.
-   **Không phải đảm bảo tuyệt đối.** Hướng dẫn của OpenAI cho biết ứng dụng của bạn vẫn phải xử lý lời từ chối, phản hồi không đầy đủ và lỗi. Một câu trả lời bị cắt bởi [`max_tokens`](https://broadrouter.com/vi/glossary/max-tokens/) là JSON hỏng, bất kể schema nói gì.

Mức hỗ trợ khác nhau giữa các [API tương thích OpenAI](https://broadrouter.com/vi/glossary/openai-compatible-api/). Có nơi chỉ nhận `json_schema`, có nơi chỉ nhận `json_object`, và có nơi bỏ qua trường này. Hãy kiểm tra trước khi phụ thuộc vào nó.

## Trên BroadNet Inference

Tài liệu của BroadNet liệt kê 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/). Tài liệu không nêu tên tham số request, vì vậy hãy thử `response_format` trên model của bạn, và trong mọi trường hợp vẫn giữ một bộ parse JSON có xử lý lỗi. [Công cụ kiểm tra đầu ra JSON của LLM](https://broadrouter.com/tools/llm-json-output-validator/) cho thấy câu trả lời hỏng ở đâu và đối chiếu nó với schema của bạn. Cả hai model đều suy luận trước, nên hãy chừa đủ `max_tokens` cho cả phần suy nghĩ lẫn JSON.

Structured output kết hợp tốt với [model vision](https://broadrouter.com/vi/glossary/vision-language-model/). [Hướng dẫn đọc hóa đơn tiếng Ả Rập](https://broadrouter.com/vi/guides/read-arabic-invoices-with-vision/) gửi một hình ảnh và yêu cầu các trường dưới dạng JSON. Khi cần hành động thay vì câu trả lời, hãy dùng [tool calling](https://broadrouter.com/vi/glossary/tool-calling/).

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

-   Quên `additionalProperties: false`, hoặc không liệt kê mọi trường trong `required`, khi dùng strict mode.
-   Không kiểm tra `finish_reason` trước khi parse.

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

### JSON mode và structured output khác nhau thế nào?

JSON mode chỉ hứa câu trả lời parse được thành JSON. Structured output có schema còn hứa đúng các trường, kiểu dữ liệu và key bắt buộc mà bạn định nghĩa. Hướng dẫn của OpenAI cho biết chỉ Structured Outputs mới đảm bảo tuân thủ schema.

### Tôi có còn cần kiểm tra đầu ra không?

Có. Câu trả lời vẫn có thể là một lời từ chối hoặc bị cắt bởi max\_tokens, và schema không thể diễn đạt mọi quy tắc nghiệp vụ, ví dụ tổng tiền phải bằng tổng các dòng hàng.

### Nên dùng structured output hay tool calling?

Dùng structured output khi bạn muốn câu trả lời cuối cùng có hình dạng cố định. Dùng tool calling khi model cần nhờ code của bạn làm một việc rồi tiếp tục.

## Xem thêm

-   [Tool calling (gọi tool, function calling)](https://broadrouter.com/vi/glossary/tool-calling/) (thuật ngữ)
-   [max\_tokens (giới hạn token đầu ra)](https://broadrouter.com/vi/glossary/max-tokens/) (thuật ngữ)
-   [Vision-language model (VLM, mô hình thị giác-ngôn ngữ)](https://broadrouter.com/vi/glossary/vision-language-model/) (thuật ngữ)
-   [API tương thích OpenAI (OpenAI-compatible API)](https://broadrouter.com/vi/glossary/openai-compatible-api/) (thuật ngữ)
-   [JSON mode (chế độ JSON)](https://broadrouter.com/vi/glossary/json-mode/) (thuật ngữ)
-   [Guardrails (lớp bảo vệ cho LLM)](https://broadrouter.com/vi/glossary/guardrails/) (thuật ngữ)
-   [JSON Schema](https://broadrouter.com/vi/glossary/json-schema/) (thuật ngữ)
-   [Đọc hóa đơn và biên lai tiếng Ả Rập bằng model thị giác](https://broadrouter.com/vi/guides/read-arabic-invoices-with-vision/) (hướng dẫn)
-   [Dùng OpenAI Python SDK với BroadNet Inference](https://broadrouter.com/vi/guides/openai-python-sdk/) (hướng dẫn)
-   [Chọn API LLM cho tiếng Ả Rập: cần test những gì](https://broadrouter.com/vi/blog/choosing-an-llm-for-arabic/) (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-structured-output&utm_content=page-cta) ·

**Nguồn**

-   [OpenAI, hướng dẫn Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
-   [Tài liệu tham chiếu API OpenAI, tạo chat completion (response\_format)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Tài liệu tham chiếu API BroadNet Inference, model (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-glossary-structured-output&utm_content=sources#models)
