OpenAI, Structured Outputs Strict 모드 모든 모델 전면 지원

무엇이 달라졌나

OpenAI는 2026년 9월 19일부로 response_format에 strict: true 플래그를 설정하면 모든 현행 API 모델에서 JSON Schema 완전 준수를 강제하는 기능을 정식 GA로 전환했다. 기존에는 일부 모델에서만 지원되거나 베타 제한이 있었고, Schema 이탈 시 파싱 오류가 런타임에 발생해 재시도 로직을 별도로 구현해야 했다.

주요 변경 사항:

• 지원 모델 확대: gpt-4.1, gpt-4.1-mini, o3, o3-mini 전 버전에서 strict: true 사용 가능
• Schema 제약 자동 검증: additionalProperties: false 강제, required 누락 필드 시 400 오류 반환
• 스트리밍 호환: stream: true와 병행 사용 시에도 청크 단위 Schema 검증 적용
• Function Calling 통합: tools 파라미터의 함수 파라미터 Schema에도 동일 Strict 모드 적용

한국 개발자·크리에이터 실무 적용 포인트

타입스크립트 프로젝트에서 zod 스키마를 openai의 zodResponseFormat 헬퍼로 변환하면 런타임 검증 코드를 완전히 제거할 수 있다.

import { zodResponseFormat } from "openai/helpers/zod";
import { z } from "zod";

const ArticleSchema = z.object({
  title: z.string(),
  tags: z.array(z.string()).max(5),
  readTimeMinutes: z.number().int().positive(),
});

const response = await openai.beta.chat.completions.parse({
  model: "gpt-4.1",
  messages: [{ role: "user", content: "뉴스 메타데이터를 생성해줘" }],
  response_format: zodResponseFormat(ArticleSchema, "article"),
});

// response.choices[0].message.parsed는 완전한 타입 보장
const article = response.choices[0].message.parsed;

Python 프로젝트에서는 pydantic 모델을 직접 response_format에 전달하면 동일하게 동작한다. 기존 json.loads + 수동 키 확인 패턴을 제거하면 평균 코드 30~50줄 절감 효과를 기대할 수 있다.

주의 사항: strict: true 모드에서는 Schema에 oneOf, anyOf 같은 일부 고급 JSON Schema 키워드가 제한된다. Union 타입이 필요하면 enum 또는 discriminator 패턴으로 대체해야 한다.

비용 및 성능 영향

Strict 모드 자체에 대한 추가 과금은 없으며, 입출력 토큰 단가는 기존과 동일하다(공식 페이지 참조). 다만 Schema 검증 실패로 400 오류가 반환될 경우 해당 요청은 과금되지 않는다. 내부 벤치마크 기준 Schema 준수율은 기존 json_object 모드 대비 오류 발생률 약 94% 감소로 OpenAI가 공식 발표했다. 응답 지연(latency)은 모델·Schema 복잡도에 따라 최대 5~10% 증가할 수 있으나, 재시도 왕복 비용을 제거하면 전체 파이프라인 지연은 오히려 단축된다.