BroadRouter
Commencer

Mode JSON (JSON mode)

Mis à jour

Le mode JSON est un réglage des API de LLM, response_format {"type": "json_object"} dans les API de style OpenAI, qui fait de la réponse du modèle un JSON valide et analysable. Contrairement aux Structured Outputs avec un JSON Schema, il ne garantit pas les clés, les types ni les valeurs de l’objet.

Aussi appelé : mode JSON, sortie JSON, réponse en JSON, json_object, JSON mode, JSON output mode, JSON response mode

Le mode JSON répond à une question : json.loads() va-t-il réussir ? Il ne répond pas à la seconde : est-ce bien l’objet qu’attend mon code ?

Comment ça marche

Dans l’API Chat Completions, un seul champ suffit pour l’activer :

{"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 référence de l’API d’OpenAI le décrit comme « the older JSON mode, which ensures the message the model generates is valid JSON » (traduction : « l’ancien mode JSON, qui garantit que le message généré par le modèle est un JSON valide »). Deux règles l’accompagnent. Vous devez demander du JSON dans un message : selon le guide d’OpenAI, l’API « will throw an error if the string ‘JSON’ does not appear somewhere in the context » (traduction : « renverra une erreur si la chaîne “JSON” n’apparaît nulle part dans le contexte »). Et la forme est laissée au modèle. Le guide précise que le mode JSON « will not guarantee the output matches any specific schema » (traduction : « ne garantit pas que la sortie corresponde à un schéma précis »).

La sortie structurée est l’option la plus stricte. Elle transmet un JSON Schema avec {"type": "json_schema", ...}, et le modèle est contraint de le suivre.

Mode JSON (json_object) Structured Outputs (json_schema)
JSON valide oui oui
Clés et types obligatoires non oui
Vous fournissez un schéma non oui
« JSON » doit figurer dans le prompt oui (OpenAI) non

OpenAI recommande d’« always using Structured Outputs instead of JSON mode when possible » (traduction : « toujours utiliser les Structured Outputs plutôt que le mode JSON quand c’est possible »).

Pourquoi c’est important

  • La validation reste à votre charge. En mode JSON, une clé manquante ou un nombre envoyé sous forme de chaîne passe le parsing et échoue plus tard. Validez par rapport à un schéma dans votre code.
  • Troncature. Si la réponse atteint max_tokens, le JSON est incomplet. Les modèles de raisonnement y sont plus exposés, car la réflexion consomme le même budget.
  • Solution de repli. Le guide d’OpenAI cite le mode JSON pour les anciens modèles où json_schema n’est pas disponible. La prise en charge varie selon le fournisseur et le modèle : quand aucun schéma n’est accepté, le mode JSON plus votre propre validation sert de repli.

Sur BroadNet Inference

La référence de l’API de BroadNet indique la sortie structurée pour GLM 5.3 et Qwen3.8 27B. Elle ne précise pas si le response_format pris en charge est json_object ou json_schema, ni si DeepSeek V4.1 Flash et BroadNet Gemma 4 VL 26B acceptent l’un ou l’autre. Testez les deux sur votre modèle. Pour rédiger le schéma, utilisez le générateur de JSON Schema. L’article mode JSON ou json_schema traite de la réparation et du suivi, et le guide des factures montre l’extraction de JSON à partir d’images.

Questions fréquentes

Le mode JSON est-il la même chose que les Structured Outputs ?

Non. Le guide d’OpenAI indique que les deux produisent du JSON valide, mais que seuls les Structured Outputs garantissent le respect du schéma. Le mode JSON peut renvoyer n’importe quel objet valide.

Pourquoi le mode JSON renvoie-t-il une erreur à propos du mot JSON ?

OpenAI exige que l’instruction de produire du JSON figure quelque part dans les messages, et renvoie une erreur si la chaîne « JSON » n’apparaît pas dans le contexte.

Le mode JSON peut-il quand même renvoyer du JSON cassé ?

Oui, si la réponse est coupée par max_tokens ou par la limite de contexte. Vérifiez finish_reason avant le parsing.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity