Obtén salidas estructuradas
Envía un JSON Schema para que el modelo devuelva JSON con tu forma, y valídalo antes de usarlo.
Envía un JSON Schema con la solicitud y el modelo devolverá JSON con esa forma en lugar de texto libre. Úsalo cuando quieras recibir datos, como campos extraídos de un correo. Usa las llamadas a herramientas cuando quieras que el modelo pida a tu aplicación que haga algo.
type | Qué obtienes |
|---|---|
json_schema | JSON que sigue tu esquema. Úsalo por defecto. |
json_object | Algún objeto JSON válido, sin forma obligatoria. |
text | Texto sin formato (el valor predeterminado). |
El formato va en response_format en /v1/chat/completions, en text.format en /v1/responses y en output_config.format en /v1/messages (solo json_schema).
{
"model": "openai/gpt-6-astra",
"messages": [
{ "role": "user", "content": "Return the city and weather for London." }
],
"response_format": {
"type": "json_schema",
"json_schema": {
"name": "weather",
"strict": true,
"schema": {
"type": "object",
"properties": {
"city": { "type": "string" },
"weather": { "type": "string" }
},
"required": ["city", "weather"],
"additionalProperties": false
}
}
}
}
El JSON llega como cadena en el contenido del mensaje. Antes de analizarlo, comprueba si hay una negativa, si falta contenido o si el finish_reason es distinto de stop. Después valida el objeto analizado, por ejemplo con Zod. 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, y un JSON válido no demuestra que los valores sean correctos.
Phaseo nunca descarta response_format. Solo enruta una solicitud json_schema a proveedores que admiten salidas estructuradas; si ninguno de los proveedores del modelo las admite, la solicitud falla con 400 validation_error. Las páginas de los modelos indican la compatibilidad con structured_outputs, que es un indicador de capacidad, no un campo de la solicitud.
Comprueba lo que has aprendido
Envías response_format con json_schema a un modelo cuyos proveedores no admiten salidas estructuradas. ¿Qué pasa?
Ponlo en práctica
Tu analizador de facturas usa json_schema y, de vez en cuando, la respuesta no supera tu comprobación de Zod porque falta total. ¿Qué debe hacer el código?
Mostrar la respuestaOcultar la respuesta
Primero comprueba que finish_reason es stop, porque una respuesta cortada no puede ser válida. Después reintenta una vez con el error de validación en el prompt y, si vuelve a fallar, devuelve un fallo seguro en lugar de adivinar. Lleva la cuenta de los fallos por modelo y por versión del esquema para detectar cuándo un cambio en cualquiera de los dos empeora los resultados.
Idea clave
json_schema para los datos que necesitas con una forma fija, y valida siempre el resultado en tu propio código antes de fiarte de él.Enlaces relacionados
Revisado por última vez el 17 de noviembre de 2026