구조화된 출력
응답을 JSON이나 지정한 JSON Schema 형식으로 받는 방법입니다. 아래 예시와 파라미터는 Chat Completions API 기준이며, Responses API와 Messages API에서의 차이는 각 API 문서에 있습니다.
요청 파라미터
response_format object 응답 형식 지정 텍스트 (기본) JSON 모드 JSON 스키마 기본 텍스트 응답에는 response_format 을 보내지 않습니다. 선택한 모델의 response_format_modes 와 제공사별 mode를 확인해 json_object 를 지원하는 제공사로 보냅니다. 선택한 모델의 response_format_modes 와 제공사별 mode에서 json_schema 를 지원하는지 확인하고, 클라이언트에서도 최종 응답을 schema로 검증하십시오. 모델별 mode를 먼저 확인합니다 GET /v1/models 의 models[].response_format_modes 가 그 모델을 제공하는 제공사들 가운데 하나 이상에서 확인된 mode를 모두 모은 값입니다. 제공사를 지정하면 provider_response_format_modes 의 해당 제공사 값을 확인하십시오. Anthropic 모델은 json_schema 만 지원하며, json_object 요청은 Provider 호출 전에 400으로 거부됩니다.
지원하지 않는 mode 오류
JSON Schema 호환성 확인 지원 keyword는 Provider와 모델에 따라 달라질 수 있습니다. 아래 항목은 일반적으로 확인해야 하는 제약입니다. 모든 속성은 required 에 나열되어야 합니다 anyOf , oneOf 는 OpenAI에서 미지원 문자열 format (DateTime, Uri 등) 미지원 최상위 객체는 anyOf 타입 불가