Changelog
2.29.0 (2026-10-07)
Features
- Support
"allowlist": "disabled" in environment network config. (fa4acc7)
- Update discovery doc (84bf19c)
Bug Fixes
- Only log direct AFC warning when functions are present in the config (6e36aaa)
Documentation
- Refresh docs for 2.28.0 (618f0aa)
- Update code samples to gemini-flash-latest, gemini-3.1-flash-lite-image, and gemini-3.8-flash-tts (5673494)
- Update generated SDK docstring examples to use gemini-flash-latest (28e0915)
2.28.0 (2026-10-02)
Features
- Add
lyria-3.5, gemini-omni-1.1-flash, and gemini-omni-flash-preview to Interactions Model enum (1e8c0cc)
- Support continuation_token in Interactions (d40ca70)
2.27.0 (2026-10-01)
Features
- Support continuation_token in GenerateContent (3931b29)
Documentation
2.26.0 (2026-09-30)
Features
- Add gcs_metrics_uri for exporting tuning job metrics. (b6535e8)
- Add Gemini 3.8 Flash TTS and Gemini 3.8 Flash Lite TTS models to SDKs (0cad6ca)
- genai-sdk: Add environments dedicated module and from_environment support (7672ff6)
- Include labels for LiveClientSetup (4742c9a)
- Support labels for Gemini API GenerateContent (81ffa26)
Bug Fixes
- Build a model before reading its field annotations when pruning extra fields (7845acd)
- cli: Include auto-assigned flag shorthands in
--usage schema (2579b94)
- Ensure Vertex AI interactions client uses default timeout=None instead of 5s. (feef230)
- Reap aiohttp sessions and auth locks belonging to closed event loops (6d01288)
- Use
CreateAgentInteraction for Trigger.interaction and TriggerCreateParams.interaction (046ccfb)
Documentation
- Clarify Voice expire_time and store TTL behavior in GAOS SDK (94b371d)
- overlays: Describe
environment and path on GetEnvironmentFiles and pin environment ID in environments get/delete examples (f15d148)
- Regenerate docs for 1.2.0 (938dd73)
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)