什么是结构化输出?

结构化输出会让语言模型返回代码可以解析的 JSON,而不是自由文本。JSON 模式返回一个语法有效的 JSON 对象,而 JSON schema 更进一步,让响应与你定义的架构匹配,包括其必需字段和类型。

核心概念

为什么结构化输出很重要

应用通常需要模型的答案作为数据:从发票中提取的字段、支持工单的标签、计划步骤、要保存的记录。在提示词中要求输入 JSON 大多数情况下有效,但自由文本也可以在 JSON 之前附上说明、在 JSON 周围设置代码围栏、缺失字段或以字符串形式写入的数字。这些都会破坏解析器。

结构化输出会限制生成本身。响应是有效的 JSON,并且在有架构的情况下,它也有你所要求的完全相同形状。

JSON 模式和 JSON 架构

有两个等级,均设定为 response_format编号:

  • JSON 模式。 {“类型”:“json_object”} 使模型返回一个有效的 JSON 对象。你在提示中描述了想要的字段,且该形状不会被强制执行。
  • JSON 架构。 {“type”: “json_schema”, “json_schema”: {...}} 需要一个 名称, a 模式 以及 严格,并使输出符合该 JSON 架构:必须字段存在,类型正确,设置时无额外键 附加属性 到 错误。 。 。.

当模型支持JSON架构且你的代码依赖于精确字段时,使用它。将代码读取的每个字段标记为必需,使用 枚举 对于固定选择,保持嵌套浅层,并添加短线 描述 任何一个名称中含义不明显的领域。

对于发票提取器,架构可能需要 供应商 作为字符串, 总计 作为一个数字, 货币 作为 枚举 你接受的代码,以及 line_items 作为对象数组,且 描述 以及 金额.与 严格 设置为 确实如此,每个响应都携带这些字段和这些类型的字段,因此你的代码每次读取的键都是相同的。在 JSON 模式下,可以在提示词中放置一个简短的示例对象,这样模型就有一个可以跟随的形状。

按型号和终端提供支持

支持度按型号设定。该 structured_output 字段 快去/v1/models/{model} 阅读 json_schema 当模型支持架构和 json_object 当它仅支持 JSON 模式,并且本页面上的模型显示每个模型的级别时。发送模型不支持的格式返回 400。 。 。.

同样的功能适用于每个文本端点,且该端点的形状如下:

  • /v1/chat/completions 以及 /v1/completions编号: response_format。 。 。.
  • /v1/responses (英语)编号: text.format。 。 。.
  • /v1/messages (英语)编号: output_config.格式,或 response_format 放在请求的其他部分旁边。

在 Playground支持该模式的聊天模型具有关闭、JSON 模式和 JSON 架构控件,并配有一个用于配置架构的框。该 兼容性指南 提供完整的请求示例。

实用指导

  • 无论如何都要认可。 解析并检查代码中的每个响应。响应被输出限制截断,报告为 finish_reason 长度,是不完整的 JSON,因此设置为 max_tokens 足够高,能容纳你预期的最大物体。
  • 检查推理模型。 在某些型号上,请求 response_format 除非它也设定了,否则答案不带推理 启用 思考。 。 。.
  • 没有支持的模型。 在提示中要求输入 JSON,附上形状示例,并验证结果。
  • 选择合适的功能。 当 JSON 是最终答案时,请使用结构化输出。使用 函数调用 模型应为你的代码选择执行的动作。

浏览 文本模型 以便比较各级别的支持。

各模型的结构化输出支持

共 62 个模型。每个模型的页面都有价目表、参数和代码。

