chore(main): release 1.4.1

[release-please]

🤖 I have created a release beep boop

1.4.1 (2025-10-21)

⚠ BREAKING CHANGES

• Support java.time.Instant and java.time.Duration for time/duration fields
• mark *Parameters classes as internal
• add enum support
• Rename getVideoOperation to getVideosOperation for Java SDK
• add enum support
• add enum support
• add streaming support for Chat
• Hide internal classes ApiResponse and Common
• Move generation config to the top level LiveConnectConfig
• Remove AsyncSession.sendContent method which was accidentally added
• No more checked exceptions
• Remove AsyncSession.sendContent method which was accidentally added
• No more checked exceptions
• Only expose toJson and fromJson as public methods in JsonSerializable

Features

• [Python] Implement async embedding batches for MLDev. (12ddfce)
• Add 'turn_complete_reason' and 'waiting_for_input' fields. (5bc4873)
• Add addWatermark parameter to the edit image configuration. (c4598da)
• Add ImageConfig to GenerateContentConfig (6fb5eba)
• Add NO_IMAGE enum value to FinishReason (6b00c0b)
• add sdkHttpResponse.headers to *Delete responses. (4be038d)
• add time range filter to Google Search Tool (4aba9a6)
• Add Tool.enterprise_web_search field (919c22a)
• Add VideoGenerationMaskMode enum for Veo 2 Editing (e5c8277)
• Add a default 5 minutes timeout to the Java SDK. (d80d23b)
• Add add_watermark field for recontext_image (Virtual Try-On, Product Recontext) (5aacbc0)
• add an _exclude_fields characteristic in the config for unused values to avoid unnecessary and unused code in converter and type generation. (bee4e3e)
• Add async editImage support for Java SDK (358c896)
• Add async list methods to Models, Caches, and Files (cde10ab)
• add async streaming chat (df6446a)
• add async support for chat (9973df7)
• Add AsyncPager class (cde10ab)
• Add basic support for async function calling. (653094a)
• add Caches.create/delete/get support (c4d17a0)
• add Chat module (03442fc)
• Add client.models.embedContent methods (02f177c)
• Add client.models.list() method (25883eb)
• Add compressionQuality enum for generate_videos (b0e665b)
• Add computeTokens support (85c751e)
• add Content.text() quick accessor (c184615)
• Add countTokens method support (8b8fb45)
• Add datastore_spec field for VertexAISearch (8c8b47a)
• Add domain to Web GroundingChunk (990586b)
• Add enable_enhanced_civic_answers in GenerationConfig (684a2c5)
• Add engine to VertexAISearch (8ed56ad)
• Add enhance_input_image and image_preservation_factor fields for upscale_image (94a329a)
• Add enhance_prompt field for Gemini Developer API generate_videos (944af16)
• add enum support (86b0553)
• add enum support (6cb7d7a)
• add enum support (04971fc)
• Add evaluation support to Vertex tuning (7c0bb19)
• Add Files module with Files.upload, .get and .delete (e211ca1)
• Add Files.download methods (082c890)
• Add FunctionResponsePart & ToolComputerUse.excludedPredefinedFunctions (1a24bed)
• Add FunctionResponsePart & ToolComputerUse.excludedPredefinedFunctions (99b50a6)
• Add FunctionResponsePart & ToolComputerUse.excludedPredefinedFunctions (ea954d3)
• Add FunctionResponsePart & ToolComputerUse.excludedPredefinedFunctions (cf8b8b6)
• Add FunctionResponsePart & ToolComputerUse.excludedPredefinedFunctions (f0aebc2)
• Add generate_audio field for private testing of video generation (16f2b0f)
• Add generateVideosFromSource in Go, refactor private generateVideos (c683835)
• Add generationComplete notification to Live ServerContent (de5a762)
• Add httpOptions field to type classes (971177d)
• Add image_size field for Gemini Developer API Imagen 4 generation (c50c755)
• Add image_size field for Vertex Imagen 4 generation (950c0c6)
• Add Image.fromFile() support in Java SDK (4ddcaa1)
• Add labels field to Imagen configs (e69cf68)
• Add labels to create tuning job config (695e17a)
• Add list methods in Caches and Files module (ce6ed85)
• add live proactivity_audio and enable_affective_dialog (64c20c7)
• add multi-speaker voice config (1689f77)
• Add new languages for Imagen 4 prompt language (7e1e6d2)
• Add output_gcs_uri to Imagen upscale_image (7649467)
• Add pagination support (25883eb)
• Add quick constructors for Content and Part (2ff9e86)
• Add resolution field for Gemini Developer API Veo 3 generation (eec410c)
• add session resumption. (5c35c52)
• add streaming support for Chat (59eca52)
• add support for audio, video, text and session resumption in java. (dcd08a4)
• Add support for Grounding with Google Maps (24b1127)
• Add support for lat/long in search. (f43f00f)
• add support for live grounding metadata (e90dd15)
• add support for model_selection_config to GenerateContentConfig (1958d4c)
• Add support for Veo frame interpolation and video extension (94f5e41)
• add tests for the async Operations module (14c008a)
• add the response body for generateContent (a011580)
• add the response body for generateContent (6e28ab4)
• add the response body for generateContent (b2a5b3f)
• Add thinking_budget to ThinkingConfig for Gemini Thinking Models (a3ea4ed)
• Add thinking_config for live (274c21d)
• Add traffic type to GenerateContentResponseUsageMetadata (fac241b)
• add Tuning support for Java (0ab209d)
• Add types for configurable speech detection (021d74b)
• Add types to support continuous sessions with a sliding window (d5e8a32)
• Add UsageMetadata to LiveServerMessage (8b57e99)
• Add utility methods for creating FunctionResponsePart and creating FunctionResponse Part with FunctionResponseParts (af16a4c)
• Add VALIDATED mode into FunctionCallingConfigMode (4bb8680)
• Add Veo 2 generate_videos support in Java SDK (272649a)
• Add Video FPS, and enable start/end_offset for MLDev (bc1df02)
• Add VideoGenerationReferenceType enum for generate_videos (df9d910)
• Added Async wrappers for the Files Module operations (b5b608d)
• Adding thought_signature field to the Part to store the signature for thoughts. (dc9c8f7)
• allow methods in batch to return headers in sdk_http_response by default (f937dd1)
• allow methods in models to return headers in sdk_http_response by default. (7415e88)
• allow methods in tuning to return headers in sdk_http_response by default (1b1205b)
• allow title property to be sent to Gemini API. Gemini API now supports the title property, so it's ok to pass this onto both Vertex and Gemini API. (9afeedc)
• allow users to access headers for generateContent method and generateContentStream (0315357)
• automatically parse a java.lang.reflect.Method instance into a FunctionDeclaration when users pass it in as a Tool. (e5109a0)
• Batches support in Java (5ce13e9)
• configure release-please to automatically update package version across all files during releases. (9131ac2)
• enable automatic function calling for Models.generateContent method (ecca800)
• Enable configurable speech detection in live SDK (d6bfa76)
• enable continuous fine-tuning on a pre-tuned model in the SDK. (e49d350)
• Enable Google Maps tool for Genai. (a4baf3c)
• enable input transcription for Gemini API. (9065970)
• enable json schema for controlled output and function declaration. (35d93d8)
• Enable R2V and Advanced Controls for Veo on Gemini Developer API (4c42e65)
• enable request level http options(set through XxxConfig) (abbe820)
• enable responseId for Gemini Developer API (4912ff4)
• Enable url_context for Vertex (cc772d8)
• expose generation_complete, input/output_transcription & input/output_audio_transcription to SDK for Vertex Live API (e3b517a)
• expose JsonSerializable.stringToJsonNode to help user better use *JsonSchema fields. (35d783b)
• expose session id in Live API (b6d5389)
• expose the responseJsonSchema in GenerateContentConfig (9d9acdb)
• generate the function_call class's converters (38703c7)
• http: Make HttpApiClient public (5da0746)
• include UNEXPECTED_TOOL_CALL enum value to FinishReason for Vertex AI APIs. (8186ff0)
• introduce FunctionDeclaration.fromMethod class method to parse a FunctionDeclaration instance from a java.lang.reflect.Method instance. (aeb63b4)
• java local tokenizer (d774185)
• java: Support GEMINI_API_KEY as environment variable for setting API key. (84e7588)
• make min_property, max_property, min_length, max_length, example, patter fields available for Schema class when calling Gemini API (8527db5)
• merge GenerationConfig into LiveConnectConfig (e2fa59d)
• Migrate Go file.create method to use the sdk_http_response field and remove http_headers (7755eab)
• No more checked exceptions (e452491)
• No more checked exceptions (cad9eba)
• Parametrize model ID in Java genai samples and set hardcoded model IDs as default values if model ID not passed in by user. (c1b0948)
• Populate X-Server-Timeout header when a request timeout is set. (7126995)
• RAG - Introducing context storing for Gemini Live API. (d63d625)
• record automatic function calling history for Chat.sendMessage methods. (7428d87)
• Remove experimental warnings for generate_videos and operations (be93305)
• rename ComputerUse tool (early access) (4bbba2b)
• resolve deep conditional nesting in Live API examples for better readability. (aa71865)
• return headers for list method in all modules. (45a027b)
• Return response headers for all methods (except streaming methods) (7e8b71b)
• Save prompt safety attributes in dedicated field for generate_images (c8c5aaf)
• support default field in Schema when users call Gemini API (1d7c48d)
• Support API keys for VertexAI mode for Java SDK (826c0dc)
• Support audio transcription in Vertex Live API (1ddb6d4)
• Support Batches delete (782465d)
• support client.caches.update method (345c2b9)
• Support continuous window compression in the Live API (7acb98c)
• support createEmbeddings in Batches.java (8947f6f)
• support customer-managed encryption key in cached content (3021aaf)
• Support different media input in Vertex Live API (7f4c6bf)
• support display_name for Blob class when calling Vertex AI (db33f8a)
• support document name in grounding metadata (8273922)
• Support enableWidget feature in GoogleMaps (aefbd5c)
• Support exclude_domains in Google Search and Enterprise Web Search (e975d28)
• support extraBody in HttpOptions class (036bac8)
• Support Gemini batch inline request's metadata and add test coverage to safety setting (17033b3)
• Support GenerateVideosSource for Veo GenerateVideos (c26af63)
• Support http headers in GenerateContentResponse (5282774)
• Support image recontext on Vertex (e7de8c8)
• Support Imagen 4 Ingredients on Vertex (b5eed8d)
• Support Imagen image segmentation on Vertex (e2a561b)
• support jailbreak in HarmCategory and BlockedReason (3dab40b)
• Support java.time.Instant and java.time.Duration for time/duration fields (460d3d3)
• Support maxConnections and maxConnectionsPerHost in Client instantiation (7a4a8ac)
• support media resolution (ce9e7b0)
• Support models.get/delete/update in Java (3d8d8ec)
• Support new enum types for UrlRetrievalStatus (cb27222)
• support new fields in FileData, GenerationConfig, GroundingChunkRetrievedContext, RetrievalConfig, Schema, TuningJob, VertexAISearch, (6bf3d32)
• Support passing builder classes to setter methods (996c994)
• Support passing builder varargs to setter methods (0b08524)
• Support RealtimeInputConfig, and language_code in SpeechConfig in python (f5bd874)
• support response headers in Go for all methods. (222b41e)
• Support setting the default base URL in clients via Client.setDefaultBaseUrls() (c119778)
• support tunings.cancel in the genai SDK for Python, Java, JS, and Go (9982251)
• Support Url Context Retrieval tool (f4fd37a)
• Support varargs in Enum setter methods (cd63fd0)
• Support varargs in setter methods (0b08524)
• Support Veo 2 Editing on Vertex (d401d3c)
• Support Veo 2 Reference Images to Video Generation on Vertex (2f5580f)
• Support video extension for Veo on Gemini Developer API (b398509)
• update release-please configuration to enable version updating across all files (d2f3c0e)
• Update VertexRagStore (4a75670)

