BroadRouter
Comenzar

JSON mode (modo JSON)

Actualizado

El modo JSON (JSON mode) es un ajuste de las APIs de LLM, response_format {"type": "json_object"} en las APIs al estilo de OpenAI, que hace que la respuesta del modelo sea JSON válido y procesable. A diferencia de la salida estructurada con un JSON Schema, no garantiza qué claves, tipos o valores contiene el objeto.

También llamado: modo JSON, salida en JSON, respuesta en JSON, json_object, JSON mode, JSON output mode, JSON response mode

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_schema no 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.

Preguntas frecuentes

¿El modo JSON es lo mismo que la salida estructurada?

No. La guía de OpenAI dice que ambos producen JSON válido, pero solo Structured Outputs garantiza el cumplimiento del esquema. El modo JSON puede devolver cualquier objeto válido.

¿Por qué el modo JSON devuelve un error sobre la palabra JSON?

OpenAI exige que en algún mensaje se pida producir JSON, y devuelve un error si la cadena "JSON" no aparece en el contexto.

¿El modo JSON puede devolver JSON roto?

Sí, si la respuesta se corta por max_tokens o por el límite de contexto. Revise finish_reason antes de procesarla.

Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity