JSON → OpenAI Structured Output 스키마 & Zod 변환기

OpenAI response_format이나 함수 도구 호출에서 strict: true를 활성화하면 모든 object 노드에 additionalProperties: false를 설정하고 모든 프로퍼티 키를 required 안에 나열해야 합니다.

네. 출력 선택기를 TypeScript Zod로 전환하면 정수와 부동소수점을 자동 추론하는 z.object({...}).strict() 정의가 생성됩니다.

도구 및 응답 스키마는 매 턴마다 입력 토큰으로 과금되지만, 프롬프트 캐싱을 사용하면 반복되는 스키마 프리픽스 비용이 90%~95% 할인됩니다.

제약 디코딩 스키마 컴파일러

유효한 JSON — OpenAI strict:true 준수 (additionalProperties: false 적용됨)

대상 출력 사양

샘플 JSON 페이로드

컴파일된 엄격한 스키마

스키마 토큰 오버헤드 측정

제약 디코딩 불변 조건

OpenAI Structured Outputs는 왜 일반 JSON Schema를 거부하나요?

response_format이나 함수 도구 호출에서 strict: true를 활성화하면 제약 디코딩을 위해 모든 object 노드에 additionalProperties: false를 설정하고 모든 프로퍼티 키를 required에 포함해야 합니다.

.strict()가 활성화된 TypeScript Zod 스키마도 생성할 수 있나요?

네. 대상 출력 사양을 TypeScript Zod로 전환하면 자동 .int() 감지가 포함된 즉시 임포트 가능한 z.object({...}).strict() 코드가 생성됩니다.

엄격한 도구 스키마는 요청당 LLM 토큰 비용에 어떤 영향을 주나요?

도구 정의는 매 호출마다 입력 토큰에 합산됩니다. 컴파일된 스키마를 LLM 토큰 비용 계산기에 붙여넣어 90%~95% 프롬프트 캐싱 절감 효과를 시뮬레이션해 보세요.