OpenAI, Structured Outputs v2 정식 GA—스키마 복잡도 제한 대폭 완화
OpenAI가 Structured Outputs v2를 정식 출시하며 중첩 객체 깊이 제한을 기존 5단계에서 20단계로 확장하고, 재귀 스키마 및 순환 참조를 공식 지원한다. 복잡한 도메인 모델을 JSON으로 직접 추출해야 하는 한국 개발자에게 프로덕션 안정성이 크게 향상될 전망이다.
무엇이 바뀌었나
OpenAI Structured Outputs v2는 기존 버전의 핵심 제약을 세 가지 축으로 완화했다.
- 중첩 깊이: 5단계 → 20단계로 확장, 트리 형태의 복잡한 AST·문서 구조 직접 매핑 가능
- 재귀 스키마:
$ref를 통한 자기 참조 타입을 공식 지원—TreeNode { children: TreeNode[] }같은 패턴이 별도 전처리 없이 동작 - 유니언 타입 확장:
anyOf내 허용 타입 수가 3개 → 20개로 늘어나 다형성 응답 모델 설계가 수월해짐
지원 모델은 gpt-4.1, gpt-4.1-mini, o3, o4-mini이며 API 파라미터 변경 없이 기존 response_format: { type: "json_schema" } 구문을 그대로 사용한다.
한국 개발자·크리에이터 실전 활용 포인트
1. 법률·계약 문서 파싱 한국 표준 계약서의 조항 → 하위조항 → 세부항목 구조는 실제 7~10단계 중첩이 일반적이다. v2에서는 단일 스키마로 전체 트리를 캡처할 수 있어 후처리 코드량이 줄어든다.
2. 코드 분석 에이전트 AST를 JSON으로 직렬화할 때 재귀 노드 참조가 필수인데, 기존에는 별도 평탄화 로직이 필요했다. v2 재귀 스키마 지원으로 파이프라인 단순화가 가능하다.
3. 멀티모달 콘텐츠 분류 유니언 20종 확장 덕분에 이미지·텍스트·영상·음성 메타데이터를 단일 스키마로 분기 처리하는 크리에이터 도구 백엔드 설계가 현실적이다.
# 재귀 스키마 예시 (v2 신규 지원)
schema = {
"type": "object",
"$defs": {
"Node": {
"type": "object",
"properties": {
"label": {"type": "string"},
"children": {
"type": "array",
"items": {"$ref": "#/$defs/Node"}
}
},
"required": ["label", "children"]
}
},
"$ref": "#/$defs/Node"
}
가격 및 마이그레이션
Structured Outputs v2 사용에 따른 추가 요금은 없다. 기존 v1 호출은 자동으로 v2 엔진으로 라우팅되며 하위 호환성이 보장된다. 단, 재귀 스키마를 처음 사용하는 경우 OpenAI Playground의 Schema Validator 탭에서 사전 검증 후 배포를 권장한다. 토큰 단가는 공식 페이지 참조.