JSON 转 OpenAI Structured Output Schema 与 Zod 转换器

当在 OpenAI response_format 或函数工具调用中启用 strict: true 时，每个 object 节点都必须设置 additionalProperties: false，并将所有属性键列入 required。

可以。将输出选择器切换为 TypeScript Zod，即可输出支持整数与浮点数推断的 z.object({...}).strict() 定义。

工具与响应 Schema 在每轮对话中都会按输入 Token 计费，不过提示词缓存可将重复 Schema 前缀的费用降低 90% 至 95%。

受限解码 Schema 编译器

JSON 有效 — 符合 OpenAI strict:true 规范（已强制启用 additionalProperties: false）

目标输出规范

示例 JSON 负载

编译后的严格 Schema

测算 Schema Token 开销

受限解码不变量约束

为什么 OpenAI Structured Outputs 会拒绝标准的 JSON Schema？

当在 response_format 或函数工具调用中启用 strict: true 时，受限解码要求每个 object 节点都设置 additionalProperties: false，并将所有属性键包含在 required 中。

可以生成启用 .strict() 的 TypeScript Zod Schema 吗？

可以。将目标规范选择器切换为 TypeScript Zod，即可输出可直接导入的 z.object({...}).strict() 代码，并自动识别 .int() 整数约束。

严格工具 Schema 会如何影响单次请求的 LLM Token 成本？

工具定义在每次调用时都会计入输入 Token；可将编译后的 Schema 粘贴到 LLM Token 成本计算器中，测算 90%–95% 的提示词缓存节省幅度。