Pular para o conteúdo principal
Envie um JSON Schema com a solicitação e o modelo retorna JSON nesse formato em vez de texto livre. O seu código ainda precisa interpretar e validar o resultado antes de usá-lo.

Escolher um formato

Onde o formato vai depende do endpoint:

Enviar um schema

O JSON volta como string no conteúdo da mensagem:

Projetar o schema

Comece com um objeto pequeno. Liste todos os campos em required, use enum para categorias conhecidas e defina additionalProperties: false quando chaves extras precisarem ser rejeitadas. Versione o schema junto com o seu validador no servidor para que os dois nunca se afastem.

Validar o resultado

Antes de interpretar, verifique se houve recusa, conteúdo ausente ou resposta truncada (finish_reason diferente de stop). Depois, valide o objeto interpretado. Este validador Zod corresponde ao schema acima:
Se a validação falhar, tente de novo uma vez com o erro no prompt e depois retorne uma falha segura. Cada nova tentativa é cobrada. Um JSON válido ainda não prova que os valores estão corretos nem que uma ação está autorizada. Acompanhe as falhas de validação por modelo e por versão do schema, e execute de novo os seus casos de avaliação quando qualquer um dos dois mudar. Para corrigir automaticamente JSON malformado, veja reparo de respostas.
Última modificação em 5 de novembro de 2026