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.
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.
Hay dos niveles, ambos configurados con response_format:
{"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.{"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.
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.
finish_reason Longitud, es JSON incompleto, así que fijado max_tokens Lo suficientemente alto para el objeto más grande que esperas.response_format Respuestas sin razonamiento a menos que también establezca habilitar pensar.Examinar Modelos de texto para comparar qué soporte cada nivel.
62 modelos. La página de cada modelo tiene su tarjeta de precios, parámetros y código.
| Modelo | Salida estructurada | Ventana de contexto |
|---|---|---|
| DeepSeek V4 Pro DeepSeek | JSON Schema | 1M tokens |
| DeepSeek V4 Pro 0813 DeepSeek | JSON Schema | 1M tokens |
| Fugu Max Sakana AI | JSON Schema | 1M tokens |
| Fugu Ultra v1.1 Sakana AI | JSON Schema | 1M tokens |
| Fugu Ultra v2.0 Sakana AI | JSON Schema | 1M tokens |
| Gemma 4 26B-A4B Google | JSON Schema | 256K tokens |
| Kimi K2.6 Moonshot AI | JSON Schema | 256K tokens |
| Kimi K2.7 Code Moonshot AI | JSON Schema | 256K tokens |
| Modelo | Salida estructurada | Ventana de contexto |
|---|---|---|
| Kimi K2.7 Code Highspeed Moonshot AI | JSON Schema | 256K tokens |
| Kimi K3 Moonshot AI | JSON Schema | 1M tokens |
| Kimi K3.1 Pro Moonshot AI | JSON Schema | 1M tokens |
| MiMo V2.6 Flash Xiaomi | JSON Schema | 1M tokens |
| MiMo V2.6 Pro Xiaomi | JSON Schema | 1M tokens |
| MiMo V2.6 Pro UltraSpeed Xiaomi | JSON Schema | 1M tokens |
| Mistral Small 3.1 Mistral AI | JSON Schema | 89.6K tokens |
| Muse Glimmer 30B Meta AI | JSON Schema | 128K tokens |
| Muse Spark 1.1 Meta AI | JSON Schema | 1M tokens |
| Muse Spark 1.2 Meta AI | JSON Schema | 1M tokens |
| Muse Spark 1.3 Meta AI | JSON Schema | 1M tokens |
| Qwen3.5 4B Alibaba Cloud | JSON Schema | 256K tokens |
| Qwen3.5 9B Alibaba Cloud | JSON Schema | 256K tokens |
| Qwen3.5 Omni Plus Alibaba Cloud | JSON Schema | 192K tokens |
| Qwen3.6 35B A3B Alibaba Cloud | JSON Schema | 128K tokens |
| Qwen3.7 Flash Alibaba Cloud | JSON Schema | 983.6K tokens |
| Qwen3.7 Max Alibaba Cloud | JSON Schema | 983.6K tokens |
| Qwen3.7 Plus Alibaba Cloud | JSON Schema | 983.6K tokens |
| Qwen3.8 27B Alibaba Cloud | JSON Schema | 256K tokens |
| Qwen3.8 Flash Alibaba Cloud | JSON Schema | 983.6K tokens |
| Qwen3.8 Max Alibaba Cloud | JSON Schema | 983.6K tokens |
| Qwen3.8 Max 0902 Alibaba Cloud | JSON Schema | 983.6K tokens |
| Qwen3.8 Omni Flash Alibaba Cloud | JSON Schema | 1.01M tokens |
| Qwen4 Max Alibaba Cloud | JSON Schema | 983.6K tokens |
| Seed 2.0 Lite ByteDance | JSON Schema | 229.1K tokens |
| Seed 2.0 Mini ByteDance | JSON Schema | 229.2K tokens |
| Seed 2.0 Pro ByteDance | JSON Schema | 229.1K tokens |
| Seed 2.1 Turbo ByteDance | JSON Schema | 229.1K tokens |
| Step 5 Preview StepFun | JSON Schema | 1.02M tokens |
| DeepSeek V4 Flash 0731 DeepSeek | Modo JSON | 1M tokens |
| DeepSeek V4.1 Flash 1017 DeepSeek | Modo JSON | 1M tokens |
| Fugu Ultra v1.0 Sakana AI | Modo JSON | 1M tokens |
| GLM 4.5 Flash Z.ai | Modo JSON | 128K tokens |
| GLM 4.6V Flash Z.ai | Modo JSON | 128K tokens |
| GLM 4.6V FlashX Z.ai | Modo JSON | 128K tokens |
| GLM 4.7 Flash Z.ai | Modo JSON | 202.8K tokens |
| GLM 4.7 FlashX Z.ai | Modo JSON | 202.8K tokens |
| GLM 5.1 Z.ai | Modo JSON | 202.7K tokens |
| GLM 5.2 Z.ai | Modo JSON | 1M tokens |
| GLM 5.3 Z.ai | Modo JSON | 1M tokens |
| GLM 5.3 Flash Z.ai | Modo JSON | 1M tokens |
| Mistral Small 4 Mistral AI | Modo JSON | 256K tokens |
| Qwen3.5 122B-A10B Alibaba Cloud | Modo JSON | 258K tokens |
| Qwen3.5 27B Alibaba Cloud | Modo JSON | 258K tokens |
| Qwen3.5 35B-A3B Alibaba Cloud | Modo JSON | 258K tokens |
| Qwen3.5 397B-A17B Alibaba Cloud | Modo JSON | 258K tokens |
| Qwen3.5 Flash Alibaba Cloud | Modo JSON | 995.9K tokens |
| Qwen3.5 Plus Alibaba Cloud | Modo JSON | 983.6K tokens |
| Qwen3.6 27B Alibaba Cloud | Modo JSON | 224K tokens |
| Qwen3.6 Flash Alibaba Cloud | Modo JSON | 983.6K tokens |
| Qwen3.6 Plus Alibaba Cloud | Modo JSON | 983.6K tokens |
| Step 3.7 Flash StepFun | Modo JSON | 256K tokens |
| StepAudio 2.5 Chat StepFun | Modo JSON | 256K tokens |
| StepAudio 3 Chat StepFun | Modo JSON | 256K tokens |
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.
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.
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.
Sí. El endpoint Responses utiliza text.format, y el endpoint Messages acepta output_config.format o un campo response_format.
Consulta nuestros precios o contacta con nosotros si quieres que tu propio modelo se implemente en nuestra pila.