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_scheman’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.