Conversor de JSON para Schema Structured Output da OpenAI e Zod

Q: Por que o OpenAI Structured Outputs rejeita JSON Schemas padrão?

Quando strict: true está ativado em response_format ou na chamada de ferramentas da OpenAI, cada nó object precisa definir additionalProperties: false e listar todas as chaves de propriedades dentro de required.

Q: Posso gerar schemas TypeScript Zod com .strict() ativado?

Sim. Altere o seletor de saída para TypeScript Zod para emitir definições z.object({...}).strict() com inferência entre inteiros e números de ponto flutuante.

Q: Como schemas estritos de ferramentas afetam o custo de tokens de LLM por requisição?

Schemas de ferramentas e respostas são cobrados como tokens de entrada em cada turno, embora o cache de prompt ofereça de 90% a 95% de desconto em prefixos repetidos de schema.

Compilador de schemas para decodificação restrita

JSON válido — compatível com OpenAI strict:true (additionalProperties: false aplicado)

Especificação de saída desejada

Payload JSON de exemplo

Schema estrito compilado

Medir sobrecarga de tokens do schema

Invariantes da decodificação restrita

additionalProperties: false: Aplicado recursivamente em cada nó object aninhado.
Array required completo: Toda propriedade declarada é listada em required com raiz do tipo object.

Perguntas frequentes

Por que o OpenAI Structured Outputs rejeita JSON Schemas padrão?

Quando strict: true está ativado em response_format ou na chamada de ferramentas, a decodificação restrita exige que cada nó object defina additionalProperties: false e inclua todas as chaves de propriedades dentro de required.

Posso gerar schemas TypeScript Zod com .strict() ativado?

Sim. Altere o seletor de especificação de saída para TypeScript Zod para emitir código pronto para importar com z.object({...}).strict() e detecção automática de .int().

Como schemas estritos de ferramentas afetam o custo de tokens de LLM por requisição?

Definições de ferramentas contam como tokens de entrada em cada chamada; cole o schema compilado na Calculadora de custos de tokens de LLM para simular a economia de 90%–95% com cache de prompt.

Conversor de JSON para Schema Structured Output da OpenAI & Zod

Invariantes da decodificação restrita

Perguntas frequentes