Establece response_format
El modo JSON sirve para un objeto sencillo. JSON Schema añade nombre de esquema, estructura de campos, propiedades obligatorias y una forma de rechazar propiedades extra.
Un esquema estricto reduce el análisis defensivo, pero nunca sustituye la validación en la aplicación.
Formato de respuesta JSON Schema
json
{
"model": "openai/gpt-5.6-sol",
"messages": [{"role": "user", "content": "Extract an order summary."}],
"response_format": {
"type": "json_schema",
"json_schema": {
"name": "order_summary",
"strict": true,
"schema": {
"type": "object",
"properties": {"items": {"type": "array"}, "total": {"type": "number"}},
"required": ["items", "total"],
"additionalProperties": false
}
}
}
}Diseña el esquema
- Mantén campos y descripciones concisos y específicos del dominio.
- Establece additionalProperties: false cuando no se acepten campos desconocidos.
- Versiona los esquemas en tu código en vez de cambiar de forma invisible un contrato de consumidor.
Gestiona el resultado
Valida el JSON devuelto con el mismo validador que utiliza tu API o base de datos.
Si un modelo o ruta no acepta el formato solicitado, muestra un error controlado y selecciona una opción compatible mediante el catálogo.