¿Qué es la salida estructurada?

La salida estructurada hace que un modelo de lenguaje devuelva JSON que tu código puede analizar en lugar de texto libre. El modo JSON devuelve un objeto JSON sintácticamente válido, y el esquema JSON va más allá haciendo que la respuesta coincida con un esquema que defines, con sus campos y tipos requeridos.

Conceptos

Por qué importa la salida estructurada

Las aplicaciones suelen necesitar la respuesta de un modelo como datos: campos extraídos de una factura, una etiqueta para un ticket de soporte, los pasos de un plan, un registro que se debe guardar. Pedir JSON en el indicador funciona la mayoría de las veces, pero el texto libre puede llegar con una explicación antes que el JSON, una valla de código a su alrededor, un campo faltante o un número escrito como cadena. Cada uno de esos rompe un analizador.

La salida estructurada limita la generación en sí. La respuesta es JSON válida y, con un esquema, también tiene la forma exacta que pediste.

Modo JSON y esquema JSON

Hay dos niveles, ambos configurados con response_format:

  • Modo JSON. {"tipo": "json_object"} hace que el modelo devuelva un objeto JSON válido. Describes los campos que quieres en el aviso y la forma no se aplica.
  • Esquema JSON. {"type": "json_schema", "json_schema": {...}} toma un Nombre, a esquema y estricto, y hace que la salida se ajuste a ese esquema JSON: los campos obligatorios presentan, los tipos correctos y sin claves adicionales cuando se configura adicionalalProperties a falso.

Usa el esquema JSON cuando el modelo lo soporte y tu código dependa de campos exactos. Marca cada campo que tu código lee como requerido, usa enum Para elecciones fijas, mantén el anidamiento superficial y añade un corto Descripción a cualquier campo cuyo significado no sea obvio por su nombre.

Para un extractor de facturas, un esquema podría requerir Proveedor como una cuerda, Total como número, Moneda como enum de los códigos que acepta, y line_items como un array de objetos con Descripción y cantidad. Con estricto Establecido a Cierto, cada respuesta lleva esos campos con esos tipos, de modo que tu código lea las mismas claves cada vez. Con el modo JSON, pon un objeto de ejemplo corto en el indicador en su lugar, para que el modelo tenga una forma que seguir.

Soporte por modelo y endpoint

El soporte se establece por modelo. El structured_output campo en ¡VE /v1/models/{model} lecturas json_schema cuando el modelo soporta esquemas y json_object cuando solo soporta el modo JSON, y los modelos de esta página muestran qué nivel tiene cada uno. Enviar un formato que el modelo no soporta devuelve 400.

La misma función funciona en cada punto final de texto, con la forma propia de ese punto final:

  • /v1/chat/completions y /v1/completions: response_format.
  • /v1/responses: text.format.
  • /v1/messages: output_config.format, o un response_format junto al resto de la petición.

En el Playground, los modelos de chat que lo soportan tienen un modo Off, modo JSON y control de esquema JSON, con un cuadro para tu esquema. El Guía de compatibilidad contiene ejemplos completos de solicitudes.

Orientación práctica

  • Valida de todos modos. Analiza y verifica cada respuesta en código. Una respuesta cortada por el límite de salida, reportada como finish_reason Longitud, es JSON incompleto, así que fijado max_tokens Lo suficientemente alto para el objeto más grande que esperas.
  • Consulta los modelos de razonamiento. En algunos modelos, una solicitud con response_format Respuestas sin razonamiento a menos que también establezca habilitar pensar.
  • Modelos sin soporte. Pide JSON en el prompt, incluye un ejemplo de la forma y valida el resultado.
  • Elige la función adecuada. Usa salida estructurada cuando el JSON sea la respuesta final. Usa llamada de función cuándo debe el modelo elegir una acción para que tu código se ejecute.

Examinar Modelos de texto para comparar qué soporte cada nivel.

Compatibilidad con salida estructurada por modelo

62 modelos. La página de cada modelo tiene su tarjeta de precios, parámetros y código.

