Changelog
2.25.0 (2026-09-22)
Features
- Add sample_audio to Voice in GAOS SDK (a011633)
- Add Voices API resource to GAOS SDK (c45b94e)
- Expose SpeechMetadata, VoiceConfig.voice, and SpeechAnnotation in public GenAI SDKs (a6d3243)
- Support field.value_field syntax for map add_union_value annotations. (ad00721)
- Update discovery doc (fa91716)
- Wire voice into sdk (e1d68b4)
Bug Fixes
- Sanitize path parameter descriptions in GAOS OpenAPI generation (25b0094)
2.24.0 (2026-09-16)
Features
- Add credential APIs resource to gaos. (d301255)
- Add RetrievalCallStep and RetrievalResultStep to interactions schema and SDKs. (9052efd)
- Implement environments files upload and download across Python and TypeScript SDKs (fc0834d)
- Wire credential APIs resource to sdk. (bf0d457)
Bug Fixes
- Do not run functions once the automatic function calling budget is spent (2580638)
Documentation
- Update GenAI SDK README files to use gemini-flash-latest (1feb999)
- Update Python Gen AI SDK README for Gemini 3.8 Flash (b88fded)
2.23.0 (2026-09-10)
Features
- Add from_environment support for environment copying (e6d3168)
- Support dynamic turn completion via interaction_status in live.py receive() (455df80)
Bug Fixes
- Remove unused field from FunctionResultDelta (2843079)
2.22.0 (2026-09-02)
Features
- Add Gemini 3.8 Flash model to SDKs and update Flash model descriptions (660001a)
2.21.0 (2026-08-31)
Features
- Add destination parameter to client.files.download to support streaming downloads to disk or file-like objects (fcf9e3f)
- Add support for the audio/webm MIME type. (67ec3d7)
- Add translation_config SDK support for GEAP. (ff153a7)
- Add Video Understanding support to the Interactions API (2cc99a9)
Bug Fixes
- Expose ProcessingCallStep and ProcessingResultStep in Interactions SDK (df0ab55)
2.20.0 (2026-08-25)
Features
- Add AudioTranscriptionConfigMode (4a80954)
- Add environment files support and scotty file download helper (3074263)
- Add TYPE_JPEG2000 to VideoContent.MimeType enum (ef39c40)
2.19.0 (2026-08-19)
Features
- Add
mode enum (VERBATIM, SMART) to AudioTranscriptionConfig and TranscriptionConfig. (e8cd7d0)
- Add enable_data_retention to ToolParallelAiSearch, Add step_count to ReinforcementTuningHyperParameters, Add BidiGenerateContentSetup (656da78)
- Add IDLE state to live connection status enum and mark REQUIRES_ACTION as deprecated. (599d89f)
- Add video resolution and extension task parameters (c3bdb88)
2.18.1 (2026-08-13)
Bug Fixes
2.18.0 (2026-08-12)
Features
- Add interaction_status to LiveServerContent (66e224c)
- api: Make the deferred service tier publicly available on Vertex (e1f7c40)
- Enable json schema in FunctionDeclaration parser (62d50d6)
- Make speech_config a structured object. (cc0d42e)
- Support injecting httpx2 client. (012804d), refs #2680
Bug Fixes
- Improve AFC(automatic function calling) in chat including fixing bugs in AFC for generate_content_stream. also log warnings in generate_content, generate_content_stream and their async variants that AFC is meant to be used in chat experience, not directly in models module. (fe6118e)
Performance Improvements
- Build model validators on first use instead of at import (66bfe95), refs #2784
- Lazily import the interactions API to speed up import google.genai (89dcfe5)
- Stop importing the requests HTTP stack at module scope (3a44936)
2.17.0 (2026-08-06)
Features
- Add the Gemini Robotics ER 2 Preview model (61d4645)
- Add TOO_MANY_TOOL_CALLS to FinishReason enum. (a8ec86e)
- Add top-level errors array to Interaction resource (iAPI) (c74505b)
Bug Fixes
- Add propertyOrdering auto-population for ResponseSchema and ResponseJsonSchema for Dotnet SDK (3ec2081)
Documentation
- Fix interactions (80d80ff)
- Regenerate docs for 2.16.0 (f03ecfd)
- Update GenerateVideos docstrings and samples (c41ba11)
2.16.0 (2026-07-29)
Features
- Add environment resource (615b6c3)
- Support GoogleMaps Tool grounding_types places and routing (95a335d)
- Wire environment service into genai sdk (361292e)
Documentation
- Communicate on upcoming updates in the next major version (f63b366)
- Regenerate docs for 2.15.0 (7c0e1bb)
2.15.0 (2026-07-28)
Features
- [GenerateContentConfig] Add GenerationConfig.audio_transcription_config and Part.audio_transcription. (0f775f1)
- Add flat
language_codes field to AudioTranscriptionConfig. (fc282b3)
- Allow api key + proj/location for enterprise mode (e8714ca)
Documentation
- Regenerate docs for 2.14.0 (3d3850a)
2.14.0 (2026-07-22)
Features
- [GenerateContentConfig] Add GenerationConfig.audio_transcription_config and Part.audio_transcription. (dc3d78d)
Bug Fixes
- Add deprecation warnings to Imagen generate_images, edit_images, generate_videos (if using prompt/text/image args), LiveConnectConfig.GenerationConfig which will be removed in the next major version (4905918)
Documentation
- Regenerate docs for 2.13.0 (097a99e)
2.13.0 (2026-07-21)
Features
- A new field
custom_vocabulary is added to message .google.cloud.aiplatform.v1beta1.BidiGenerateContentSetup (4eeb1ad)
- Add model selector (bf3dba4)
- interaction-api: Add queued status to interaction proto (87f1650)
- Make ASR fields public in v1main and Interactions (5b52faa)
- Support mTLS in custom client using google auth mtls.get_default_ssl_context (7270e6d)
Documentation
- Regenerate docs for 2.11.0 and 2.12.0 (dddd7c6)
2.12.1 (2026-07-16)
Bug Fixes
- Fix the normalization of Interactions inside triggers (be554d3)
2.12.0 (2026-07-15)
Features
- Add AntigravityAgentConfig to OpenAPI schema overlays and regenerate SDKs. (c68f857)
- Add trigger resource (0ab9525)
- Add Triggers resource to GoogleGenAI client. (60727fe)
- interactions: Add CodeMenderAgentConfig (50eca74)
- Populate per-modality prompt token count in embedding responses for gemini-embedding-2 (2ba0154)
2.11.0 (2026-07-09)
Features
- Add environment_id in network config (df5f13a)
- Add response_format and Translation_config in GenerationConfig (8928da3)
- Add retrieval result step and new fields to maps and search results (d2b19f6)
- Add Tool.exa_ai_search for Gemini Enterprise API (8928da3)
- Support Function declarations during Agent Creation (bbeb934)
Bug Fixes
- Avoid shadowing of built-in list in Python 3.14 (5a14046)
- Event loop mismatch in GenAI SDK (10df4b1)
- interactions: Accept both dict and list[dict] for transform (8c7cee3)
Documentation
- Add Agent Platform MCP example to readme (cb2a2a3)
Code Refactoring
- interactions: Remove cached_content, presence_penalty, and frequency_penalty; expose safety_settings and labels (ba552f7)
2.10.0 (2026-06-24)
Features
- Add Agent Platform MCP support to async generate_content_stream (a4772cc)
- [Interactions] Add ComputerUse.disabled_safety_policies (732368f)
- [Models] Add ComputerUse.disabled_safety_policies (a359406)
- Add usage fields for steps (7bb6c72)
- Add video generation and response format parameters. (ec8f22b)
Documentation
- Fix typos across docstrings (63ec5bb)
2.9.0 (2026-06-19)
Major updates
- The interactions implementation has been completely replaced. The public api surface is unchanged. (d830f16)
Features
- Add audioOffset to VoiceActivity (fb785e4)
- Add gemini-3-flash-preview (gemini-3.1, gemini-3.5, gemini-4 are already mapped) to the local tokenizer map. (749f8a1), closes #1972
- Add interimInputTranscription to LiveServerContent (fb785e4)
- Add LanguageAuto, LanguageHints, and adaptationPhrases to AudioTranscriptionConfig (fb785e4)
- Broaden publisher model path check to support all publishers (5d282e6)
- Add ServiceTier to UsageMetadata (45b4963)
- Expose Computer Use API fields (420b5a7)
- Gemma 4 local tokenizer support (ca97c58)
- interaction-api: Add presence_penalty, frequency_penalty, and cached_content to models.proto (05f16fe)
- interaction-api: Rename usage to total_usage in StreamMetadata. (7c331c6)
Bug Fixes
- Add fallback for
aiohttp.readline without max_line_length for backward compatibility because we still want to keep aiohttp as optional dependency (e99ab99), closes #2487
- Fix header (f8f9749)
- Keep live music API keys out of websocket urls (#2564) (c754ebf)
- Make
transformers an optional dependency for local tokenizers, also add other dependencies to local-tokenizer-extras. (528926b)
- Use .model_copy() instead of deprecated .copy() (216369f)
Features
- Add audioOffset to VoiceActivity (fb785e4)
- Add gemini-3-flash-preview (gemini-3.1, gemini-3.5, gemini-4 are already mapped) to the local tokenizer map. (749f8a1), closes #1972
- Add interimInputTranscription to LiveServerContent (fb785e4)
- Add LanguageAuto, LanguageHints, and adaptationPhrases to AudioTranscriptionConfig (fb785e4)
- Broaden publisher model path check to support all publishers (5d282e6)
Miscellaneous Chores
Major updates
- The interactions implementation has been completely replaced. The public api surface should be unchanged. (d830f16)
Features
- Add ServiceTier to UsageMetadata (45b4963)
- Expose Computer Use API fields (420b5a7)
- Gemma 4 local tokenizer support (ca97c58)
- interaction-api: Add presence_penalty, frequency_penalty, and cached_content to models.proto (05f16fe)
- interaction-api: Rename usage to total_usage in StreamMetadata. (7c331c6)
Bug Fixes
- Add fallback for
aiohttp.readline without max_line_length for backward compatibility because we still want to keep aiohttp as optional dependency (e99ab99), closes #2487
- Fix header (f8f9749)
- Keep live music API keys out of websocket urls (#2564) (c754ebf)
- Make
transformers an optional dependency for local tokenizers, also add other dependencies to local-tokenizer-extras. (528926b)
- Use .model_copy() instead of deprecated .copy() (216369f)
Documentation
- Announce Automatic Function Calling (AFC) upcoming breaking change warning (4697258)
- Clarify Live API START/END_SENSITIVITY_HIGH/LOW defaults are different in Gemini Live and Gemini Enterprise Agent Platform Live API (a0ec6ab), closes #2555
- Regenerate docs for 2.8.0 (93e7ab1)
2.8.0 (2026-06-03)
Features
- Add Agent Platform MCP support to async generate_content (e3be9af)
- Add transcription language code. (53ea3f6)
- Add TranslationConfig for live translation. (4775314)
- Support ReinforcementTuning in GenAI SDK including ValidateReward API method. (e0854a6)
Bug Fixes
- Include all fields of a single tool (7b1d498)
Documentation
- A comment for field
enable_widget in message GoogleMaps is changed (74d81dd)
- A comment for field
google_maps_widget_context_token in message GroundingMetadata is changed (74d81dd)
- Remove
codegen_instructions.md for simpler maintenance, Gemini API Skills should be the single source of truth (bfa2a49)
- Update README.md for model/SDK Changes and direct to Gemini API Skills (47c1a13)
- Update the docs for 2.7 (bbef98e)
2.7.0 (2026-05-27)
Features
- Additional computer_use field support for vertex. (b4828fa)
- interaction-api: Allow "text/csv" as a supported document mime type for Interaction API. (543137b)
- interaction-api: Enable BigQuery tool in Deep Research config. (5dc17e5)
- Support Reinforcement Tuning in GenAI SDK (0ead888)
2.6.0 (2026-05-21)
Features
- Add
enable_prompt_injection_detection for Computer Use feature for the Gemini API. (b1f632d)
- Add budget_exceeded status (15443c0)
- Add gemini-3.5-flash (15443c0)
- Add new fields (2910346)
Documentation
- Replace
vertexai with enterprise in Client instantiation (c1c6df7)
2.5.0 (2026-05-20)
Features
- Add Gemini 3.5 Flash model to options (706fd02)
2.4.0 (2026-05-17)
Features
- Support Agent and Environment APIs. (ef20d6b)
Bug Fixes
- Output_text for turns that don't end with text. (2afdeff)
- Pass max_line_length to readline() to prevent LineTooLong on large SSE lines with MTLS. (0e8f7bb)
2.3.0 (2026-05-15)
Features
- Add content union to UserInputStep (a5059a8)
- Interaction.{output_text,output_image,output_audio,output_video} (975d16a)
- Migrate Agent Engines, Evaluation, Prompt Management, and Skill features to agentplatform (abb1099)
Documentation
- Refresh generated docs for 2.2 (2ce0298)
2.2.0 (2026-05-12)
Features
- Added missing FunctionCallResultDelta type and
arguments field to the ArgumentDelta type (b0131f8)
2.1.0 (2026-05-12)
Features
- Add gemini-3.1-flash-lite to model options (2d5e0fa)
- Add parameters to video response_format. (4e9d68d)
- Introduce Server Side tools deltas (97d6fe5)
- Support Blocking FunctionCall in Live API in AgentPlatform (Vertex) (955bca6)
- Add support for vertex-lyria models lyria-3-pro-preview & lyria-3-clip-preview (1bc0536)
Bug Fixes
2.0.1 (2026-05-09)
Bug Fixes
- Update response_format field names to snake_case. (97142b1)
2.0.0 (2026-05-07)
⚠ BREAKING CHANGES - Interactions Only
Note: The breaking changes are only in interactions. GenerateContent usage in unaffected.
Refer to https://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026 for details
- Add steps for interactions (41d8e5b)
- Rename SSE events to interaction.created and interaction.completed (0549c1c)
- Deprecate legacy response_format and publish new polymorphic field. (7fdc9a1)
Documentation
1.75.0 (2026-05-04)
Features
- [Python] Multimodal file search (fe5d69e)
Bug Fixes
- Avoid caching stale token in async mTLS path (4e17a9c)
Documentation
- Fix python docstrings for Image.from_file() to use kwargs (cce5398)
- Update docs (ef26583)
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)
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)
1.73.0 (2026-04-13)
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)
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)
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)
1.70.0 (2026-03-31)
Features
- Support dedicated TextAnnotationDelta for streaming tool responses (5c820f2)