.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 における構造化出力スキーマの標準形式
  • snake_case の Python 属性名と Field(alias=...) によるマッピングを両立
  • Pydantic v2 の Rust 製コアにより従来比で桁違いに高速な JSON パースを実現

注意点・トレードオフ

  • v1 と v2 で API が異なる(model_validate vs. parse_obj)
  • Python 予約語や camelCase キーを扱うには Field(alias=...) 指定が必要
  • 循環参照や前方参照には from __future__ import annotations が必要

参考文献

Pydantic v2 をローカルで変換・整形

関連エンジニアリングガイド

関連フォーマット

全24形式を見る

Pydantic v2 に関するよくある質問

JSON to Pydantic は userId のような camelCase キーをどう処理しますか?

PEP 8 に準拠した snake_case(user_id)へ変換しつつ Field(alias="userId") を自動付与するため、受信 JSON をそのままデシリアライズできます。

ネストされた JSON オブジェクトは個別の Python クラスに分離されますか?

はい。ネスト構造はルートモデルの上位に独立した BaseModel クラスとして整理して生成されます。

出力に from __future__ import annotations を含める理由は何ですか?

Python 3.9 以降の環境で PEP 604 のユニオン記法(str | None)や前方参照を安全に動作させるためです。