response_format 설정
JSON 모드는 간단한 객체에 유용합니다. JSON Schema에는 스키마 이름, 필드 구조, 필수 속성 및 추가 속성을 거부하는 방법이 더해집니다.
엄격한 스키마는 방어적 파싱을 줄이지만 애플리케이션 측 검증을 대신할 수는 없습니다.
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
}
}
}
}스키마 설계
- 필드와 설명은 간결하고 도메인에 맞게 작성하세요.
- 알 수 없는 필드를 허용하지 않는 곳에서는 additionalProperties: false를 설정하세요.
- 스키마를 사용하는 시스템이 의존하는 계약을 알리지 않고 변경하지 말고, 자체 코드에서 스키마 버전을 관리하세요.
결과 처리
API 또는 데이터베이스에서 사용하는 것과 같은 검증기로 반환된 JSON을 검증하세요.
모델이나 경로가 요청한 형식을 허용하지 않으면 제어된 오류를 표시하고 모델 카탈로그를 통해 호환 옵션을 선택하세요.