El modo JSON responde una pregunta: ¿funcionará json.loads()? No responde la segunda: ¿es este el objeto que espera mi código?
Cómo funciona
En la API de Chat Completions se activa con un solo campo:
{"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Return JSON with keys name and email."},
{"role": "user", "content": "Reach me at Sara, sara@example.com"}]}
La referencia de la API de OpenAI lo llama “the older JSON mode, which ensures the message the model generates is valid JSON.” (traducción: el modo JSON anterior, que garantiza que el mensaje que genera el modelo sea JSON válido.) Trae dos reglas. Debe pedir JSON en algún mensaje: la guía de OpenAI dice que la API “will throw an error if the string ‘JSON’ does not appear somewhere in the context.” (traducción: lanzará un error si la cadena ‘JSON’ no aparece en algún lugar del contexto.) Y la forma queda en manos del modelo. La guía afirma que el modo JSON “will not guarantee the output matches any specific schema.” (traducción: no garantizará que la salida coincida con ningún esquema concreto.)
La salida estructurada es la opción más estricta. Pasa un JSON Schema con {"type": "json_schema", ...}, y el modelo queda restringido a él.
Modo JSON (json_object) |
Salida estructurada (json_schema) |
|
|---|---|---|
| JSON válido | sí | sí |
| Claves obligatorias y tipos | no | sí |
| Usted proporciona un esquema | no | sí |
| Hay que mencionar “JSON” en el prompt | sí (OpenAI) | no |
OpenAI recomienda “always using Structured Outputs instead of JSON mode when possible.” (traducción: usar siempre Structured Outputs en lugar del modo JSON cuando sea posible.)
Por qué importa
- La validación sigue siendo suya. Con el modo JSON, una clave que falta o un número enviado como cadena se procesan sin problema y fallan más adelante. Valide contra un esquema en su código.
- Truncamiento. Si la respuesta alcanza
max_tokens, el JSON queda incompleto. Los modelos de razonamiento están más expuestos, porque el razonamiento consume el mismo presupuesto. - Respaldo. La guía de OpenAI menciona el modo JSON en modelos anteriores donde
json_schemano está disponible. El soporte varía según el proveedor y el modelo, así que el modo JSON más su propia validación es el respaldo cuando no se acepta un esquema.
En BroadNet Inference
La referencia de la API de BroadNet incluye salida estructurada para GLM 5.3 y Qwen3.8 27B. No dice si el response_format admitido es json_object o json_schema, ni si DeepSeek V4.1 Flash y BroadNet Gemma 4 VL 26B aceptan alguno de los dos. Pruebe ambos con su modelo. Para escribir el esquema, use el generador de JSON Schema. El artículo JSON mode vs. json_schema cubre la reparación y el monitoreo, y la guía de facturas muestra cómo extraer JSON de imágenes.