Ustaw response_format
Tryb JSON jest przydatny dla prostego obiektu. JSON Schema dodaje nazwę schematu, strukturę pól, wymagane właściwości i sposób odrzucania dodatkowych właściwości.
Ścisły schemat ogranicza potrzebę defensywnej analizy, ale nigdy nie zastępuje walidacji po stronie aplikacji.
Format odpowiedzi 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
}
}
}
}Zaprojektuj schemat
- Pola i opisy powinny być zwięzłe oraz właściwe dla danej dziedziny.
- Ustaw additionalProperties: false tam, gdzie nieznane pola są niedopuszczalne.
- Wersjonuj schematy we własnym kodzie, zamiast niewidocznie zmieniać kontrakt odbiorcy.
Obsłuż wynik
Sprawdź zwrócony JSON za pomocą tego samego walidatora, którego używa Twoje API lub baza danych.
Jeśli model lub ścieżka nie przyjmuje żądanego formatu, pokaż kontrolowany błąd i wybierz zgodną opcję przez katalog modeli.