v1.57.0

1.57.0 (2026-01-07)

Features

• [Python] add RegisterFiles so gcs files can be used with genai. (68fa075)
• Add gemini-3-pro-preview support for local tokenizer (48f8256)
• Add PersonGeneration to ImageConfig for Vertex Gempix (c66e0ce)

Bug Fixes

• Remove validation for empty text parts on Chat, this will support keeping the history in chat when the API yields back such a part. (215c852)

Documentation

• Regenerate docs for 1.56.0 (b4c063e)
• Update codegen_instructions.md for Gemini 3 Flash (22500b5)
• Update Virtual Try-On model id in samples and docstrings (5bf4d62)

v1.56.0

1.56.0 (2025-12-16)

Features

• Add minimal and medium thinking levels. (96d644c)
• Add support for Struct in ToolResult Content. (8fd4886)
• Add ultra high resolution to the media resolution in Parts. (356c320)
• Add ULTRA_HIGH MediaResolution and new ThinkingLevel enums (336b823)
• Define and use DocumentMimeType for DocumentContent (dc7f00f)
• Support multi speaker for Vertex AI (ecb00c2)

Bug Fixes

• Api version handling for interactions. (436ca2e)

Documentation

• Add documentation for the new Interactions API (Preview). (e28a69c)
• Update and restructure codegen_instructions (00422de)
• Update docs for 1.55 (1cc43e7)

v1.55.0

1.55.0 (2025-12-11)

Features

• Add the Interactions API (836a3)
• Add enableEnhancedCivicAnswers feature in GenerateContentConfig (15d1ea9)
• Add IMAGE_RECITATION and IMAGE_OTHER enum values to FinishReason (8bb4b9a)
• Add voice activity detection signal. (feae46d)

Bug Fixes

• Replicated voice config bytes handling (c9f8668)

Documentation

• Regenerate docs for 1.54.0 (8bac8d2)

v1.54.0

1.54.0 (2025-12-08)

Features

• Support ReplicatedVoiceConfig (07c74dd)

Bug Fixes

• Apply timeout to the total request duration in aiohttp (a4f4205)
• Make APIError class picklable (fixes #1144) (e3d5712)

Documentation

• Regenerate docs for 1.53.0 (3a2b970)

v1.53.0

1.53.0 (2025-12-03)

Features

• Add empty response for tunings.cancel() (97cc7e4)

Bug Fixes

• Convert 'citationSources' key in CitationMetadata to 'citations' when present (fixes #1222) (2f28b02)
• Fix google.auth.transport.requests import error in Live API (a842721)

Documentation

• Improve docs for google.genai.types (5b50adc)
• Recommend using response_json_schema in error messages and docstrings. (c0b175a)
• Updating codegen instructions to use gemini 3 pro and nano banana pro (060f015)

v1.52.0

1.52.0 (2025-11-21)

Features

• Add support for configuring resource scope when using base_url (a3e0859)

Bug Fixes

• TypeError: issubclass() arg 1 must be a class when usingList[str] for contents (c624d7e)
• Create new aiohttp Client Session if loop is closed (1dc35ea)

v1.51.0

1.51.0 (2025-11-18)

Features

• Add a pre-validation hook to warn about Pydantic model type mismatches. (f7af6ef)
• Add display name to FunctionResponseBlob (52906d5)
• Add display name to FunctionResponseFileData (7c39f70)
• Add generate_content_config.thinking_level (30b00db)
• Add image output options to ImageConfig for Vertex (014aaad)
• Add part.media_resolution (30b00db)
• Support Function call argument streaming for all languages (9b2ca50)

Bug Fixes

• Only log warnings once for accessors in GenerateContentResponse and LiveServerMessage (eec841e)

Documentation

• Remove gemini 2 below model reference (c42ddff)
• Update sample code to use gemini 2 or above (d48bbba)
• Update Veo and Imagen model id in README (5c69122)

v1.50.1

1.50.1 (2025-11-13)

Bug Fixes

• Do not use ADC if passing a base_url, no project, no location (a00b67a)
• Ensure the custom httpx client and async client won't be closed automatically (9a9fa3c)

v1.50.0

1.50.0 (2025-11-12)

Features

• Use pytest-xdist for test parallelization (6ff82fc)

Bug Fixes

• Add missing fields to the model types (4b855e6)
• Don't generate warnings from response.text property because of thought_signature. (dd9360d)
• Fix base_steps parameter for recontext_image (d94077b)
• Fix file_search_stores.documents pagination (8d40d48)
• Fix models.list() filter parameter (7fa1e41)
• Handle SSE error message types properly in streaming (72afa50)
• Roll back a breaking change to the import system (8674003)

Documentation

• Log Schema.json_schema and Schema.from_json_schema only once (517300c)
• Regenerate docs for 1.49.0 (74b680a)

v1.49.0

1.49.0 (2025-11-05)

Features

• Add complete stats to BatchJob (b211466)
• Add FileSearch tool and associated FileSearchStore management APIs (2e2a78d)
• Add image_size to ImageConfig (Early Access Program) (81c027c)
• Make genai.Part constructible from PartUnionDict. (7526e4d)

Bug Fixes

• Raise errors during file upload. (946a17e)
• Use duck type in t_part transformer (be82981)

Documentation

• Log deprecation waring to Schema.from_json_schema method and Schema.json_schema method (856789a)
• Regenerate docs for 1.48.0 (004d238)
• Update log message in Schema.json_schema and Schema.from_json_schema methods (5bf69e5)