v1.74.0

1.74.0 (2026-04-29)

Features

• [Interactions] Add FileCitation.{custom_metadata,media_id,page_number} (aed41ec)
• Add output_info to BatchJob (7b77ab8)
• Add gemini-3.1-flash-tts-preview model to options (8bdc1c3)
• Add ImageResizeMode for GenerateVideos (317d2af)
• Add new Gemini Deep Research agent models (16fffbd)
• Add one_of support to JSONSchema for Agent Platform (8c00c52)
• Add Vertex Dataset input and output options for batch jobs (d880f92)
• interaction-api: Add grounding tool usage breakdown to Interaction Usage. (b24fb5a)
• Introduce enterprise to Client constructor and GOOGLE_GENAI_USE_ENTERPRISE (693fd9a)
• Replace the more ambiguous rate field with sample_rate. (88d9b4a)

Bug Fixes

• Catch google-auth wrapped errors (48ac850)
• Removing Python 3.9 support due to EOL (8bc2b10)
• retry: Retry on httpx.TimeoutException with HttpRetryOptions (#2345) (0598bab)
• Streaming method doesn't handle multi-line SSE (f8a2e7e)
• Typing in AsyncClient.__aexit__, __exit__. (a74dc65)

Documentation

• Add instruction for custom endpoint (dd79904)
• Fix broken link for rate limits (d22ea99)
• Regenerate docs for 1.73.1 (2fb714b)
• Remove duplicate line in genai client docstring. (b1c6026)
• Replace Vertex AI with Gemini Enterprise Agent Platform (7c1ecd5)
• Update doc string to replace Vertex AI with Gemini Enterprise Agent Platform, update method error message to replace Vertex AI with Gemini Enterprise Agent Platform (previously known as Vertex AI), update converter error message to replace Vertex AI with Gemini Enterprise Agent Platform (413f0f9)
• Update Gemini Enterprise Agent Platform home page url (b02cb95)
• Update README.md with correct Pydantic link (fa97cc6)
• Update README.md with correct Pydantic link (fa97cc6)

v1.73.1

1.73.1 (2026-04-14)

Bug Fixes

• Refactor Webhook types in GenAI SDKs for easier useage (3f36ca1)
• Rename webhooks.retrieve to webhooks.get. (649f4b0)

Documentation

• Update python docs for 1.73.0 (acd3767)

v1.73.0

1.73.0 (2026-04-13)

Caution

CRITICAL WARNING: Do not use this version if you are implementing or relying on webhooks. This release contains known issues regarding webhook sdk. Please use v1.73.1 or later.

Features

• Add DeepResearchAgentConfig fields (ec8ca87)
• Add webhook and webhookConfig for js and python sdk (ccec350)
• Add webhook_config to batches.create() and models.generate_videos() (772d2fc)
• Wire the webhook into python and js client. (841bf22)

Bug Fixes

• Refine Pyink blank line insertion logic and fix range-based formatting regressions. (b91bda5)

Documentation

• Update python docs for 1.72.0 (68ed088)

v1.72.0

1.72.0 (2026-04-09)

Features

• Add "eu" as a supported service location for Vertex AI platform. (888a731)
• Add Live Avatar new fields (ad1777e)
• Add support for new audio MIME types: opus, alaw, and mulaw (74eb373)
• Add the delete method for the Agent Engine Task Store Service (d821082)

Documentation

• Update python docs for 1.71.0 (e82f9fc)

v1.71.0

1.71.0 (2026-04-08)

Features

• Introduce TYPE_L16 audio content and optional fields. (07e932f)

Documentation

• Remove deprecated product recontext model samples from docstrings (aca7dcf)

v1.70.0

1.70.0 (2026-03-31)

Features

• Support dedicated TextAnnotationDelta for streaming tool responses (5c820f2)

Bug Fixes

• Fix service_tier enums. (855e431)

v1.69.0

1.69.0 (2026-03-27)

Features

• Add consent_audio and voice_consent_signature and AsyncSession.setup_complete (69a02c4)
• Add custom_metadata to FileSearchResult. (aed1559)
• Add labels field to Veo configs (208a173)
• Add mime type for Audio content (674b837)
• Add model_status to GenerateContentResponse (Gemini API only) (ce86f2b)
• Add part_metadata in Part (Gemini API only) (ce86f2b)
• Add service tier for interactions. (b07002e)
• Add service tier to GenerateContent. (12b404b)
• Add support for more image and audio MIME types in Interactions content (8ec977c)
• Add supported models to the ModelOptions (1ccad7b)
• Autoenable mTLS in environment with bound token (Agent Engine with AgentAuthority) through google-auth migration (except custom client args, custom client or custom ClientSession) (a95d08a)
• genai: Add TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO to TurnCoverage (1ba8e2e)
• Support hyperparameters in distillation tuning (ad38e3a)
• Support rendered_parts in GroundingSupport (ce86f2b)

Bug Fixes

• Support us region routing (8e3e00c)

Documentation

• Update python docs for 1.68. (07ae1b1)

v1.68.0

1.68.0 (2026-03-17)

Breaking changes

• [Interactions] Breaking change to Interactions API to refactor TextContent annotations to use specific citation types (6c3379f)
• [Interactions] Breaking change for Interactions, rename ContentDelta unions. (1b03909)
• [Interactions] Breaking change to Interactions API to rename rendered_content to search_suggestions (0e21c4e)

Features

• [Interactions] Add and update 'signature' fields for tool call/result content types. (d896373)
• [Interactions] Support Google Maps in Interactions (68f247c)
• Support include_server_side_tool_invocations for genai. (546440c)

Bug Fixes

• deps: Correct typing-extensions constraint (1.67 Issue)[https://github.com/googleapis/python-genai/releases/tag/v1.67.0] (9a4fd39)
• Python 3.10-3.11 breakage caused by #2131 (9a4fd39)
• Treat attempts=0 as attempts=1 in retry options to ensure no retries (2856c0a)

Documentation

• Regenerate docs for 1.67.0 (ff7469a)

v1.67.0

1.67.0 (2026-03-12)

Caution

Known Issue:
This release contains a bug where the typing-extensions lower bound is set too low, which causes the SDK to break in some environments.

Recommended Actions:

• Fall back to 1.66.0: If you do not immediately need the new features in 1.67.0, we recommend sticking with the previous stable version:
  pip install google-genai==1.66.0
• Manual Fix: If you must use 1.67.0, you can resolve the issue by manually upgrading typing-extensions:
  pip install "typing-extensions>=4.14.0"

Features

• Add inference_generation_config to EvaluationConfig for Tuning (1fdb4b8)
• Add live history_config with initial_history_in_client_content (a80babd)
• Add support for referencing registered metrics by resource name in evaluation run API (41b348e)
• Enable language code for audio transcription config in Live API for Vertex AI (c04be0d)

Bug Fixes

• Forward http_options in async_request_streamed to enable retry support (8b3be87)
• Forward http_options in async_request_streamed to enable retry support (#2097) (8b10efb)

v1.66.0

1.66.0 (2026-03-03)

Features

• Add gemini-3.1-flash-image-preview model (dd52cc2)
• Support signature for all Interaction tool types (abb388e)
• Update data types from discovery doc. (15666c0)