pydantic · Sumered · Jul 1, 2025 · Jul 1, 2025 · Jul 1, 2025 · Jul 1, 2025
diff --git a/pydantic_ai_slim/pydantic_ai/messages.py b/pydantic_ai_slim/pydantic_ai/messages.py
@@ -99,6 +99,13 @@ class FileUrl(ABC):
     * If False, the URL is sent directly to the model and no download is performed.
     """
 
+    vendor_metadata: dict[str, Any] | None = None
+    """Vendor-specific metadata for the file.
+
+    Supported by:
+    - `GoogleModel`: `VideoUrl.vendor_metadata` is used as `video_metadata`: https://ai.google.dev/gemini-api/docs/video-understanding#customize-video-processing
+    """
+
     @property
     @abstractmethod
     def media_type(self) -> str:
@@ -263,6 +270,13 @@ class BinaryContent:
     media_type: AudioMediaType | ImageMediaType | DocumentMediaType | str
     """The media type of the binary data."""
 
+    vendor_metadata: dict[str, Any] | None = None
+    """Vendor-specific metadata for the file.
+
+    Supported by:
+    - `GoogleModel`: `BinaryContent.vendor_metadata` is used as `video_metadata`: https://ai.google.dev/gemini-api/docs/video-understanding#customize-video-processing
+    """
+
     kind: Literal['binary'] = 'binary'
     """Type identifier, this is available on all parts as a discriminator."""
 

diff --git a/pydantic_ai_slim/pydantic_ai/models/google.py b/pydantic_ai_slim/pydantic_ai/models/google.py
@@ -55,6 +55,7 @@
         GenerateContentConfigDict,
         GenerateContentResponse,
         HttpOptionsDict,
+        MediaResolution,
         Part,
         PartDict,
         SafetySettingDict,
@@ -121,6 +122,12 @@ class GoogleModelSettings(ModelSettings, total=False):
     See the [Gemini API docs](https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal/add-labels-to-api-calls) for use cases and limitations.
     """
 
+    google_video_resolution: MediaResolution
+    """The video resolution to use for the model.
+
+    See <https://ai.google.dev/api/generate-content#MediaResolution> for more information.
+    """
+
 
 @dataclass(init=False)
 class GoogleModel(Model):