ModeloSalida estructuradaVentana de contexto
DeepSeek V4 Pro DeepSeekJSON Schema1M tokens
DeepSeek V4 Pro 0813 DeepSeekJSON Schema1M tokens
Fugu Max Sakana AIJSON Schema1M tokens
Fugu Ultra v1.1 Sakana AIJSON Schema1M tokens
Fugu Ultra v2.0 Sakana AIJSON Schema1M tokens
Gemma 4 26B-A4B GoogleJSON Schema256K tokens
Kimi K2.6 Moonshot AIJSON Schema256K tokens
Kimi K2.7 Code Moonshot AIJSON Schema256K tokens
Ver los 62 modelos
ModeloSalida estructuradaVentana de contexto
Kimi K2.7 Code Highspeed Moonshot AIJSON Schema256K tokens
Kimi K3 Moonshot AIJSON Schema1M tokens
Kimi K3.1 Pro Moonshot AIJSON Schema1M tokens
MiMo V2.6 Flash XiaomiJSON Schema1M tokens
MiMo V2.6 Pro XiaomiJSON Schema1M tokens
MiMo V2.6 Pro UltraSpeed XiaomiJSON Schema1M tokens
Mistral Small 3.1 Mistral AIJSON Schema89.6K tokens
Muse Glimmer 30B Meta AIJSON Schema128K tokens
Muse Spark 1.1 Meta AIJSON Schema1M tokens
Muse Spark 1.2 Meta AIJSON Schema1M tokens
Muse Spark 1.3 Meta AIJSON Schema1M tokens
Qwen3.5 4B Alibaba CloudJSON Schema256K tokens
Qwen3.5 9B Alibaba CloudJSON Schema256K tokens
Qwen3.5 Omni Plus Alibaba CloudJSON Schema192K tokens
Qwen3.6 35B A3B Alibaba CloudJSON Schema128K tokens
Qwen3.7 Flash Alibaba CloudJSON Schema983.6K tokens
Qwen3.7 Max Alibaba CloudJSON Schema983.6K tokens
Qwen3.7 Plus Alibaba CloudJSON Schema983.6K tokens
Qwen3.8 27B Alibaba CloudJSON Schema256K tokens
Qwen3.8 Flash Alibaba CloudJSON Schema983.6K tokens
Qwen3.8 Max Alibaba CloudJSON Schema983.6K tokens
Qwen3.8 Max 0902 Alibaba CloudJSON Schema983.6K tokens
Qwen3.8 Omni Flash Alibaba CloudJSON Schema1.01M tokens
Qwen4 Max Alibaba CloudJSON Schema983.6K tokens
Seed 2.0 Lite ByteDanceJSON Schema229.1K tokens
Seed 2.0 Mini ByteDanceJSON Schema229.2K tokens
Seed 2.0 Pro ByteDanceJSON Schema229.1K tokens
Seed 2.1 Turbo ByteDanceJSON Schema229.1K tokens
Step 5 Preview StepFunJSON Schema1.02M tokens
DeepSeek V4 Flash 0731 DeepSeekModo JSON1M tokens
DeepSeek V4.1 Flash 1017 DeepSeekModo JSON1M tokens
Fugu Ultra v1.0 Sakana AIModo JSON1M tokens
GLM 4.5 Flash Z.aiModo JSON128K tokens
GLM 4.6V Flash Z.aiModo JSON128K tokens
GLM 4.6V FlashX Z.aiModo JSON128K tokens
GLM 4.7 Flash Z.aiModo JSON202.8K tokens
GLM 4.7 FlashX Z.aiModo JSON202.8K tokens
GLM 5.1 Z.aiModo JSON202.7K tokens
GLM 5.2 Z.aiModo JSON1M tokens
GLM 5.3 Z.aiModo JSON1M tokens
GLM 5.3 Flash Z.aiModo JSON1M tokens
Mistral Small 4 Mistral AIModo JSON256K tokens
Qwen3.5 122B-A10B Alibaba CloudModo JSON258K tokens
Qwen3.5 27B Alibaba CloudModo JSON258K tokens
Qwen3.5 35B-A3B Alibaba CloudModo JSON258K tokens
Qwen3.5 397B-A17B Alibaba CloudModo JSON258K tokens
Qwen3.5 Flash Alibaba CloudModo JSON995.9K tokens
Qwen3.5 Plus Alibaba CloudModo JSON983.6K tokens
Qwen3.6 27B Alibaba CloudModo JSON224K tokens
Qwen3.6 Flash Alibaba CloudModo JSON983.6K tokens
Qwen3.6 Plus Alibaba CloudModo JSON983.6K tokens
Step 3.7 Flash StepFunModo JSON256K tokens
StepAudio 2.5 Chat StepFunModo JSON256K tokens
StepAudio 3 Chat StepFunModo JSON256K tokens

Preguntas frecuentes

¿Cuál es la diferencia entre el modo JSON y el esquema JSON?

El modo JSON devuelve un objeto JSON válido pero deja su forma a tu indicador. El esquema JSON hace que la respuesta coincida con un esquema que proporciones, incluyendo campos y tipos requeridos.

¿Qué modelos soportan salida estructurada?

El soporte es por modelo. El campo structured_output de cada modelo muestra json_schema para soporte de esquema o json_object solo para modo JSON, y una solicitud para un formato no soportado devuelve un error 400.

¿Todavía necesito validar el JSON?

Sí. Una respuesta puede ser interrumpida por el límite de salida, y tu aplicación puede tener reglas que un esquema no puede expresar, así que analiza y valida cada respuesta.

¿Puedo usar salida estructurada con los endpoints Respuestas o Mensajes?

Sí. El endpoint Responses utiliza text.format, y el endpoint Messages acepta output_config.format o un campo response_format.

¿Listo para usar mejores endpoints?

Consulta nuestros precios o contacta con nosotros si quieres que tu propio modelo se implemente en nuestra pila.