response_format instellen
JSON-modus is nuttig voor een eenvoudig object. JSON Schema voegt een schemanaam, veldstructuur, verplichte eigenschappen en een manier om extra eigenschappen te weigeren toe.
Een strikt schema vermindert defensief parsen, maar vervangt nooit validatie aan de toepassingszijde.
Antwoordindeling met JSON Schema
json
{
"model": "openai/gpt-5.6-sol",
"messages": [{"role": "user", "content": "Extract an order summary."}],
"response_format": {
"type": "json_schema",
"json_schema": {
"name": "order_summary",
"strict": true,
"schema": {
"type": "object",
"properties": {"items": {"type": "array"}, "total": {"type": "number"}},
"required": ["items", "total"],
"additionalProperties": false
}
}
}
}Het schema ontwerpen
- Houd velden en beschrijvingen beknopt en domeinspecifiek.
- Stel additionalProperties: false in wanneer onbekende velden niet zijn toegestaan.
- Versioneer schema's in uw eigen code in plaats van een contract met afnemers onzichtbaar te wijzigen.
Het resultaat verwerken
Valideer de geretourneerde JSON met dezelfde validator die uw API of database gebruikt.
Als een model of route de gevraagde indeling niet accepteert, toon dan een beheerste fout en selecteer via de modelcatalogus een compatibele optie.