AI / LLM Dev Tools

Comprobar un esquema de salida estructurada

Pega el JSON Schema o el contenido de parameters, elige el destino y revisa las rutas de diagnóstico antes de cambiar tu contrato.

Esquema de salida estructurada

JSON Schema

Informe de validación

Pega un JSON Schema para empezar.

Las entradas y referencias se procesan en este navegador; no se envían datos de validación ni se descargan referencias remotas.

Pega el esquema en sí. Para funciones, usa solo el objeto contenido en parameters.

Reglas revisadas: 2026-09-15. Reglas oficiales

Comprobación local previa; no garantiza la aceptación de la API ni el soporte de un modelo concreto.

Pega un JSON Schema para empezar.

Un esquema de salida estructurada puede ser válido en un comprobador general y aun así no cumplir las condiciones de un proveedor de modelos. Esta herramienta separa la estructura del esquema de las reglas del perfil elegido. Así puedes distinguir una errata de un problema que exige rediseñar los datos.

Para validar esquema JSON antes de producir salidas estructuradas LLM, también hay que revisar el modo estricto del proveedor. Las llamadas a funciones pueden tener la misma dificultad con campos opcionales y objetos abiertos. Cambia entre OpenAI y Gemini sin perder el texto original ni el contexto de la revisión.

Por qué revisar un esquema de salida estructurada

Separar la validez del contrato y las reglas del destino

Los campos opcionales y las claves adicionales pueden ser correctos en un esquema normal. Un esquema de salida estructurada para OpenAI strict añade requisitos. El resultado distingue la evaluación del metaesquema y los diagnósticos del destino; cada hallazgo incluye una ruta para localizar la definición y decidir qué hacer.

Un árbol de esquema supera una comprobación general, mientras otra marca dos ramas pendientes.

Comparar perfiles sin reescribir datos

Al pasar de OpenAI a Gemini se recalculan los hallazgos y se conserva la entrada. La herramienta no añade required ni borra palabras clave desconocidas para que todo parezca correcto. Primero puedes evaluar si la modificación cambia el conjunto de datos que acepta tu aplicación, y después editar el contrato.

Un esquema sin cambios se divide hacia dos perfiles con indicadores de diagnóstico distintos.

Del fragmento correcto al informe vigente

01

Extrae el cuerpo de parameters

Para el perfil de función OpenAI, pega únicamente el objeto dentro de parameters. El nombre, el indicador strict y la petición completa pertenecen al código de integración. Este perfil identifica el uso del esquema en el informe, pero no comprueba el envoltorio ni ejecuta la función.

02

Contrasta los dos ejemplos

El ejemplo válido contiene un campo obligatorio cuyo valor puede ser null. El ejemplo con errores omite condiciones de objeto exigidas por OpenAI. Cambia después a Gemini para ver cuáles dependen del destino. Antes de sustituir la entrada se muestran el contenido propuesto y la cantidad de caracteres afectados.

03

Exporta después de la última edición

La comprobación automática espera 350 ms desde el último cambio. Al desactivarla aparecen el botón y el atajo Ctrl/Cmd + Enter. Editar la fuente o cambiar el perfil bloquea enseguida el informe anterior. Deshacer restaura conjuntamente la entrada, el destino y el resultado que había antes de aplicar.

Revisar reglas con hallazgos concretos

Primero la estructura del esquema

El metaesquema 2020-12 incluido comprueba la forma y el tipo de las palabras clave. El analizador rechaza claves duplicadas y números que JavaScript redondearía. Los comentarios, las comas finales y los bloques Markdown se tratan como errores de sintaxis; no se reparan cambiando la entrada en silencio.

Rutas y referencias locales

Los hallazgos usan JSON Pointer, incluso para nombres con barras o virgulillas. Se comprueba que las referencias locales apunten a posiciones de esquema existentes. Una propiedad llamada allOf no se confunde con la palabra clave de composición, y los objetos literales de enum o default no se recorren como reglas.

Cobertura visible

Los perfiles OpenAI corresponden a strict sin ajuste fino. Gemini utiliza el subconjunto JSON Schema comprobado en la documentación. Una palabra clave o un formato no confirmado queda señalado para revisión. Ese aviso no afirma ni soporte ni rechazo por parte de la API: indica qué debe comprobarse aparte.