模型结构化输出上下文窗口
DeepSeek V4 Pro DeepSeekJSON Schema1M 个 token
DeepSeek V4 Pro 0813 DeepSeekJSON Schema1M 个 token
Fugu Max Sakana AIJSON Schema1M 个 token
Fugu Ultra v1.1 Sakana AIJSON Schema1M 个 token
Fugu Ultra v2.0 Sakana AIJSON Schema1M 个 token
Gemma 4 26B-A4B GoogleJSON Schema256K 个 token
Kimi K2.6 Moonshot AIJSON Schema256K 个 token
Kimi K2.7 Code Moonshot AIJSON Schema256K 个 token
显示全部 62 个模型
模型结构化输出上下文窗口
Kimi K2.7 Code Highspeed Moonshot AIJSON Schema256K 个 token
Kimi K3 Moonshot AIJSON Schema1M 个 token
Kimi K3.1 Pro Moonshot AIJSON Schema1M 个 token
MiMo V2.6 Flash XiaomiJSON Schema1M 个 token
MiMo V2.6 Pro XiaomiJSON Schema1M 个 token
MiMo V2.6 Pro UltraSpeed XiaomiJSON Schema1M 个 token
Mistral Small 3.1 Mistral AIJSON Schema89.6K 个 token
Muse Glimmer 30B Meta AIJSON Schema128K 个 token
Muse Spark 1.1 Meta AIJSON Schema1M 个 token
Muse Spark 1.2 Meta AIJSON Schema1M 个 token
Muse Spark 1.3 Meta AIJSON Schema1M 个 token
Qwen3.5 4B Alibaba CloudJSON Schema256K 个 token
Qwen3.5 9B Alibaba CloudJSON Schema256K 个 token
Qwen3.5 Omni Plus Alibaba CloudJSON Schema192K 个 token
Qwen3.6 35B A3B Alibaba CloudJSON Schema128K 个 token
Qwen3.7 Flash Alibaba CloudJSON Schema983.6K 个 token
Qwen3.7 Max Alibaba CloudJSON Schema983.6K 个 token
Qwen3.7 Plus Alibaba CloudJSON Schema983.6K 个 token
Qwen3.8 27B Alibaba CloudJSON Schema256K 个 token
Qwen3.8 Flash Alibaba CloudJSON Schema983.6K 个 token
Qwen3.8 Max Alibaba CloudJSON Schema983.6K 个 token
Qwen3.8 Max 0902 Alibaba CloudJSON Schema983.6K 个 token
Qwen3.8 Omni Flash Alibaba CloudJSON Schema1.01M 个 token
Qwen4 Max Alibaba CloudJSON Schema983.6K 个 token
Seed 2.0 Lite ByteDanceJSON Schema229.1K 个 token
Seed 2.0 Mini ByteDanceJSON Schema229.2K 个 token
Seed 2.0 Pro ByteDanceJSON Schema229.1K 个 token
Seed 2.1 Turbo ByteDanceJSON Schema229.1K 个 token
Step 5 Preview StepFunJSON Schema1.02M 个 token
DeepSeek V4 Flash 0731 DeepSeekJSON 模式1M 个 token
DeepSeek V4.1 Flash 1017 DeepSeekJSON 模式1M 个 token
Fugu Ultra v1.0 Sakana AIJSON 模式1M 个 token
GLM 4.5 Flash Z.aiJSON 模式128K 个 token
GLM 4.6V Flash Z.aiJSON 模式128K 个 token
GLM 4.6V FlashX Z.aiJSON 模式128K 个 token
GLM 4.7 Flash Z.aiJSON 模式202.8K 个 token
GLM 4.7 FlashX Z.aiJSON 模式202.8K 个 token
GLM 5.1 Z.aiJSON 模式202.7K 个 token
GLM 5.2 Z.aiJSON 模式1M 个 token
GLM 5.3 Z.aiJSON 模式1M 个 token
GLM 5.3 Flash Z.aiJSON 模式1M 个 token
Mistral Small 4 Mistral AIJSON 模式256K 个 token
Qwen3.5 122B-A10B Alibaba CloudJSON 模式258K 个 token
Qwen3.5 27B Alibaba CloudJSON 模式258K 个 token
Qwen3.5 35B-A3B Alibaba CloudJSON 模式258K 个 token
Qwen3.5 397B-A17B Alibaba CloudJSON 模式258K 个 token
Qwen3.5 Flash Alibaba CloudJSON 模式995.9K 个 token
Qwen3.5 Plus Alibaba CloudJSON 模式983.6K 个 token
Qwen3.6 27B Alibaba CloudJSON 模式224K 个 token
Qwen3.6 Flash Alibaba CloudJSON 模式983.6K 个 token
Qwen3.6 Plus Alibaba CloudJSON 模式983.6K 个 token
Step 3.7 Flash StepFunJSON 模式256K 个 token
StepAudio 2.5 Chat StepFunJSON 模式256K 个 token
StepAudio 3 Chat StepFunJSON 模式256K 个 token

常见问题

JSON 模式和 JSON 架构有什么区别?

JSON 模式返回一个有效的 JSON 对象,但其形状仍由提示字使用。JSON 模式使响应与您提供的模式相匹配,包括必填字段和类型。

哪些模型支持结构化输出?

支持是按模型计算的。每个模型的structured_output字段显示为json_schema表示模式支持,仅表示 JSON 模式json_object,请求不支持格式时返回 400 错误。

我还需要验证 JSON 吗?

是的。响应可能会被输出限制截断,你的应用程序可能有模式无法表达的规则,所以要解析并验证每一个响应。

我可以将结构化输出与响应或消息端点一起使用吗?

是的。Responses 端点使用 text.format,而 Messages 端点接受 output_config.format 或 response_format 字段。

准备好使用更好的终端了吗?

查看我们的定价,或者如果你想将自己的模型部署到我们的堆栈中,请联系我们。