Changelog
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)
Features
- add display name to FunctionResponseBlob (81036ed)
- add display name to FunctionResponseFileData (564f718)
- Add generate_content_config.thinking_level (4e586df)
- Add image output options to ImageConfig for Vertex (fff5fb6)
- Add part.media_resolution (4e586df)
- support Function call argument streaming for all languages (b3b94f6)
1.29.1 (2025-11-12)
Bug Fixes
- Add missing fields to the model types (8937903)
- Don't generate warnings from response.text property because of thought_signature. (356b843)
- Fix base_steps parameter for recontext_image (946415f)
1.29.0 (2025-11-05)
Features
- add complete stats to BatchJob (3263514)
- Add FileSearch tool and associated FileSearchStore management APIs (05cff8c)
- Add FileSearch tool and associated FileSearchStore management APIs (25aa2a4)
- Add image_size to ImageConfig (Early Access Program) (e1e883a)
- Added phish filtering feature. (4b75e5d)
- update the build configs (97a2fac)
Bug Fixes
- disable AFC when there are AFC incompatible tool presented. (30c63b4)
1.28.0 (2025-10-29)
Features
- Add safety_filter_level and person_generation for Imagen upscaling (aaceb1b)
- Add support for preference optimization tuning in the SDK. (f74660e)
- Pass file name to the backend when uploading with a file path (7115726)
- support default global location when not using api key with vertexai backend (f8967b1)
- Update
test-server-sdk dependency to ^0.2.9. (8d507bf)
Bug Fixes
- Fix downloader. With this change after you await the download, the file write is complete, and the data is fully readable. (127c9bf)
1.27.0 (2025-10-23)
Features
- Remove redundant calls to rollup/api-extractor, speeds up the TS SDK testing further by a factor of 2. (009b75f)
Bug Fixes
1.26.0 (2025-10-21)
Features
- Add enable_enhanced_civic_answers in GenerationConfig (0e95d72)
- support jailbreak in HarmCategory and BlockedReason (cd79a83)
1.25.0 (2025-10-15)
Features
- Support video extension for Veo on Gemini Developer API (5d11d81)
1.24.0 (2025-10-10)
Features
- Enable Google Maps tool for Genai. (b671fe9)
- Support enableWidget feature in GoogleMaps (81ed6a3)
- Support Gemini batch inline request's metadata and add test coverage to safety setting (722562b)
1.23.0 (2025-10-08)
Features
- Add
NO_IMAGE enum value to FinishReason (5305334)
- Add labels field to Imagen configs (1e9e96c)
- Add utility methods for creating
FunctionResponsePart and creating FunctionResponse Part with FunctionResponseParts (5a0ce38)
- Enable Ingredients to Video and Advanced Controls for Veo on Gemini Developer API (Early Access Program) (d5bd0c1)
Bug Fixes
- support system_instruction and tools mapping via converter and cleanup handwritten mapping (54ec204)
1.22.0 (2025-10-02)
Features
- Add
ImageConfig to GenerateContentConfig (c137172)
- Add thinking_config for live (decc090)
- rename ComputerUse tool (early access) (e4345f9)
1.21.0 (2025-09-25)
Features
- Add FunctionResponsePart & ToolComputerUse.excludedPredefinedFunctions (61620f6)
- Support Imagen 4 Ingredients on Vertex (56cccfc)
Bug Fixes
- #963 allow leading whitespace before data chunks (24f4153)
- Expose
JOB_STATE_RUNNING and JOB_STATE_EXPIRED for Gemini Batches states (b513c69)
- initialization of
pre_tuned_model_checkpoint_id from tuning config. (2e10e7f)
1.20.0 (2025-09-16)
Features
- Add 'turn_complete_reason' and 'waiting_for_input' fields. (cb54332)
- Add
VideoGenerationMaskMode enum for Veo 2 Editing (3e850fd)
1.19.0 (2025-09-09)
Features
- Add labels to create tuning job config (220c4d6)
- Support Veo 2 Editing on Vertex (6e34fd0)
Bug Fixes
- Enable
id field in FunctionCall for Vertex AI. (7c6e047)
1.18.0 (2025-09-09)
Features
- generate the function_call class's converters (e57a7bc)
- Implement embed content batches. (9cb8613)
1.17.0 (2025-09-02)
Features
- Add resolution field for Gemini Developer API Veo 3 generation (5ce467b)
1.16.0 (2025-08-27)
Features
- add
sdkHttpResponse.headers to *Delete responses. (397c602)
- Add add_watermark field for recontext_image (Virtual Try-On, Product Recontext) (e182fe8)
- Add output_gcs_uri to Imagen upscale_image (8db102a)
- add outputSchema support for MCP (e2d4e50)
- Add VALIDATED mode into FunctionCallingConfigMode (af410e7)
- Add VideoGenerationReferenceType enum for generate_videos (eb17013)
- Support GenerateVideosSource for Veo GenerateVideos (2241749)
- support tunings.cancel in the genai SDK for Python, Java, JS, and Go (2d67d25)
- Update server test recordings to JSON. (dd0a033)
Bug Fixes
- js: empty env vars should be treated as undefined. (16a80c0)
1.15.0 (2025-08-18)
Features
- Support Imagen image segmentation on Vertex (6b86bae)
- Support Veo 2 Reference Images to Video Generation on Vertex (6bca6ad)
Bug Fixes
- chats: Drop the validation on part with empty text (d2602d2)
- Fix the bug to support Gemini Batch inlined requests system instruction (843c774)
1.14.0 (2025-08-13)
Features
- add an _exclude_fields characteristic in the config for unused values to avoid unnecessary and unused code in converter and type generation. (15a4504)
- enable continuous fine-tuning on a pre-tuned model in the SDK. (027f09d)
- support document name in grounding metadata (b801236)
- Support exclude_domains in Google Search and Enterprise Web Search (8ed49f1)
Bug Fixes
- Replace
gemini-2.5-flash-preview-04-17 with gemini-2.5-flash. (d7f1c30)
1.13.0 (2025-08-06)
Features
- Add image_size field for Gemini Developer API Imagen 4 generation (9841ecb)
- Add Lyria enum for music generation mode for vocalization (b05821f)
- allow methods in batch to return headers in sdk_http_response by default (55a2be4)
- enable responseId for Gemini Developer API (40e3a58)
- Support image recontext on Vertex (e417867)
- Support new enum types for UrlRetrievalStatus (88b47e6)
1.12.0 (2025-07-30)
Features
- allow methods in models to return headers in sdk_http_response by default. (efdcb8a)
- allow methods in tuning to return headers in sdk_http_response by default (f81c16a)
Bug Fixes
- Correctly populated the Rai filter reasons on Video Generation (316cdb0)
1.11.0 (2025-07-23)
Features
- Add image_size field for Vertex Imagen 4 generation (b6cc23e)
- enable function calling for Callable Tool besides McpClient in generateContent. (90565bd)
- Introduced Operations.get() which is a generic function to handle all Operation types. (a6f85c1)
- return headers for list method in all modules. (e8591a3)
- Updates to codegen instructions to improve performance for TypeScript (9c97ec6)
1.10.0 (2025-07-17)
Features
- Add
addWatermark parameter to the edit image configuration. (16bca99)
- Adding codegen instructions to guide LLMs to generate code with the Google GenAI SDK (7f74175)
- Update
hasMcpToolUsage to set the MCP tool usage when it is detected by calling mcpToTool (a70f9c4)
Bug Fixes
- live: enhance security by moving api key from query parameters to header (f183b7d)
- live: Rollback commit f183b7d, breaks live in web env (be24e86)
1.9.0 (2025-07-09)
Features
- Add new languages for Imagen 4 prompt language (65be769)
Bug Fixes
- add unref() for request timeouts (6b76c4b)
1.8.0 (2025-07-01)
Features
- Enable Vertex Multimodal Dataset as input to supervised fine-tuning. (055b435)
- Support Batches delete (6cd9174)
- Support different media input in Vertex Live API (305952e)
1.7.0 (2025-06-25)
Features
- Add compressionQuality enum for generate_videos (4325773)
- Add enhance_input_image and image_preservation_factor fields for upscale_image (13eedda)
- Batches support in TS (dd7355e)
- expose the responseJsonSchema in GenerateContentConfig (db54a5f)
Bug Fixes
- live: support ArrayBuffer in WebSocket messages (5a8aeac), closes #714
1.6.0 (2025-06-21)
Features
- allow users to access headers for generateContent method and generateContentStream (f5f0e02)
- enable json schema for controlled output and function declaration. (7d53d57)
- Include status code and export HTTP errors (bcabcb6)
- support extra_body in HttpOptions (1d48b6e)
Bug Fixes
- Fix build errors when the mcp package is not installed. (5b7e695)
1.5.1 (2025-06-13)
Bug Fixes
- Update MCP dependencies to be type-only (648019b)
1.5.0 (2025-06-11)
Features
- add a timeout parameter to CallableToolConfig (06f31fd)
- Add datastore_spec field for VertexAISearch (1b18a52)
- Add support for Veo frame interpolation and video extension (53f22e6)
- Make the MCP SDK an optional peer dependency. (2472fd3)
- RAG - Introducing context storing for Gemini Live API. (bdc2355)
Bug Fixes
- Prioritize credentials over implicit api key (from env) for node client using Vertex AI (d82aba2), closes #616
1.4.0 (2025-06-04)
Features
- Add enhance_prompt field for Gemini Developer API generate_videos (ea3cc8e)
- Enable url_context for Vertex (e377f58)
- js: Support
GEMINI_API_KEY as environment variable for setting API key. (97850ad)
Bug Fixes
- defined Type becomes TYPE_UNSPECIFIED when obfuscation is enabled (1ddf4f5)
- Update live SDK sample to address choppy audio quality (319bcbb)
- use Enum's value instead of keys for obfuscation. (132bd04)
1.3.0 (2025-05-30)