Informe completo para compartir

El JSON exportado contiene el perfil, la fecha de las reglas, la evaluación estructural, los contadores y los códigos de diagnóstico. Las listas largas muestran primero 50 elementos y permiten ver más. Copiar y descargar incluyen todo el informe, incluso los hallazgos que todavía no se han desplegado en pantalla.

Alcance de la comprobación previa

No certifica una API o una versión
Las reglas se revisaron el 2026-09-15. Los permisos de cuenta, los endpoints, la normalización del SDK, los rechazos y las versiones de modelo exigen una prueba real. Aquí no hay perfiles para OpenAI con ajuste fino, Anthropic, funciones Gemini ni intermediarios externos. Un resultado local favorable no cubre esas variables.
Un dialecto y punteros locales
La estructura se comprueba con 2020-12. Si se declara una versión anterior se informa del límite, sin migración automática. No se resuelven referencias remotas ni anclas con nombre. Las definiciones recursivas se inspeccionan de forma finita; no se expanden todas las respuestas posibles ni se certifica su complejidad en el servidor.
Presupuestos de trabajo separados
La entrada admite hasta 500000 caracteres, 50000 nodos analizados y 40 niveles JSON. El worker se detiene a los cinco segundos; superar 1000 diagnósticos interrumpe la comprobación sin un éxito parcial. Estas cotas del navegador son distintas de los límites OpenAI de propiedades, anidamiento, enumeraciones y cadenas.
No cambia la semántica automáticamente
Añadir required, permitir null o prohibir propiedades adicionales modifica el contrato. La herramienta solo propone direcciones de cambio. Admitir null no permite omitir la clave; si existe enum, revisa también esa lista. Evalúa la decisión junto con el código consumidor antes de editar y volver a comprobar.
Los valores devueltos necesitan validación
Esta página revisa la definición enviada al modelo, no la respuesta generada. No deduce esquemas a partir de muestras, no genera respuestas y no repara JSON dañado. Valida los datos reales contra tu contrato y las reglas de negocio; un valor con el tipo correcto todavía puede ser incorrecto para tu aplicación.

Dudas sobre el esquema de salida estructurada

¿Por qué seguir validando con Pydantic si la salida ya tiene forma restringida?

Restringir la forma no prueba que los valores sean correctos para tu negocio. La validación de la respuesta y las reglas de dominio siguen siendo necesarias. Esta página inspecciona el esquema antes de enviarlo; no sustituye la revisión del contenido que realmente devuelve el modelo ni las restricciones adicionales de tu aplicación.

¿Por qué OpenAI strict exige todos los campos en required?

El modo estricto fija la forma del objeto generado y exige las claves declaradas. Un valor desconocido puede representarse con null si el contrato lo permite. Si el campo tiene enum, esa lista también debe admitir null. Omitir una clave y devolver una clave obligatoria con null son situaciones diferentes.

¿Los formatos de OpenAI, Anthropic y Gemini son intercambiables?

Comparten ideas de JSON Schema, pero cambian los subconjuntos admitidos y el envoltorio de la solicitud. Aquí se comparan OpenAI strict y salida Gemini; Anthropic no tiene perfil. Un informe para uno no valida los demás, y el código de integración todavía debe enviar el esquema en el campo correcto.

¿Cómo puedo revisar un esquema antes de enviarlo a una API?

Comprueba primero la sintaxis y la estructura, elige el perfil adecuado y recorre los diagnósticos por ruta. Revisa también los avisos de cobertura. Termina con una petición al endpoint y modelo previstos: la comprobación local detecta errores comunes, pero no demuestra que la API concreta vaya a aceptar la solicitud.

¿Puedo pegar un ejemplo JSON en lugar de un esquema completo?

Una muestra no define qué campos pueden omitirse, si se permiten claves adicionales o qué rangos son válidos. Hace falta un esquema con tipos y restricciones. Puedes partir del ejemplo incluido, pero debes adaptar cada condición a los datos y al comportamiento que espera el código de tu aplicación.

¿Falta algún caso?

Vuelve al contrato con un diagnóstico concreto

Revisa tu esquema de salida estructurada con el perfil que realmente utilizarás. Antes de cambiar required, null o las claves adicionales, comprueba cómo interpreta esos casos el código consumidor y conserva una referencia para comparar los cambios.