Saltar al contenido principal
Envía un JSON Schema con la solicitud y el modelo devuelve JSON con esa forma en lugar de texto libre. Tu código sigue teniendo que analizarlo y validarlo antes de usarlo.

Elegir un formato

Dónde va el formato depende del endpoint:

Enviar un esquema

El JSON vuelve como una cadena en el contenido del mensaje:

Diseñar el esquema

Empieza con un objeto pequeño. Incluye todos los campos en required, usa enum para las categorías conocidas y define additionalProperties: false cuando haya que rechazar claves adicionales. Versiona el esquema junto con tu validador del servidor para que nunca se desincronicen.

Validar el resultado

Antes de analizarla, comprueba si la respuesta es un rechazo, si falta contenido o si está truncada (finish_reason distinto de stop). Después valida el objeto analizado. Este validador de Zod corresponde al esquema anterior:
Si la validación falla, reintenta una vez con el error en el prompt y después devuelve un fallo seguro. Cada reintento se cobra. Un JSON válido sigue sin demostrar que los valores sean correctos ni que una acción esté autorizada. Haz un seguimiento de los fallos de validación por modelo y versión del esquema, y vuelve a ejecutar tus casos de evaluación cuando cambie cualquiera de los dos. Para reparar automáticamente un JSON mal formado, consulta la reparación de respuestas.
Última modificación el 5 de noviembre de 2026