Bug Fixes

• Add backwards compatibility for generateVideos in Java SDK (504984a)
• bug in validate history (7428d87)
• Defer loading ADC when credentials is provided explicitly in Live API (a540614)
• do not raise error for default field in Schema for Gemini API calls (8bb1c64)
• Enable id field in FunctionCall for Vertex AI. (3773fe7)
• Ensure Live server message are properly converted (206dc88)
• Expose JOB_STATE_RUNNING and JOB_STATE_EXPIRED for Gemini Batches states (c5b4fdf)
• fix errors in live samples (5a9892f)
• fix import in live sample (78cc345)
• Fix the bug that files.create doesn't return the upload URL correctly (eb40c5f)
• generateContentStream failed to find converter method GenerateContentResponseFromXxx (590cb98)
• Getter methods in Client will return null rather than throw exceptions when the value is not set (c1b0290)
• initialization of pre_tuned_model_checkpoint_id from tuning config. (c293633)
• live: Enhance security by moving api key from query parameters to header (e48c7f1)
• Make async generateContent and generateContentStream truly non-blocking (5cb18fd)
• Make async methods in Batches module truly non-blocking (f2ae75a)
• Make async methods in Caches, Tuning, and Operations modules truly non-blocking (db56239)
• Make async methods in Models module truly non-blocking (c205d01)
• Move generation config to the top level LiveConnectConfig (c71e78e)
• Only expose toJson and fromJson as public methods in JsonSerializable (dbef8b4)
• only run unit tests in github action (9b2861b)
• Pager throws an exception if list request returns nothing(correct behavior is returning a Pager without any items in it) (0a2301b)
• Remove AsyncSession.sendContent method which was accidentally added (e452491)
• Remove AsyncSession.sendContent method which was accidentally added (cad9eba)
• Remove default timeout (d1f6201)
• Remove duplicate JavaTimeModule in JsonSerializable (a7dbd4c)
• Rename LiveEphemeralParameters to LiveConnectConstraints. (0655609)
• schema handling in transformer (8064028)
• schema transformer logic fix. (e6ab7d5)
• Throw IllegalArgumentException rather than general Error when an invalid parameter is passed to Gemini/Vertex backend (1bd4485)
• Transformers are not being used in list types (a9609db)
• Update error message when a service from an unsupported backend is called (4cd81ea)
• update Live API audio example with better interruption handling (cad8df9)
• Update Live API websocket base url in java SDK (8c97572)
• Use orElseGet to defer loading of default credentials. (bc19d79)
• Use orElseGet to defer loading of default credentials. (#124) (6adac0e)

Documentation

• add a link for where to find the Google Cloud project id, API key and location (3ac726c)
• Add examples for embedContent (7583ddf)
• Add Imagen and Veo to README (cc0a0aa)
• Add javadoc for setter methods in types classes (996c994)
• Add javadoc to public classes/methods (78c2a39)
• Add latest models features in README (a2eccaf)
• add more comments to make it easier to follow live api code, and to explain the usage of new concepts like thenCompose. (96c792c)
• docstring improvements (9d0ca34)
• Fix comment typo for Modality.AUDIO (18dea48), closes #620
• fix small typo in comments (a6bfe36)
• Improve docs for response_mime_type and response_schema. Relate to #297 (4782f56)
• improve generate images documentation (44c21dd)
• mark Client as thread safe and Chat as not thread safe (be3e50e)
• Refactor model IDs into a Constants class (dacd787)
• Refactor/update docstrings for Imagen and Veo (2470101)
• Remove no-op PRs from changelog. (c498c8b)
• Update description of thinking_budget. (265f20a)
• Update examples and README after removing checked exceptions (5cb6ee5)
• Update generated video resolution config docstring (9a2ced8)
• Update README with latest features in Client (dcf70cc)
• update TokensInfo docstring (48eba7f)
• Updating docs to include how to initialize client via environment variables (7fc3e62)

Miscellaneous Chores

• mark *Parameters classes as internal (77c9d71)
• release 0.6.1 (19c6373)
• release 1.0.0 (d4561d7)
• release 1.4.1 (49a57d8)

Code Refactoring

• Hide internal classes ApiResponse and Common (6218143)
• Rename getVideoOperation to getVideosOperation for Java SDK (4cd355b)

---

This PR was generated with Release Please. See documentation.