Leçon 2 sur 3 · 8 minutes

Obtenir une sortie structurée

Envoyez un JSON Schema pour que le modèle renvoie du JSON dans votre forme, puis validez-le avant de l’utiliser.

Envoyez un JSON Schema avec la requête et le modèle renvoie du JSON dans cette forme au lieu de texte libre. Utilisez-le quand vous voulez récupérer des données, comme des champs extraits d’un e-mail. Utilisez l’appel d’outils quand vous voulez que le modèle demande à votre application de faire quelque chose.

typeCe que vous obtenez
json_schemaDu JSON conforme à votre schéma. À utiliser par défaut.
json_objectUn objet JSON valide, sans forme imposée.
textDu texte brut (par défaut).

Le format se place dans response_format sur /v1/chat/completions, dans text.format sur /v1/responses et dans output_config.format sur /v1/messages (json_schema uniquement).

{
  "model": "openai/gpt-6-astra",
  "messages": [
    { "role": "user", "content": "Return the city and weather for London." }
  ],
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "weather",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "city": { "type": "string" },
          "weather": { "type": "string" }
        },
        "required": ["city", "weather"],
        "additionalProperties": false
      }
    }
  }
}

Le JSON revient sous forme de chaîne dans le contenu du message. Avant de l’analyser, vérifiez qu’il n’y a pas de refus, de contenu manquant ou de finish_reason autre que stop. Validez ensuite l’objet analysé, par exemple avec Zod. Si la validation échoue, réessayez une fois avec l’erreur dans le prompt, puis renvoyez un échec maîtrisé. Chaque nouvelle tentative est facturée, et un JSON valide ne prouve pas que les valeurs sont justes.

Phaseo ne supprime jamais response_format. Il ne route une requête json_schema que vers des fournisseurs qui prennent en charge les sorties structurées ; si aucun fournisseur du modèle ne le fait, la requête échoue avec 400 validation_error. Les pages de modèles signalent cette prise en charge avec structured_outputs, qui est un indicateur de capacité, pas un champ de requête.

Vérifiez votre compréhension

Vous envoyez response_format avec json_schema à un modèle dont les fournisseurs ne prennent pas en charge les sorties structurées. Que se passe-t-il ?

Mettez-le en pratique

Votre analyseur de factures utilise json_schema, et de temps en temps la réponse échoue à votre vérification Zod parce que total manque. Que doit faire le code ?

Afficher la réponse

Vérifiez d’abord que finish_reason vaut stop, car une réponse tronquée ne peut pas être valide. Réessayez ensuite une fois avec l’erreur de validation dans le prompt, et si cela échoue encore, renvoyez un échec maîtrisé au lieu de deviner. Suivez les échecs par modèle et par version de schéma pour remarquer quand l’un ou l’autre change les choses en pire.

À retenir

Utilisez json_schema pour les données dont vous avez besoin dans une forme fixe, et validez toujours le résultat dans votre propre code avant de lui faire confiance.

Liens utiles

La progression est enregistrée dans ce navigateur.

Dernière vérification le 17 novembre 2026