.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 をローカルで変換・整形
関連エンジニアリングガイド
- JSON から TypeScript・Zod・Pydantic v2 スキーマを自動生成して型安全を確保API の JSON サンプルから TypeScript インターフェース、実行時 Zod バリデータ、Python Pydantic v2 BaseModel を省略可能・エイリアス推論付きで生成。
- TOON vs JSON:LLM プロンプトのトークンコストを 30〜60% 削減TOON 形式が均一配列で重複する JSON キーを排除し、GPT-5・Claude 4・Gemini 2.5 の入力トークンコストを半減させる仕組みを解説します。
- CSV・JSON から有効な LLM ファインチューニング用 JSONL データセットを作成スプレッドシートや JSON 配列から OpenAI Chat・Alpaca・Gemini ファインチューニング用の有効な .jsonl を全行検証付きでローカル生成します。
- なぜサーバー送信型のオンライン整形ツールは危険なのか — ゼロアップロード設計の仕組み.env・JWT・顧客 CSV・契約書を外部変換サイトへ貼る危険性と、DevTools Network タブで送信量 0 バイトを確認できる仕組みを解説します。
関連フォーマット
全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)や前方参照を安全に動作させるためです。