@@ -292,6 +299,7 @@ async def _generate_content(
             safety_settings=model_settings.get('google_safety_settings'),
             thinking_config=model_settings.get('google_thinking_config'),
             labels=model_settings.get('google_labels'),
+            media_resolution=model_settings.get('google_video_resolution'),
             tools=cast(ToolListUnionDict, tools),
             tool_config=tool_config,
             response_mime_type=response_mime_type,
@@ -399,9 +407,15 @@ async def _map_user_prompt(self, part: UserPromptPart) -> list[PartDict]:
                 elif isinstance(item, BinaryContent):
                     # NOTE: The type from Google GenAI is incorrect, it should be `str`, not `bytes`.
                     base64_encoded = base64.b64encode(item.data).decode('utf-8')
-                    content.append({'inline_data': {'data': base64_encoded, 'mime_type': item.media_type}})  # type: ignore
+                    inline_data_dict = {'inline_data': {'data': base64_encoded, 'mime_type': item.media_type}}
+                    if item.vendor_metadata:
+                        inline_data_dict['video_metadata'] = item.vendor_metadata
+                    content.append(inline_data_dict)  # type: ignore
                 elif isinstance(item, VideoUrl) and item.is_youtube:
-                    content.append({'file_data': {'file_uri': item.url, 'mime_type': item.media_type}})
+                    file_data_dict = {'file_data': {'file_uri': item.url, 'mime_type': item.media_type}}
+                    if item.vendor_metadata:
+                        file_data_dict['video_metadata'] = item.vendor_metadata
+                    content.append(file_data_dict)  # type: ignore
                 elif isinstance(item, FileUrl):
                     if self.system == 'google-gla' or item.force_download:
                         downloaded_item = await download_item(item, data_format='base64')

diff --git a/tests/models/cassettes/test_google/test_google_model.yaml b/tests/models/cassettes/test_google/test_google_model.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_document_url_input.yaml b/tests/models/cassettes/test_google/test_google_model_document_url_input.yaml
@@ -292,7 +292,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_empty_user_prompt.yaml b/tests/models/cassettes/test_google/test_google_model_empty_user_prompt.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_image_as_binary_content_input.yaml b/tests/models/cassettes/test_google/test_google_model_image_as_binary_content_input.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_image_url_input.yaml b/tests/models/cassettes/test_google/test_google_model_image_url_input.yaml
@@ -612,7 +612,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_instructions.yaml b/tests/models/cassettes/test_google/test_google_model_instructions.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_iter_stream.yaml b/tests/models/cassettes/test_google/test_google_model_iter_stream.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:
@@ -86,7 +86,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:
@@ -173,7 +173,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_max_tokens.yaml b/tests/models/cassettes/test_google/test_google_model_max_tokens.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_multiple_documents_in_history.yaml b/tests/models/cassettes/test_google/test_google_model_multiple_documents_in_history.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_retry.yaml b/tests/models/cassettes/test_google/test_google_model_retry.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:
@@ -92,7 +92,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_safety_settings.yaml b/tests/models/cassettes/test_google/test_google_model_safety_settings.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_stream.yaml b/tests/models/cassettes/test_google/test_google_model_stream.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_structured_output.yaml b/tests/models/cassettes/test_google/test_google_model_structured_output.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:
@@ -124,7 +124,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_text_as_binary_content_input.yaml b/tests/models/cassettes/test_google/test_google_model_text_as_binary_content_input.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_text_document_url_input.yaml b/tests/models/cassettes/test_google/test_google_model_text_document_url_input.yaml
@@ -73,7 +73,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_thinking_config.yaml b/tests/models/cassettes/test_google/test_google_model_thinking_config.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_thinking_part.yaml b/tests/models/cassettes/test_google/test_google_model_thinking_part.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_thinking_part_iter.yaml b/tests/models/cassettes/test_google/test_google_model_thinking_part_iter.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_top_p.yaml b/tests/models/cassettes/test_google/test_google_model_top_p.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_vertex_labels.yaml b/tests/models/cassettes/test_google/test_google_model_vertex_labels.yaml
@@ -12,7 +12,7 @@ interactions:
       - '268'
       content-type:
       - application/x-www-form-urlencoded
-    method: POST
+    method: post
     uri: https://oauth2.googleapis.com/token
   response:
     headers:
@@ -57,7 +57,7 @@ interactions:
       - application/json
       host:
       - us-central1-aiplatform.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_vertex_provider.yaml b/tests/models/cassettes/test_google/test_google_model_vertex_provider.yaml
@@ -12,7 +12,7 @@ interactions:
       - '268'
       content-type:
       - application/x-www-form-urlencoded
-    method: POST
+    method: post
     uri: https://oauth2.googleapis.com/token
   response:
     headers:
@@ -57,7 +57,7 @@ interactions:
       - application/json
       host:
       - us-central1-aiplatform.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_video_as_binary_content_input.yaml b/tests/models/cassettes/test_google/test_google_model_video_as_binary_content_input.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_model_video_url_input.yaml b/tests/models/cassettes/test_google/test_google_model_video_url_input.yaml
@@ -11115,7 +11115,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_native_output.yaml b/tests/models/cassettes/test_google/test_google_native_output.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_native_output_multiple.yaml b/tests/models/cassettes/test_google/test_google_native_output_multiple.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_prompted_output.yaml b/tests/models/cassettes/test_google/test_google_prompted_output.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_prompted_output_multiple.yaml b/tests/models/cassettes/test_google/test_google_prompted_output_multiple.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:

diff --git a/tests/models/cassettes/test_google/test_google_prompted_output_with_tools.yaml b/tests/models/cassettes/test_google/test_google_prompted_output_with_tools.yaml
@@ -13,7 +13,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts:
@@ -90,7 +90,7 @@ interactions:
       - application/json
       host:
       - generativelanguage.googleapis.com
-    method: POST
+    method: post
     parsed_body:
       contents:
       - parts: