v1.59.0

1.59.0 (2026-01-15)

Features

• Set the environment variable GOOGLE_API_PREVENT_AGENT_TOKEN_SHARING_FOR_GCP_SERVICES to 'false' within BaseApiClient to disable bound token sharing. (79ac880)
• Support 4:5 and 5:4 aspect ratio in Interactions (1ddd9f1)

Documentation

• Regenerate docs for 1.58.0 (39a8b06)

v1.58.0

1.58.0 (2026-01-14)

Features

• Add FileSearchCallContent to Interactions (a882dea)
• Add ImageConfig to GenerationConfig for image generation in Interactions (b61163f)
• Support passing the custom aiohttp.ClientSession through HttpOptions.aiohttp_client (750648f), closes #1662
• Voice activity support (b7b1c2e)

Bug Fixes

• Serialize Pillow images losslessly by default (8d7c74d)

Documentation

• Regenerate docs for 1.57.0 (65018b6)

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)