BroadRouter
Commencer

Sortie structurée (structured output)

Mis à jour

La sortie structurée est une fonction des API LLM qui contraint la réponse d’un modèle à un format défini par le développeur, en général un JSON Schema, pour que le code puisse l’analyser de façon fiable. Elle est plus stricte que le mode JSON, qui garantit un JSON valide mais pas une structure précise.

Aussi appelé : sortie structurée, sorties structurées, sortie JSON Schema, structured output, structured outputs, JSON schema output, response_format

Le code a besoin d’entrées prévisibles. La sortie structurée transforme le texte libre d’un modèle en données auxquelles votre programme peut se fier.

Comment ça marche

Il existe trois niveaux de contrôle :

Méthode Ce que vous obtenez
Le demander dans le prompt Du JSON en général, parfois avec du texte en trop ou des champs manquants
Mode JSON Du JSON valide, de forme quelconque
Sortie structurée avec schéma Du JSON conforme à votre schéma

Dans le format OpenAI, le mode JSON s’écrit response_format: {"type": "json_object"}. La sortie structurée passe un schéma :

"response_format": {
  "type": "json_schema",
  "json_schema": {
    "name": "invoice",
    "strict": true,
    "schema": {
      "type": "object",
      "properties": {
        "vendor": { "type": "string" },
        "total": { "type": "number" }
      },
      "required": ["vendor", "total"],
      "additionalProperties": false
    }
  }
}

Selon la référence d’OpenAI, le type json_schema « ensures the model will match your supplied JSON schema » (traduction : « garantit que le modèle respectera le JSON Schema fourni »). Beaucoup de fournisseurs y parviennent par décodage contraint : à chaque étape, ils restreignent les tokens que le modèle peut produire, si bien qu’une sortie qui enfreint le schéma ne peut pas être générée.

Pourquoi c’est important

  • Moins d’erreurs d’analyse. Les pipelines d’extraction, les classifieurs et les agents peuvent lire les champs directement.
  • Des prompts plus simples. Le schéma remplace de longues consignes de format.
  • Pas une garantie totale. Le guide d’OpenAI indique que votre application doit toujours gérer les refus, les réponses incomplètes et les erreurs. Une réponse tronquée par max_tokens est un JSON cassé, quel que soit le schéma.

La prise en charge varie selon les API compatibles OpenAI. Certaines n’acceptent que json_schema, d’autres que json_object, et d’autres ignorent le champ. Vérifiez avant de vous en remettre à lui.

Sur BroadNet Inference

La documentation de BroadNet mentionne la sortie structurée pour GLM 5.3 et Qwen3.8 27B. Elle ne nomme pas le paramètre de requête : testez donc response_format sur votre modèle, et gardez dans tous les cas un analyseur JSON avec gestion d’erreurs. Le validateur de sortie JSON de LLM montre où une réponse casse et la vérifie par rapport à votre schéma. Les deux modèles raisonnent d’abord : laissez à max_tokens de la place pour la réflexion et pour le JSON.

La sortie structurée se marie bien avec les modèles de vision. Le guide des factures en arabe envoie une image et demande les champs en JSON. Pour des actions plutôt que des réponses, utilisez le tool calling.

Erreurs fréquentes

  • Oublier additionalProperties: false, ou ne pas lister chaque champ dans required, en mode strict.
  • Ne pas vérifier finish_reason avant l’analyse.

Questions fréquentes

Quelle différence entre le mode JSON et la sortie structurée ?

Le mode JSON promet seulement que la réponse s’analyse comme du JSON. La sortie structurée avec un schéma promet aussi les champs, les types et les clés obligatoires que vous avez définis. Le guide d’OpenAI indique que seules les Structured Outputs garantissent le respect du schéma.

Dois-je quand même valider la sortie ?

Oui. Une réponse peut encore être un refus ou être tronquée par max_tokens, et un schéma ne peut pas exprimer toutes les règles métier, comme un total qui doit égaler la somme des lignes.

Faut-il utiliser la sortie structurée ou le tool calling ?

La sortie structurée quand vous voulez la réponse finale dans une forme fixe. Le tool calling quand le modèle doit demander à votre code de faire quelque chose, puis continuer.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity