Changelog
2.28.0 (2026-10-07)
Features
- Support
"allowlist": "disabled" in environment network config. (18bc392)
- update discovery doc (4e996fe)
2.27.0 (2026-10-02)
Features
- add
lyria-3.5, gemini-omni-1.1-flash, and gemini-omni-flash-preview to Interactions Model enum (4ce63d1)
- support continuation_token in Interactions (a888ad7)
2.26.0 (2026-10-01)
Features
- support continuation_token in GenerateContent (ac628c5)
2.25.0 (2026-09-30)
Features
- add gcs_metrics_uri for exporting tuning job metrics. (bc085fb)
- Add Gemini 3.8 Flash TTS and Gemini 3.8 Flash Lite TTS models to SDKs (b12dad0)
- genai-sdk: Add environments dedicated module and from_environment support (4d7e80b)
- include labels for LiveClientSetup (d4bcdad)
- support labels for Gemini API GenerateContent (71c3997)
Bug Fixes
- use
CreateAgentInteraction for Trigger.interaction and TriggerCreateParams.interaction (c4341e1)
2.24.0 (2026-09-22)
Features
- add sample_audio to Voice in GAOS SDK (d001d18)
- add Voices API resource to GAOS SDK (f97113f)
- expose SpeechMetadata, VoiceConfig.voice, and SpeechAnnotation in public GenAI SDKs (19b7858)
- support field.value_field syntax for map add_union_value annotations. (51d701a)
- update discovery doc (42f9716)
- wire voice into sdk (08b568e)
Bug Fixes
- sanitize path parameter descriptions in GAOS OpenAPI generation (1567962)
2.23.0 (2026-09-16)
Features
- add credential APIs resource to gaos. (0e6410b)
- Add RetrievalCallStep and RetrievalResultStep to interactions schema and SDKs. (d03d569)
- implement environments files upload and download across Python and TypeScript SDKs (3a4c512)
- support custom fetch in HttpOptions (01897b3)
- wire credential APIs resource to sdk. (280da75)
2.22.0 (2026-09-10)
Features
- Add from_environment support for environment copying (01ed17e)
Bug Fixes
- Add @ts-ignore before optional MCP imports in declaration files (7b5ef39)
- Remove unused field from FunctionResultDelta (aeb7453)
- Repair node fallback manifest and complete web entries (0f59bf8)
2.21.0 (2026-09-02)
Features
- Add Gemini 3.8 Flash model to SDKs and update Flash model descriptions (4a969fe)
2.20.0 (2026-08-31)
Features
- Add support for the audio/webm MIME type. (b0e3c5f)
- Add translation_config SDK support for GEAP. (3e1d923)
- add Video Understanding support to the Interactions API (6ddbeba)
Bug Fixes
- Don't set redundant Content-Length on file upload requests (2f5cc7a)
- Don't set redundant Content-Length on file upload requests (2f5cc7a), refs #1718
- expose ProcessingCallStep and ProcessingResultStep in Interactions SDK (b6f8db5)
- Quote setupComplete key in LiveClientMessage (4467faf)
2.19.0 (2026-08-25)
Features
- Add AudioTranscriptionConfigMode (c0a37de)
- add environment files support and scotty file download helper (0d6ee9d)
- Add TYPE_JPEG2000 to VideoContent.MimeType enum (41da204)
Performance Improvements
- Keep the Buffer in the Node tokenizer platform, ~2x faster model parse (11d804a)
2.18.0 (2026-08-19)
Features
- Add
mode enum (VERBATIM, SMART) to AudioTranscriptionConfig and TranscriptionConfig. (4c5208b)
- Add enable_data_retention to ToolParallelAiSearch, Add step_count to ReinforcementTuningHyperParameters, Add BidiGenerateContentSetup (f52c208)
- Add IDLE state to live connection status enum and mark REQUIRES_ACTION as deprecated. (2f110f2)
- add video resolution and extension task parameters (39b2a2d)
Bug Fixes
2.17.1 (2026-08-13)
Bug Fixes
2.17.0 (2026-08-12)
Features
- Add interaction_status to LiveServerContent (4489991)
- api: make the deferred service tier publicly available on Vertex (9dafee9)
- Make speech_config a structured object. (9c90665)
2.16.0 (2026-08-06)
Features
- Add the Gemini Robotics ER 2 Preview model (5647ced)
- Add TOO_MANY_TOOL_CALLS to FinishReason enum. (a7fa568)
- Add top-level errors array to Interaction resource (iAPI) (b9dfd81)
- Make HttpOptions.timeout a per-attempt deadline in the JS GenAI SDK. (8268806)
Bug Fixes
- Add propertyOrdering auto-population for ResponseSchema and ResponseJsonSchema for Dotnet SDK (e26542f)
2.15.0 (2026-07-30)
Features
- add environment resource (2c911be)
- Support GoogleMaps Tool grounding_types places and routing (52655c1)
- Support per-request retryOptions in the JS GenAI SDK API Client (124b606)
- Wire environment service into genai sdk (70d7938)
2.14.0 (2026-07-28)
Features
- [GenerateContentConfig] Add GenerationConfig.audio_transcription_config and Part.audio_transcription. (4b2e67a)
- Add flat
language_codes field to AudioTranscriptionConfig. (cc808eb)
- Allow api key + proj/location for enterprise mode (9c0540a)
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 (bb66101)
2.13.0 (2026-07-21)
Features
- A new field
custom_vocabulary is added to message .google.cloud.aiplatform.v1beta1.BidiGenerateContentSetup (f32ec0a)
- add model selector (b5d70da)
- interaction-api: add queued status to interaction proto (1b7dd39)
- make ASR fields public in v1main and Interactions (08ef3eb)
2.12.0 (2026-07-15)
Features
- Add AntigravityAgentConfig to OpenAPI schema overlays and regenerate SDKs. (872aa26)
- Add history config. (8666bc2)
- Add support for preserve custom headers for gaos (f96662a)
- add trigger resource (43e0137)
- Add Triggers resource to GoogleGenAI client. (8d520cd)
- interactions: add CodeMenderAgentConfig (4469a85)
- Populate per-modality prompt token count in embedding responses for gemini-embedding-2 (163bf72)
2.11.0 (2026-07-09)
Features
- Add environment_id in network config (85fe0a5)
- Add response_format and Translation_config in GenerationConfig (3f3b7bc)
- add retrieval result step and new fields to maps and search results (ecfdc69)
- Add Tool.exa_ai_search for Gemini Enterprise API (3f3b7bc)
- support Function declarations during Agent Creation (824badf)
- voice consent signature types across all SDK languages. (5fb5354)
Bug Fixes
- interactions: accept both dict and list[dict] for transform (67d2f68)
Code Refactoring
- interactions: remove cached_content, presence_penalty, and frequency_penalty; expose safety_settings and labels (0f414be)
2.10.0 (2026-06-24)
Features
- [Interactions] Add ComputerUse.disabled_safety_policies (a2ca95c)
- [Models] Add ComputerUse.disabled_safety_policies (3618023)
- add usage fields for steps (048db9a)
- add video generation and response format parameters. (84e795c)
2.9.0 (2026-06-19)
Features
- Add audioOffset to VoiceActivity (3bc7d42)
- Add interimInputTranscription to LiveServerContent (3bc7d42)
- Add LanguageAuto, LanguageHints, and adaptationPhrases to AudioTranscriptionConfig (3bc7d42)
- Add ServiceTier to UsageMetadata (1f44b04)
- expose Computer Use API fields (da54ea4)
- interaction-api: Add presence_penalty, frequency_penalty, and cached_content to models.proto (2740a42)
- interaction-api: Rename usage to total_usage in StreamMetadata. (b72db47)
- introduce gaos sdk libs (bfac5d4)
Miscellaneous Chores
- Configure 2.9.0 as the next release (e9968c6)
- Configure a 2.9.0-rc.0 prerelease (ae612ec)
2.8.0 (2026-06-03)
Features
- Add Agent Platform MCP support to async generate_content (baeaeaa)
- Add transcription language code. (d2981d6)
- Add TranslationConfig for live translation. (8c44240)
- Support ReinforcementTuning in GenAI SDK including ValidateReward API method. (36f0bfb)
2.7.0 (2026-05-27)
Features
- Add Skill Registry ListSkills and DeleteSkill to SDK (d75582a)
- additional computer_use field support for vertex. (54a692b)
- interaction-api: Allow "text/csv" as a supported document mime type for Interaction API. (3cc830e)
- interaction-api: Enable BigQuery tool in Deep Research config. (58c8c7e)
- Support Reinforcement Tuning in GenAI SDK (418cc35)
2.6.0 (2026-05-21)
Features
- add
enable_prompt_injection_detection for Computer Use feature for the Gemini API. (f780f3c)
- Add budget_exceeded status (1e97bd0)
- Add gemini-3.5-flash (1e97bd0)
- add new fields (b78eeee)
2.5.0 (2026-05-20)
Features
- Add Gemini 3.5 Flash model to options (fcf26e3)
2.4.0 (2026-05-17)
Features
- support Agent and Environment APIs. (b0d9d2b)
Bug Fixes
- output_text for turns that don't end with text. (1a3d94f)
2.3.0 (2026-05-15)
Features
- interaction.{output_text,output_image,output_audio,output_video} (0188233)
2.2.0 (2026-05-12)
Features
- Added missing FunctionCallResultDelta type and
arguments field to the ArgumentDelta type (f76138b)
2.1.0 (2026-05-12)
Features
- Add gemini-3.1-flash-lite to model options (b0664e1)
- Add parameters to video response_format. (207c8f8)
- Introduce Server Side tools deltas (2e56d41)
- support Blocking FunctionCall in Live API in AgentPlatform (Vertex) (6bd8e7d)
- Add support for Vertex-lyria models lyria-3-pro-preview & lyria-3-clip-preview (f9af7410)
Bug Fixes
2.0.1 (2026-05-09)
Bug Fixes
- Update response_format field names to snake_case. (26af549)
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 (c0814c4)
- Deprecate legacy response_format and publish new polymorphic field. (68a6809)
- Rename SSE events to interaction.created and interaction.completed (d1b836b)
Bug Fixes
1.52.0 (2026-05-04)
Features
- [Python] Multimodal file search (e626bef)
- Multimodal file search (54caf6b)
1.51.0 (2026-04-29)
Features
- [Interactions] Add FileCitation.{custom_metadata,media_id,page_number} (9e08ba9)
- Add
output_info to BatchJob (5327c60)
- Add gemini-3.1-flash-tts-preview model to options (35c941b)
- Add ImageResizeMode for GenerateVideos (faa1088)
- Add new Gemini Deep Research agent models (6f83a05)
- Add Vertex Dataset input and output options for batch jobs (6aa848e)
- interaction-api: Add grounding tool usage breakdown to Interaction Usage. (e1c31ad)
- introduce enterprise flag and GOOGLE_GENAI_USE_ENTERPRISE env var (cf7ad52)
- Replace the more ambiguous rate field with sample_rate. (6c80464)
1.50.1 (2026-04-14)
Bug Fixes
- Refactor Webhook types in GenAI SDKs for easier useage (5100abc)
- Rename
webhooks.retrieve to webhooks.get. (db6e771)
1.50.0 (2026-04-13)
Features
- Add "eu" as a supported service location for Vertex AI platform. (2493f9c)
- Add DeepResearchAgentConfig fields (3615ca2)
- Add Live Avatar new fields (6a0ff96)
- Add support for new audio MIME types: opus, alaw, and mulaw (7137f13)
- add webhook and webhookConfig for js and python sdk (0f89605)
- Add webhook_config to batches.create() and models.generate_videos() (894bc93)
- Wire the webhook into python and js client. (b6c5d18)
1.49.0 (2026-04-08)
Features
- Introduce TYPE_L16 audio content and optional fields. (c62cb9a)
1.48.0 (2026-03-31)
Features
- Support dedicated TextAnnotationDelta for streaming tool responses (89552ba)
Bug Fixes
1.47.0 (2026-03-27)
Features
- Add custom_metadata to FileSearchResult. (083a1e3)
- Add labels field to Veo configs (930c9c3)
- Add mime type for Audio content (1ad80c6)
- Add model_status to GenerateContentResponse (Gemini API only) (5e1110d)
- Add part_metadata in Part (Gemini API only) (5e1110d)
- Add service tier for interactions. (406de38)
- Add service tier to GenerateContent. (0bfe800)
- Add support for more image and audio MIME types in Interactions content (baadbfd)
- Add supported models to the ModelOptions (94642b6)
- genai: add TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO to TurnCoverage (fdacac2)
- support hyperparameters in distillation tuning (716e021)
- Support rendered_parts in GroundingSupport (5e1110d)
Bug Fixes
- support us region routing (d391cff)
1.46.0 (2026-03-17)
Breaking changes
- [Interactions] Breaking change to Interactions API to refactor TextContent annotations to use specific citation types (9fa8b1d)
- [Interactions] Breaking change for Interactions, rename ContentDelta unions. (917f24f)
- [Interactions] Breaking change to Interactions API to rename rendered_content to search_suggestions (cc6bd38)
Features
- [Interactions] Add and update 'signature' fields for tool call/result content types. (e73ca5b)
- [Interactions] Support Google Maps in Interactions (d0593e3)
- Support include_server_side_tool_invocations for genai. (c627d6f)
Bug Fixes
- Quote
functionResponses key in LiveClientMessage (9740426)
1.45.0 (2026-03-12)
Features
- Add inference_generation_config to EvaluationConfig for Tuning (b4ac722)
- enable language code for audio transcription config in Live API for Vertex AI (67f39ec)
1.44.0 (2026-03-04)
Features
- Add gemini-3.1-flash-image-preview model (175603b)
- Support signature for all Interaction tool types (b79108f)
- Update data types from discovery doc. (249b15a)
1.43.0 (2026-02-26)
Features
- Add gemini-3.1-pro-preview to list of models in Interactions (14775fe)
- Add Image Grounding support to GoogleSearch tool (9187ca7)
- enable server side MCP and disable all other AFC when server side MCP is configured. (c7888c4)
- Support more image sizes and resolutions (54f4145)
Bug Fixes
- change interactions media mime type to enum (breaking change for experimental feature) (7c2d5b2)
1.42.0 (2026-02-18)
Features
- Support multimodal embedding for Gemini Embedding 2.0 and support MaaS models in Models.embed_content() (Vertex AI API) (944ae97)
1.41.0 (2026-02-10)
Features
- Add HTTP retry support to the SDK (37d4f2e)
- Add INCOMPLETE status to Interaction. (519f837)
- Pass retry options to the underlying Interactions client (086cf82)
- Support encryption_spec in tuning job creation configuration for GenAI SDK (e218add)
1.40.0 (2026-02-04)
Features
- Update data types from discovery doc. (bad81a7)
1.39.0 (2026-01-30)
Features
- Add
include_input query parameter to Get Interaction endpoint. (84bc7f4)
- Add registerFiles for you can use gcs files with mldev. (7acf3e0)
- Support distillation tuning (c9a2e72)
- Support OSS Tuning in GenAI SDK (258f211)
Bug Fixes
- Add metadata in batch inlined response (0e95bb7)
1.38.0 (2026-01-20)
Features
- Add ModelArmorConfig support for prompt and response sanitization via the Model Armor service (be65c24)
- Allow custom endpoints for authentication with Vertex AI in Typescript (891e32d), closes #1137
- Update data types from discovery doc. (a16a180)
- Update data types from discovery doc. (a4eaa8c)
1.37.0 (2026-01-15)
Features
- Support 4:5 and 5:4 aspect ratio in Interactions (5294da2)
1.36.0 (2026-01-14)
Features
- Add FileSearchCallContent to Interactions (ccf11a4)
- Add ImageConfig to GenerationConfig for image generation in Interactions (f34b6fb)
- Support JS local tokenizer (bb429ad)
- voice activity support (3ad1011)
1.35.0 (2026-01-07)
Features
- [Python] add RegisterFiles so gcs files can be used with genai. (1bf555c)
- Add PersonGeneration to ImageConfig for Vertex Gempix (b0753d7)
1.34.0 (2025-12-16)
Features
- Add minimal and medium thinking levels. (19f8969)
- Add support for Struct in ToolResult Content. (750a4f7)
- Add ultra high resolution to the media resolution in Parts. (fa9a99e)
- Add ULTRA_HIGH MediaResolution and new ThinkingLevel enums (b8a7d8c)
- Define and use DocumentMimeType for DocumentContent (c2f118d)
- support multi speaker for Vertex AI (94d681b)
1.33.0 (2025-12-11)
Features
- Add IMAGE_RECITATION and IMAGE_OTHER enum values to FinishReason (ab87f51)
- Add voice activity detection signal. (bff9695)
- Make the Interactions API public. (a8dd67b)
1.32.0 (2025-12-09)
Features
- Add enableEnhancedCivicAnswers feature in GenerateContentConfig (b429389)
- Support ReplicatedVoiceConfig (7a56e35)
Bug Fixes
- Improve stream parsing performance (c9c1359)
1.31.0 (2025-12-03)
Features
- Add empty response for tunings.cancel() (5dc25bc)
1.30.0 (2025-11-18)