结构化输出会让语言模型返回代码可以解析的 JSON,而不是自由文本。JSON 模式返回一个语法有效的 JSON 对象,而 JSON schema 更进一步,让响应与你定义的架构匹配,包括其必需字段和类型。
应用通常需要模型的答案作为数据:从发票中提取的字段、支持工单的标签、计划步骤、要保存的记录。在提示词中要求输入 JSON 大多数情况下有效,但自由文本也可以在 JSON 之前附上说明、在 JSON 周围设置代码围栏、缺失字段或以字符串形式写入的数字。这些都会破坏解析器。
结构化输出会限制生成本身。响应是有效的 JSON,并且在有架构的情况下,它也有你所要求的完全相同形状。
有两个等级,均设定为 response_format编号:
{“类型”:“json_object”} 使模型返回一个有效的 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 除非它也设定了,否则答案不带推理 启用 思考。 。 。.浏览 文本模型 以便比较各级别的支持。
共 62 个模型。每个模型的页面都有价目表、参数和代码。
| 模型 | 结构化输出 | 上下文窗口 |
|---|---|---|
| DeepSeek V4 Pro DeepSeek | JSON Schema | 1M 个 token |
| DeepSeek V4 Pro 0813 DeepSeek | JSON Schema | 1M 个 token |
| Fugu Max Sakana AI | JSON Schema | 1M 个 token |
| Fugu Ultra v1.1 Sakana AI | JSON Schema | 1M 个 token |
| Fugu Ultra v2.0 Sakana AI | JSON Schema | 1M 个 token |
| Gemma 4 26B-A4B Google | JSON Schema | 256K 个 token |
| Kimi K2.6 Moonshot AI | JSON Schema | 256K 个 token |
| Kimi K2.7 Code Moonshot AI | JSON Schema | 256K 个 token |
| 模型 | 结构化输出 | 上下文窗口 |
|---|---|---|
| Kimi K2.7 Code Highspeed Moonshot AI | JSON Schema | 256K 个 token |
| Kimi K3 Moonshot AI | JSON Schema | 1M 个 token |
| Kimi K3.1 Pro Moonshot AI | JSON Schema | 1M 个 token |
| MiMo V2.6 Flash Xiaomi | JSON Schema | 1M 个 token |
| MiMo V2.6 Pro Xiaomi | JSON Schema | 1M 个 token |
| MiMo V2.6 Pro UltraSpeed Xiaomi | JSON Schema | 1M 个 token |
| Mistral Small 3.1 Mistral AI | JSON Schema | 89.6K 个 token |
| Muse Glimmer 30B Meta AI | JSON Schema | 128K 个 token |
| Muse Spark 1.1 Meta AI | JSON Schema | 1M 个 token |
| Muse Spark 1.2 Meta AI | JSON Schema | 1M 个 token |
| Muse Spark 1.3 Meta AI | JSON Schema | 1M 个 token |
| Qwen3.5 4B Alibaba Cloud | JSON Schema | 256K 个 token |
| Qwen3.5 9B Alibaba Cloud | JSON Schema | 256K 个 token |
| Qwen3.5 Omni Plus Alibaba Cloud | JSON Schema | 192K 个 token |
| Qwen3.6 35B A3B Alibaba Cloud | JSON Schema | 128K 个 token |
| Qwen3.7 Flash Alibaba Cloud | JSON Schema | 983.6K 个 token |
| Qwen3.7 Max Alibaba Cloud | JSON Schema | 983.6K 个 token |
| Qwen3.7 Plus Alibaba Cloud | JSON Schema | 983.6K 个 token |
| Qwen3.8 27B Alibaba Cloud | JSON Schema | 256K 个 token |
| Qwen3.8 Flash Alibaba Cloud | JSON Schema | 983.6K 个 token |
| Qwen3.8 Max Alibaba Cloud | JSON Schema | 983.6K 个 token |
| Qwen3.8 Max 0902 Alibaba Cloud | JSON Schema | 983.6K 个 token |
| Qwen3.8 Omni Flash Alibaba Cloud | JSON Schema | 1.01M 个 token |
| Qwen4 Max Alibaba Cloud | JSON Schema | 983.6K 个 token |
| Seed 2.0 Lite ByteDance | JSON Schema | 229.1K 个 token |
| Seed 2.0 Mini ByteDance | JSON Schema | 229.2K 个 token |
| Seed 2.0 Pro ByteDance | JSON Schema | 229.1K 个 token |
| Seed 2.1 Turbo ByteDance | JSON Schema | 229.1K 个 token |
| Step 5 Preview StepFun | JSON Schema | 1.02M 个 token |
| DeepSeek V4 Flash 0731 DeepSeek | JSON 模式 | 1M 个 token |
| DeepSeek V4.1 Flash 1017 DeepSeek | JSON 模式 | 1M 个 token |
| Fugu Ultra v1.0 Sakana AI | JSON 模式 | 1M 个 token |
| GLM 4.5 Flash Z.ai | JSON 模式 | 128K 个 token |
| GLM 4.6V Flash Z.ai | JSON 模式 | 128K 个 token |
| GLM 4.6V FlashX Z.ai | JSON 模式 | 128K 个 token |
| GLM 4.7 Flash Z.ai | JSON 模式 | 202.8K 个 token |
| GLM 4.7 FlashX Z.ai | JSON 模式 | 202.8K 个 token |
| GLM 5.1 Z.ai | JSON 模式 | 202.7K 个 token |
| GLM 5.2 Z.ai | JSON 模式 | 1M 个 token |
| GLM 5.3 Z.ai | JSON 模式 | 1M 个 token |
| GLM 5.3 Flash Z.ai | JSON 模式 | 1M 个 token |
| Mistral Small 4 Mistral AI | JSON 模式 | 256K 个 token |
| Qwen3.5 122B-A10B Alibaba Cloud | JSON 模式 | 258K 个 token |
| Qwen3.5 27B Alibaba Cloud | JSON 模式 | 258K 个 token |
| Qwen3.5 35B-A3B Alibaba Cloud | JSON 模式 | 258K 个 token |
| Qwen3.5 397B-A17B Alibaba Cloud | JSON 模式 | 258K 个 token |
| Qwen3.5 Flash Alibaba Cloud | JSON 模式 | 995.9K 个 token |
| Qwen3.5 Plus Alibaba Cloud | JSON 模式 | 983.6K 个 token |
| Qwen3.6 27B Alibaba Cloud | JSON 模式 | 224K 个 token |
| Qwen3.6 Flash Alibaba Cloud | JSON 模式 | 983.6K 个 token |
| Qwen3.6 Plus Alibaba Cloud | JSON 模式 | 983.6K 个 token |
| Step 3.7 Flash StepFun | JSON 模式 | 256K 个 token |
| StepAudio 2.5 Chat StepFun | JSON 模式 | 256K 个 token |
| StepAudio 3 Chat StepFun | JSON 模式 | 256K 个 token |
JSON 模式返回一个有效的 JSON 对象,但其形状仍由提示字使用。JSON 模式使响应与您提供的模式相匹配,包括必填字段和类型。
支持是按模型计算的。每个模型的structured_output字段显示为json_schema表示模式支持,仅表示 JSON 模式json_object,请求不支持格式时返回 400 错误。
是的。响应可能会被输出限制截断,你的应用程序可能有模式无法表达的规则,所以要解析并验证每一个响应。
是的。Responses 端点使用 text.format,而 Messages 端点接受 output_config.format 或 response_format 字段。