~/tools / Structured Output Schema Checker
Structured Output Schema Checker — Comprueba un JSON Schema con los límites de OpenAI, Anthropic y Gemini
Comprueba un JSON Schema con los límites documentados de las salidas estructuradas de OpenAI, Anthropic y Gemini. Ve qué palabras clave se rechazan, se ignoran o no están documentadas antes de enviar el esquema a la API. Nada sale de tu navegador.
Reglas comprobadas con la documentación de cada proveedor el 2026-10-23.
No se comprueba: la profundidad de anidamiento, el límite de los enum largos y todo lo que los proveedores no documentan. Los proveedores cambian estas reglas, así que consulta la documentación vigente.
Todo se ejecuta en tu navegador. El esquema no se sube.
Las API de IA pueden obligar a que la respuesta de un modelo siga un JSON Schema, pero cada proveedor admite solo una parte de JSON Schema, y las partes difieren. Un esquema que funciona con un proveedor puede ser rechazado por otro, o aceptado mientras algunas de sus reglas se descartan en silencio. Esta herramienta lee tu esquema y lo comprueba con lo que dice la documentación de cada proveedor: reglas obligatorias como additionalProperties en false, palabras clave que no se admiten, palabras clave que se aceptan pero no se aplican, y límites de tamaño publicados. Los resultados se clasifican en tres tipos para que puedas distinguir un error documentado de una palabra clave que la documentación simplemente no menciona. Las reglas se comprobaron con la documentación de los proveedores en la fecha que aparece debajo de la herramienta.
Casos de uso
- Comprobar un esquema antes de enviarlo como solicitud de salida estructurada, para no enterarte por un error 400
- Encontrar qué palabras clave debes sacar del esquema y llevar a tu propio código de validación
- Comparar lo que aceptan OpenAI, Anthropic y Gemini para el mismo esquema
Cómo usarlo
- Pega el JSON Schema que piensas enviar, o carga el ejemplo.
- Lee el resultado de cada proveedor. No aceptado significa que la documentación dice que el esquema fallará o que debe cambiar. Ignorado significa que la palabra clave se acepta pero no se aplica. No documentado significa que la palabra clave no figura en la lista de palabras clave admitidas del proveedor.
- Corrige lo marcado como No aceptado y comprueba el resto con una solicitud real.
FAQ
¿Un resultado sin problemas significa que la API aceptará mi esquema?
No. La herramienta comprueba las reglas que los proveedores documentan. No llama a ninguna API y la documentación no lo cubre todo, así que un esquema aún puede ser rechazado. Toma un resultado limpio como «ningún problema conocido» y prueba con una solicitud real.
¿Qué significan No aceptado, Ignorado y No documentado?
No aceptado: la documentación dice que la palabra clave no se admite o que hay que cumplir una regla, por ejemplo que additionalProperties debe ser false. Ignorado: la documentación dice que la palabra clave se acepta pero no se aplica, así que el modelo puede incumplirla. No documentado: la palabra clave no está en la lista de palabras clave admitidas del proveedor, por lo que puede rechazarse o ignorarse y la documentación no dice cuál de las dos cosas ocurre.
¿Por qué OpenAI exige que todas las propiedades sean required?
En el modo strict, OpenAI exige que todas las propiedades figuren en required y que additionalProperties sea false. Para hacer opcional un campo, la documentación indica usar una unión con null, por ejemplo un type de ["string", "null"].
Mi esquema usa minimum, maxLength o algo parecido. ¿Qué hago?
Anthropic no admite restricciones numéricas ni límites de longitud de cadenas, y Gemini no aplica los límites de longitud. Quítalos del esquema, describe el límite en el campo description y comprueba el valor tú mismo cuando llegue la respuesta. La herramienta JSON Schema Validator puede hacer esa comprobación.
¿Esta herramienta comprueba la recursión?
Sí, para Anthropic, cuya documentación indica que los esquemas recursivos no se admiten. OpenAI y Gemini documentan los esquemas recursivos, así que no se marcan.
¿Qué no se comprueba?
La profundidad de anidamiento, el límite de los enum largos y todo lo que los proveedores no documentan. Además, la herramienta no conoce modelos más nuevos ni funciones añadidas después de la fecha de comprobación, así que consulta la documentación vigente cuando importe.
¿Mi esquema se envía a un servidor?
No. La comprobación se hace en tu navegador.