OpenAI, Structured Outputs v2 정식 GA — 중첩 스키마·유니온 타입 완전 지원

무엇이 달라졌나

OpenAI Structured Outputs v1은 단순 플랫 스키마에서는 잘 동작했지만, anyOf·oneOf 유니온 타입이나 5단계 이상 중첩 오브젝트에서는 간헐적 포맷 이탈이 발생했다. v2는 내부 컨스트레인드 디코딩 엔진을 전면 재설계해 **스키마 준수율 100%**를 공식 보장한다. 지원 모델은 gpt-4.1·gpt-4.1-mini이며, response_format 파라미터에 "strict": true를 설정하면 v2 엔진이 자동 적용된다.

핵심 신규 기능 3가지

1. 유니온 타입 완전 지원: anyOf로 선언한 다형성 응답(예: TextBlock | ImageBlock | ToolUseBlock)을 모델이 컨텍스트에 맞게 자동 선택하고, 반환 JSON이 선언 타입 중 정확히 하나와 일치함을 보장한다.
2. 재귀 스키마 허용: 트리·그래프 구조처럼 자기 참조 정의($ref)를 최대 10단계까지 허용한다. 예: 폴더-파일 계층, AST 노드 표현.
3. 스키마 캐싱 연동: 동일 스키마를 반복 호출할 경우 서버 측 캐싱이 적용되어 첫 호출 이후 평균 응답 레이턴시가 약 18% 단축된다(OpenAI 내부 벤치마크 기준).

한국 개발자 적용 가이드

마이그레이션 체크리스트

# v1 방식 (여전히 동작, 단 strict 미적용)
response_format = {"type": "json_object"}

# v2 방식 — strict: True 추가
response_format = {
    "type": "json_schema",
    "json_schema": {
        "name": "my_schema",
        "strict": True,
        "schema": { ... }  # anyOf, $ref 포함 가능
    }
}

가격은 기존 gpt-4.1 API 요금과 동일하며, 스키마 캐싱 적중 시 입력 토큰 요금 50% 할인이 별도 적용된다. 정확한 단가는 공식 페이지 참조. NestJS·FastAPI 기반 백엔드에서 Zod·Pydantic 스키마를 JSON Schema로 변환 후 바로 주입하는 패턴이 가장 빠른 적용 경로다.