python-genai

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)

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)

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)

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)

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)

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)

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)

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)

1.48.0 (2025-11-03)

Features

• Added phish filtering feature. (a9297b7)
• Drop support for Python 3.9 - EOL (b542082)

Bug Fixes

• Append the current model chunk to contents in async streaming (7c5cf56)
• Disable AFC when there are incompatible tool presented. (ce13aef)
• Offload sync python tool calls to a thread when used from async context. (f2a0782)
• Only show warning log for non-text or multi-candidate fields when response.text is accessed directly (bf82505)

1.47.0 (2025-10-29)

Features

• Add safety_filter_level and person_generation for Imagen upscaling (6196b1b)
• Add support for preference optimization tuning in the SDK. (4540f9d)
• Pass file name to the backend when uploading with a file path (4fa2edd)
• Support default global location when not using api key with vertexai backend (6340ce0)
• Support retries in API requests (ac70ecd)

Bug Fixes

• Check environment Vertex AI api key for credential precedence (9bd758c)
• Correct pydantic version range (bytes fields are broken with pydantic<=2.8). (d24cb56)
• Make __del__ methods more robust in _api_client and client. (64cab58)
• Setting custom httpx async client will ensure using httpx client even if aiohttp is installed (7bd1bde)
• Support custom_base_url for Live and other APIs when project/location are unset and even when project/location are set in the environment, and avoid Automatic Default Credentials (7bd1bde)

Documentation

• Add docstring for classes and fields that are not supported in Gemini or Vertex API (4a6c6af)
• Add docstring for enum classes that are not supported in Gemini or Vertex API (909f26b)
• Add documentation for the retry behavior (ff12b46)
• Update Codegen Instructions to include newer models and use consistent formatting. (f0b0a94)
• Update README.md and index.rst to use consistent spacing for Python Samples (2e5aa1f)

1.46.0 (2025-10-21)

Features

• Add enable_enhanced_civic_answers in GenerationConfig (6c1dae7)
• Support custom httpx clients (694a6bd)
• Support jailbreak in HarmCategory and BlockedReason (011e218)

Bug Fixes

• Remove bytes for Gemini Developer API before sending a video for Veo Video Extension async (9ccc6ce)

Documentation

• Regenerate docs for 1.45.0 (9b7632d)
• Update README with Gempix example (nano-banana) (ac2bc42)

1.45.0 (2025-10-15)

Features

• Add support for Python 3.14. (f0083a2)

Bug Fixes

• Keys in Live API tool responses are incorrectly re-cased (57a4765)

1.44.0 (2025-10-15)

Features

• Support fully override base_url and raw model name when none of the project, locations, api_key are configured (160997e)
• Support video extension for Veo on Gemini Developer API (341ea77)

Bug Fixes

• Avoid potential dual import confusion in type assert (9cc4a72)

Documentation

• Refresh docs. (9c8147b)

1.43.0 (2025-10-10)

Features

• Enable Google Maps tool for Genai. (dc77a1d)
• Support enableWidget feature in GoogleMaps (1737f72)
• Support Gemini batch inline request's metadata and add test coverage to safety setting (7dcc969)

Documentation

• Regenerate updated Python docs (e6989a3)

1.42.0 (2025-10-08)

Features

• Add labels field to Imagen configs (cdba4c9)
• Add utility methods for creating FunctionResponsePart and creating FunctionResponse Part with FunctionResponseParts (72c92d8)
• Enable Ingredients to Video and Advanced Controls for Veo on Gemini Developer API (Early Access Program) (9c02a07)

Bug Fixes

• Avoid potential dual import for content type assertion (83d7973)
• Increase READ_BUFFER_SIZE in _api_client.py for streaming large chunks in new model (981bba7)
• Make t_part and t_content conform to their type annotations: they now handle FileDict correctly and t_contents handles PartUnionDict correctly. (0933632)

1.41.0 (2025-10-02)

Features

• Add NO_IMAGE enum value to FinishReason (3877044)
• Add thinking_config for live (0fa183c)

Bug Fixes

• Fix validation for image_config (efaa574)

Documentation

• Regenerate updated Python docs (53e7bd8)

1.40.0 (2025-10-01)

Features

• Add ImageConfig to GenerateContentConfig (88088df)
• Expose session id in Live API (1692f23)
• Rename ComputerUse tool (early access) (aaac8d8)

Bug Fixes

• Resolve potential mem leak on deletion of Client when using async (538c755)
• Resolve unclosed client session warning. (043a392)

1.39.1 (2025-09-26)

Bug Fixes

• Unbreak client closed errors when using vertexai session service (a0882bd)

Documentation

• Regenerate updated Python docs (4343332)

1.39.0 (2025-09-25)

Features

• Add FunctionResponsePart & ToolComputerUse.excludedPredefinedFunctions (aa7e3c2)
• Allow custom headers in file upload requests. (1aad1e9)
• Support explicitly closing the client and context manager (f982dfb)
• Support Imagen 4 Ingredients on Vertex (1fe3bec)

Bug Fixes

• Expose JOB_STATE_RUNNING and JOB_STATE_EXPIRED for Gemini Batches states (739f72d)
• Fix AFC logging (249f1af)
• Fix Max Depth repr for containers (dict, list, ...) (6ef3db8)
• Initialization of pre_tuned_model_checkpoint_id from tuning config. (1d3d28a)
• Remove unclosed client session message when sharing aiohttp ClientSession (8cee513)

1.38.0 (2025-09-16)

Features

• Add 'turn_complete_reason' and 'waiting_for_input' fields. (c1f57a5)

Bug Fixes

• Skip aiohttp related tests when package is not installed (50badf6)

Documentation

• Regenerate docs for 1.37.0 (1631b2e)