Generador de JSON Schema para structured output
Pega un JSON de ejemplo, obtén un JSON Schema y copia una petición de API que hace que el modelo devuelva exactamente esa estructura. Todo funciona en tu navegador.
Todas las propiedades son required, additionalProperties es false y los campos que faltan en algunos elementos se vuelven nullable. El structured output estricto espera exactamente esto.
Tu JSON se procesa en este navegador y nunca se sube.
Ajustes de la petición (modelo, prompt)
Modelo de ejemplo. El soporte de json_schema varía según el modelo, así que revisa la página del modelo antes de depender de ello.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "response",
"type": "object",
"properties": {
"name": {
"type": "string"
},
"age": {
"type": "integer"
},
"email": {
"type": "string",
"format": "email"
},
"joined": {
"type": "string",
"format": "date-time"
},
"skills": {
"type": "array",
"items": {
"type": "string"
}
},
"address": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"zip": {
"type": "string"
}
},
"required": [
"city",
"zip"
],
"additionalProperties": false
}
},
"required": [
"name",
"age",
"email",
"joined",
"skills",
"address"
],
"additionalProperties": false
}Ejecútalo en HiAPI en tres pasos
- 01Crea una cuenta gratuita
Regístrate con correo, Google o GitHub. Toma alrededor de un minuto.
Regístrate - 02Crea una clave de API
Genera una clave en el panel y úsala en lugar de YOUR_API_KEY.
Conseguir clave de API - 03Haz tu primera llamada
Ejecuta el código generado. Tu petición aparece en los registros de uso.
Cómo generar un schema para salida estructurada
- 01 Pega un JSON de ejemplo
Usa un ejemplo real de la salida que quieres, con valores representativos. Incluye varios elementos en el array para que se detecten los campos opcionales.
- 02 Revisa el schema
Comprueba tipos y formatos y ajusta nombres. El modo estricto hace que todos los campos sean obligatorios, que es lo que espera la salida estructurada estricta.
- 03 Copia la llamada a la API
Elige cURL, Python o Node.js, añade tu clave y ejecútalo. El resultado es una cadena JSON en choices[0].message.content.
Preguntas frecuentes del generador de JSON Schema
¿Se sube mi JSON a algún sitio?
No. El schema y el código se generan por completo en tu navegador. Nada se envía a HiAPI ni a ningún otro servidor.
¿Qué cambia el modo estricto?
Marca cada propiedad como required, pone additionalProperties en false y convierte en tipos nullable los campos que falten en algunos elementos del array. La salida estructurada estricta requiere todo esto.
¿Todos los modelos admiten json_schema?
No. La compatibilidad depende del modelo. El ejemplo usa kimi-k3 con response_format.type en json_schema. Consulta la página del modelo para ver qué admite cada uno.
¿Cómo se infiere el schema a partir de un ejemplo?
Los tipos salen de tus valores, se distinguen enteros y decimales, los arrays se fusionan entre elementos y se añaden formatos de cadena cuando todas las muestras coinciden. Un solo ejemplo no puede mostrar enums ni límites de valores, así que edítalos a mano.
¿Dónde está el resultado estructurado en la respuesta?
En choices[0].message.content como cadena JSON. Analízala y valida los campos de negocio en tu aplicación.