跳转到主要内容
随请求发送一个 JSON Schema,模型就会返回符合该结构的 JSON,而不是自由文本。你的代码仍需在使用前解析并验证它。

选择格式

格式放在哪里取决于端点:

发送 Schema

JSON 以字符串形式出现在消息内容中返回:

设计 Schema

从一个小对象开始。把每个字段都列入 required,对已知类别使用 enum,需要拒绝额外键时设置 additionalProperties: false。让 Schema 与服务器端验证器一起进行版本管理,使两者始终保持一致。

验证结果

解析之前,先检查是否有拒绝、内容缺失或回答被截断(finish_reason 不是 stop)。然后验证解析出的对象。下面的 Zod 验证器与上面的 Schema 一致:
如果验证失败,把错误放进提示词重试一次,然后返回安全的失败结果。每次重试都会计费。有效的 JSON 也不能证明值是正确的,或某个操作已获授权。 按模型和 Schema 版本跟踪验证失败,并在其中任何一项变化时重新运行你的评估用例。要自动修复格式错误的 JSON,请参阅响应修复。
最后修改于 2026年11月5日