---
title: "什么是 JSON 模式？json_object 与 json_schema 的区别 | BroadRouter"
description: "JSON 模式让大模型的回复能被解析为合法 JSON，但不强制任何 schema。response_format json_object 如何工作，以及何时应改用结构化输出。"
url: https://broadrouter.com/zh/glossary/json-mode/
lang: zh-Hans
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# JSON 模式（JSON mode）

更新于 2026-11-14

JSON 模式（JSON mode）是大模型 API 的一项设置，在 OpenAI 风格的 API 中写作 response\_format {"type": "json\_object"}，它让模型的回复成为合法、可解析的 JSON。与使用 JSON Schema 的结构化输出不同，它不保证对象里有哪些键、类型或取值。

又称： JSON 输出模式、json\_object 模式、强制 JSON 输出、json\_object、JSON output mode、JSON response mode

JSON 模式只回答一个问题：`json.loads()` 会不会成功？它不回答第二个问题：这是不是我的代码期望的那个对象？

## 工作原理

在 Chat Completions API 中，一个字段就能打开它：

```json
{"response_format": {"type": "json_object"},
 "messages": [
   {"role": "system", "content": "Return JSON with keys name and email."},
   {"role": "user", "content": "Reach me at Sara, sara@example.com"}]}
```

OpenAI 的 API 参考称之为 “the older JSON mode, which ensures the message the model generates is valid JSON.”（译文：较早的 JSON 模式，确保模型生成的消息是合法 JSON。）它附带两条规则。第一，你必须在消息里要求输出 JSON：OpenAI 的指南说，API “will throw an error if the string ‘JSON’ does not appear somewhere in the context.”（译文：如果上下文中没有出现字符串 ‘JSON’，就会抛出错误。）第二，结构由模型决定。指南明确指出，JSON 模式 “will not guarantee the output matches any specific schema.”（译文：不保证输出符合任何特定 schema。）

[结构化输出](https://broadrouter.com/zh/glossary/structured-output/)是更严格的选项。它用 `{"type": "json_schema", ...}` 传入一个 JSON Schema，模型的输出受其约束。

|  | JSON 模式（`json_object`） | 结构化输出（`json_schema`） |
| --- | --- | --- |
| 合法 JSON | 是 | 是 |
| 必填键与类型 | 否 | 是 |
| 需要你提供 schema | 否 | 是 |
| 提示词中必须提到 “JSON” | 是（OpenAI） | 否 |

OpenAI 建议 “always using Structured Outputs instead of JSON mode when possible.”（译文：只要可能，始终用 Structured Outputs 代替 JSON 模式。）

## 为什么重要

-   **校验仍然要你来做。** 用 JSON 模式时，缺一个键、或者把数字当字符串发回来，都能正常解析，却会在后面出错。请在代码里按 schema 校验。
-   **截断。** 如果回复触到 [`max_tokens`](https://broadrouter.com/zh/glossary/max-tokens/)，JSON 就是不完整的。推理模型更容易遇到这种情况，因为思考也消耗同一份预算。
-   **后备方案。** OpenAI 的指南把 JSON 模式列为不支持 `json_schema` 的旧模型上的选项。各服务商和模型的支持情况不一，所以当 schema 不被接受时，JSON 模式加上你自己的校验就是后备方案。

## 在 BroadNet Inference 上

BroadNet 的 [API 参考文档](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-glossary-json-mode&utm_content=body#models)为 GLM 5.3 和 Qwen3.8 27B 列出了结构化输出，但没有说明支持的 `response_format` 是 `json_object` 还是 `json_schema`，也没有说明 DeepSeek V4.1 Flash 和 BroadNet Gemma 4 VL 26B 是否接受其中任何一种。请在你的模型上把两种都测一遍。编写 schema 可以用 [JSON Schema 生成器](https://broadrouter.com/tools/json-schema-generator/)。[JSON mode 与 json\_schema](https://broadrouter.com/zh/blog/structured-output-json-schema/) 一文介绍了修复与监控，[发票指南](https://broadrouter.com/zh/guides/read-arabic-invoices-with-vision/)演示了如何从图片中提取 JSON。

## 常见问题

### JSON 模式和结构化输出是一回事吗？

不是。OpenAI 的指南说两者都会生成合法 JSON，但只有 Structured Outputs 能确保符合 schema。JSON 模式可能返回任意合法对象。

### 为什么 JSON 模式会报和 “JSON” 这个词有关的错误？

OpenAI 要求在消息中的某处明确要求输出 JSON；如果上下文里没有出现字符串 “JSON”，就会报错。

### 开了 JSON 模式还会返回残缺的 JSON 吗？

会，如果回复被 max\_tokens 或上下文上限截断。解析前请先检查 finish\_reason。

## 另请参阅

-   [结构化输出（structured output）](https://broadrouter.com/zh/glossary/structured-output/) (术语)
-   [工具调用（tool calling / function calling）](https://broadrouter.com/zh/glossary/tool-calling/) (术语)
-   [max\_tokens（最大输出 token 数）](https://broadrouter.com/zh/glossary/max-tokens/) (术语)
-   [系统提示词（system prompt）](https://broadrouter.com/zh/glossary/system-prompt/) (术语)
-   [OpenAI 兼容 API（OpenAI-compatible API）](https://broadrouter.com/zh/glossary/openai-compatible-api/) (术语)
-   [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/) (指南)
-   [JSON 模式与 json\_schema：靠得住的结构化输出](https://broadrouter.com/zh/blog/structured-output-json-schema/) (文章)
-   [用视觉大模型把发票、收据和表单数据提取为 JSON](https://broadrouter.com/zh/blog/extract-data-from-documents-with-vision-llm/) (文章)
-   [大模型返回的 JSON 不合法怎么办：原因、修复与重试](https://broadrouter.com/zh/blog/fix-invalid-json-from-llm/) (文章)

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

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

**来源**

-   [OpenAI：结构化输出指南（JSON mode 与 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 参考：模型 ID （英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-glossary-json-mode&utm_content=sources#models)
