Passer au contenu principal
Envoyez un JSON Schema avec la requête : le modèle renvoie du JSON de cette forme au lieu d’un texte libre. Votre code doit quand même l’analyser et le valider avant de l’utiliser.

Choisir un format

L’emplacement du format dépend du point de terminaison :

Envoyer un schéma

Le JSON revient sous forme de chaîne dans le contenu du message :

Concevoir le schéma

Commencez par un petit objet. Listez chaque champ dans required, utilisez enum pour les catégories connues et définissez additionalProperties: false quand les clés supplémentaires doivent être rejetées. Versionnez le schéma avec votre validateur côté serveur pour qu’ils ne divergent jamais.

Valider le résultat

Avant l’analyse, vérifiez s’il y a un refus, un contenu manquant ou une réponse tronquée (finish_reason différent de stop). Validez ensuite l’objet analysé. Ce validateur Zod correspond au schéma ci-dessus :
Si la validation échoue, réessayez une fois avec l’erreur dans le prompt, puis renvoyez un échec sûr. Chaque nouvelle tentative est facturée. Un JSON valide ne prouve ni que les valeurs sont exactes, ni qu’une action est autorisée. Suivez les échecs de validation par modèle et par version du schéma, et relancez vos cas d’évaluation quand l’un ou l’autre change. Pour réparer automatiquement un JSON mal formé, consultez la réparation des réponses.
Dernière modification le 5 novembre 2026