---
title: "什么是结构化输出？JSON Schema 与 JSON mode 的区别 | BroadRouter"
description: "结构化输出让大模型的回复符合你定义的格式，通常是 JSON Schema。它和 JSON mode 有什么区别、怎么请求，以及哪些地方仍可能出错。"
url: https://broadrouter.com/zh/glossary/structured-output/
lang: zh-Hans
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。 [阅读英文原文](https://broadrouter.com/glossary/structured-output/) (2026-11-15 更新).

# 结构化输出（structured output）

更新于 2026-11-15

结构化输出是大模型 API 的一项功能，它把模型的回复约束为开发者指定的格式（通常是 JSON Schema），让代码能可靠地解析。它比 JSON mode 更严格：JSON mode 只保证输出是合法 JSON，不保证特定结构。

又称： 结构化输出、JSON Schema 输出、JSON 结构化输出、Structured Outputs、structured output、JSON schema output、response\_format

代码需要可预测的输入。结构化输出把模型的自由文本变成程序可以信赖的数据。

## 原理

控制程度分三级：

| 方法 | 你得到的结果 |
| --- | --- |
| 在提示词里要求 | 通常是 JSON，有时夹带多余文字或缺少字段 |
| JSON mode | 合法的 JSON，结构不限 |
| 带 Schema 的结构化输出 | 符合你的 Schema 的 JSON |

在 OpenAI 格式中，JSON mode 是 `response_format: {"type": "json_object"}`。结构化输出则传入一个 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
    }
  }
}
```

OpenAI 的参考文档说，`json_schema` 类型 “ensures the model will match your supplied JSON schema”（译文：确保模型输出符合你提供的 JSON Schema）。许多服务商通过约束解码实现这一点：在每一步限制模型可以生成哪些 token，使违反 Schema 的输出根本无法生成。

## 为什么重要

-   **更少的解析错误。** 信息抽取流水线、分类器和智能体可以直接读取字段。
-   **更简单的提示词。** Schema 取代了冗长的格式说明。
-   **并非完全保证。** OpenAI 的指南说，你的应用仍应处理拒答、不完整的响应和错误。被 [`max_tokens`](https://broadrouter.com/zh/glossary/max-tokens/) 截断的回复，无论 Schema 怎么写，都是残缺的 JSON。

各家 [OpenAI 兼容 API](https://broadrouter.com/zh/glossary/openai-compatible-api/) 的支持程度不一。有的只接受 `json_schema`，有的只接受 `json_object`，有的会忽略这个字段。依赖它之前请先确认。

## 在 BroadNet Inference 上

BroadNet 的文档为 [GLM 5.3](https://broadrouter.com/zh/models/glm-5.3/) 和 [Qwen3.8 27B](https://broadrouter.com/zh/models/qwen3.8-27b/) 列出了结构化输出。文档没有写明请求参数的名称，所以请在你的模型上测试 `response_format`，并且无论如何都保留一个带错误处理的 JSON 解析器。[LLM JSON 输出校验工具](https://broadrouter.com/tools/llm-json-output-validator/)可以指出回复在哪里出错，并按你的 Schema 进行检查。这两个模型都会先思考，所以 `max_tokens` 要给思考和 JSON 都留出空间。

结构化输出和[视觉模型](https://broadrouter.com/zh/glossary/vision-language-model/)很搭。[阿拉伯语发票指南](https://broadrouter.com/zh/guides/read-arabic-invoices-with-vision/)发送一张图片，要求以 JSON 返回各字段。如果要的是执行操作而不是回答，请使用[工具调用](https://broadrouter.com/zh/glossary/tool-calling/)。

## 常见错误

-   使用 strict 模式时，忘了设置 `additionalProperties: false`，或者没有把每个字段都列进 `required`。
-   解析前没有检查 `finish_reason`。

## 常见问题

### JSON mode 和结构化输出有什么区别？

JSON mode 只保证回复能被解析为 JSON。带 Schema 的结构化输出还保证你定义的字段、类型和必填键。OpenAI 的指南说，只有 Structured Outputs 能确保遵循 Schema。

### 用了结构化输出还需要校验吗？

需要。回复仍可能是拒答，或被 max\_tokens 截断；Schema 也无法表达所有业务规则，比如总额必须等于各明细行之和。

### 该用结构化输出还是工具调用？

想让最终回答采用固定格式时，用结构化输出。想让模型请求你的代码执行某个操作、然后继续时，用工具调用。

## 另请参阅

-   [工具调用（tool calling / function calling）](https://broadrouter.com/zh/glossary/tool-calling/) (术语)
-   [max\_tokens（最大输出 token 数）](https://broadrouter.com/zh/glossary/max-tokens/) (术语)
-   [视觉语言模型（VLM，vision-language model）](https://broadrouter.com/zh/glossary/vision-language-model/) (术语)
-   [OpenAI 兼容 API（OpenAI-compatible API）](https://broadrouter.com/zh/glossary/openai-compatible-api/) (术语)
-   [JSON 模式（JSON mode）](https://broadrouter.com/zh/glossary/json-mode/) (术语)
-   [护栏（guardrails）](https://broadrouter.com/zh/glossary/guardrails/) (术语)
-   [JSON Schema](https://broadrouter.com/zh/glossary/json-schema/) (术语)
-   [用视觉模型识别阿拉伯语发票和收据](https://broadrouter.com/zh/guides/read-arabic-invoices-with-vision/) (指南)
-   [用 OpenAI Python SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-python-sdk/) (指南)
-   [如何选择阿拉伯语大模型 API：该测试什么](https://broadrouter.com/zh/blog/choosing-an-llm-for-arabic/) (文章)

用你的真实业务负载试一试。 新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-glossary-structured-output&utm_content=page-cta) ·

**来源**

-   [OpenAI：Structured Outputs 指南](https://developers.openai.com/api/docs/guides/structured-outputs)
-   [OpenAI API 参考：创建对话补全（response\_format）](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [BroadNet Inference API 参考：模型 （英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-glossary-structured-output&utm_content=sources#models)
