From 66bfe956f7a8b6c8d7c7eb949a9b6a499a4e2860 Mon Sep 17 00:00:00 2001
From: Google Team Member <genai-sdk-bot@google.com>
Date: Tue, 11 Aug 2026 09:39:38 -0700
Subject: [PATCH] perf: build model validators on first use instead of at
 import

Close #2784

PiperOrigin-RevId: 962831329
---
 google/genai/_common.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/google/genai/_common.py b/google/genai/_common.py
index f4a6984f7..3bcfe2ebc 100644
--- a/google/genai/_common.py
+++ b/google/genai/_common.py
@@ -559,6 +559,11 @@ class BaseModel(pydantic.BaseModel):
       ser_json_bytes='base64',
       val_json_bytes='base64',
       ignored_types=(typing.TypeVar,),
+      # Build each model's validator and serializer on first use rather than
+      # at import. `types` defines several hundred models and any one caller
+      # touches a small fraction of them, so building them all up front is
+      # most of what importing this package costs.
+      defer_build=True,
   )
 
   @pydantic.model_validator(mode='before')