Ir al contenido principal
Español— Elegir un idioma
Menú

JSON garantizado por esquema

Lección 1 de 12 Actualizado el 28 de julio de 2026 Desarrollador
En esta página
  1. Por qué las salidas estructuradas lo cambian todo
  2. Cómo funciona
  3. Disponibilidad
  4. Sin frente a con salidas estructuradas
  5. Dos enfoques disponibles
  6. Puntos clave

Por qué las salidas estructuradas lo cambian todo

Cuando utilizas un modelo de lenguaje en producción, necesitas respuestas que el código pueda consumir. No texto libre, ni JSON aproximado, sino JSON garantizado conforme a un esquema que tú defines. Eso es exactamente lo que te ofrecen las salidas estructuradas de la API de Grok.

El principio es sencillo: proporcionas un esquema JSON al modelo y la API garantiza que la respuesta seguirá esta estructura exactamente. Sin análisis improvisados, sin expresiones regulares frágiles, ni bloques try/catch para gestionar casos en los que el modelo se inventa un formato.

Cómo funciona

Las salidas estructuradas se basan en un mecanismo de restricción aplicado durante la generación del texto. En cada token producido, el modelo tiene la restricción de generar únicamente tokens compatibles con el esquema proporcionado. El resultado: un JSON que siempre es válido y siempre conforme.

Veamos un ejemplo concreto. Quieres extraer información de contacto de un correo electrónico:

from pydantic import BaseModel

class Contact(BaseModel):
    nom: str
    email: str
    entreprise: str
    telephone: str | None

# La respuesta SIEMPRE será un objeto Contact válido

Sin salidas estructuradas, el modelo podría devolver el teléfono como "tel", "phone" o "numéro". Con un esquema, el campo se llamará siempre telephone y su valor será siempre una cadena o null.

Disponibilidad

Las salidas estructuradas son compatibles con todos los modelos de lenguaje de xAI: Grok 4.5, Grok 4.3, las variantes grok-4.20 y versiones posteriores. Independientemente del modelo que utilices, la función está disponible sin coste adicional ni configuración extra.

100%
JSON válido garantizado
7
Tipos compatibles
Todos
Modelos de xAI
2
Métodos de llamada

Sin frente a con salidas estructuradas

Esto es lo que obtienes sin y con esta función:

Sin salidas estructuradas:

  • El modelo puede devolver texto libre, JSON parcial o un formato inesperado
  • Debes analizar manualmente y gestionar errores
  • Los nombres de los campos pueden variar de una solicitud a otra
  • Tu canal de procesamiento se rompe en cuanto el modelo cambia de formato

Con salidas estructuradas:

  • El JSON es siempre sintácticamente válido
  • La estructura coincide exactamente con el esquema proporcionado
  • Los tipos se respetan (cadena, número, booleano, etc.)
  • Tu código puede consumir la respuesta directamente

Dos enfoques disponibles

La API de Grok ofrece dos métodos para utilizar salidas estructuradas:

  • parse(): Método automático que devuelve directamente un objeto tipado. Ideal para la mayoría de los casos.
  • response_format: Método manual que devuelve una cadena JSON. Ofrece más control, pero el análisis corre de tu cuenta.

Descubrirás estos dos métodos en detalle en las próximas lecciones.

Puntos clave

  • Las salidas estructuradas garantizan un JSON conforme a tu esquema en cada llamada
  • La restricción se aplica durante la generación, no después
  • Todos los modelos de lenguaje de xAI son compatibles con esta función
  • Hay dos métodos disponibles: parse() (automático) y response_format (manual)
  • Esta es la base de cualquier canal de producción fiable con la API de Grok