.py · text/x-python

Pydantic v2: Python Pydantic v2 BaseModel 클래스

Pydantic v2 모델은 Python 타입 힌트와 BaseModel 클래스(camelCase JSON 키용 Field 별칭 포함)를 사용해 Rust 기반 초고속 검증을 제공합니다.

빠른 답변: Pydantic v2 모델은 Python 타입 힌트와 BaseModel 클래스(camelCase JSON 키용 Field 별칭 포함)를 사용해 Rust 기반 초고속 검증을 제공합니다. FastAPI 엔드포인트, Python LLM 구조화 출력 및 Python 3.10+ 환경의 엄격한 데이터 검증.

구조 유형타입 코드
사람 가독성높음
중첩 지원지원
LLM 토큰 효율보통
파일 확장자.py
MIME 유형text/x-python
추천 용도FastAPI 엔드포인트, Python LLM 구조화 출력 및 Python 3.10+ 환경의 엄격한 데이터 검증.

장점

  • FastAPI, OpenAI 및 LangGraph에서 구조화 출력 스키마의 표준으로 사용
  • Field(alias=...) 매핑을 통해 파이썬다운 snake_case 필드명 유지
  • Pydantic v2의 Rust 코어 검증 엔진이 JSON 페이로드를 매우 빠르게 파싱

단점 및 주의사항

  • Pydantic v1과 v2 API 문법이 서로 다름 (model_validate vs parse_obj)
  • Python 예약어나 camelCase JSON 키에는 Field(alias=...) 지정이 필요함
  • 순환 참조 및 전방 참조에는 from __future__ import annotations 필요

참고 자료

Pydantic v2 로컬 변환 및 정리 도구

관련 엔지니어링 가이드

Pydantic v2 자주 묻는 질문

JSON to Pydantic은 userId 같은 camelCase JSON 키를 어떻게 변환하나요?

PEP 8 규약에 맞는 snake_case(user_id)로 바꾸고 Field(alias="userId")를 자동 부착하여 Pydantic v2가 camelCase JSON을 매끄럽게 파싱합니다.

중첩된 JSON 객체는 별도의 Python 클래스로 분리되나요?

네. 중첩 구조는 루트 모델 위쪽에 순서대로 정리된 독립 BaseModel 클래스로 자동 호이스팅됩니다.

Pydantic v2 출력에 from __future__ import annotations를 포함하는 이유는?

Python 3.9 이상 환경에서 최신 PEP 604 유니온 문법(str | None)과 전방 참조를 오류 없이 안정적으로 지원하기 위해서입니다.