Skip to content

Releases: googleapis/python-genai

v1.68.0

18 Mar 00:52
8404ae2

Choose a tag to compare

1.68.0 (2026-03-17)

Breaking changes

  • [Interactions] Breaking change to Interactions API to refactor TextContent annotations to use specific citation types (6c3379f)
  • [Interactions] Breaking change for Interactions, rename ContentDelta unions. (1b03909)
  • [Interactions] Breaking change to Interactions API to rename rendered_content to search_suggestions (0e21c4e)

Features

  • [Interactions] Add and update 'signature' fields for tool call/result content types. (d896373)
  • [Interactions] Support Google Maps in Interactions (68f247c)
  • Support include_server_side_tool_invocations for genai. (546440c)

Bug Fixes

  • deps: Correct typing-extensions constraint (1.67 Issue)[https://github.com/googleapis/python-genai/releases/tag/v1.67.0] (9a4fd39)
  • Python 3.10-3.11 breakage caused by #2131 (9a4fd39)
  • Treat attempts=0 as attempts=1 in retry options to ensure no retries (2856c0a)

Documentation

  • Regenerate docs for 1.67.0 (ff7469a)

v1.67.0

12 Mar 20:28
3442105

Choose a tag to compare

1.67.0 (2026-03-12)

Caution

Known Issue:
This release contains a bug where the typing-extensions lower bound is set too low, which causes the SDK to break in some environments.

Recommended Actions:

  • Fall back to 1.66.0: If you do not immediately need the new features in 1.67.0, we recommend sticking with the previous stable version:
    pip install google-genai==1.66.0
  • Manual Fix: If you must use 1.67.0, you can resolve the issue by manually upgrading typing-extensions:
    pip install "typing-extensions>=4.14.0"

Features

  • Add inference_generation_config to EvaluationConfig for Tuning (1fdb4b8)
  • Add live history_config with initial_history_in_client_content (a80babd)
  • Add support for referencing registered metrics by resource name in evaluation run API (41b348e)
  • Enable language code for audio transcription config in Live API for Vertex AI (c04be0d)

Bug Fixes

  • Forward http_options in async_request_streamed to enable retry support (8b3be87)
  • Forward http_options in async_request_streamed to enable retry support (#2097) (8b10efb)

v1.66.0

04 Mar 21:59
267f9ff

Choose a tag to compare

1.66.0 (2026-03-03)

Features

  • Add gemini-3.1-flash-image-preview model (dd52cc2)
  • Support signature for all Interaction tool types (abb388e)
  • Update data types from discovery doc. (15666c0)

v1.65.0

26 Feb 00:10
b2be501

Choose a tag to compare

1.65.0 (2026-02-26)

Features

  • Add gemini-3.1-pro-preview to list of models in Interactions (fe86870)
  • Add Image Grounding support to GoogleSearch tool (0035182)
  • Enable server side MCP and disable all other AFC when server side MCP is configured. (4dd7b16)
  • Support more image sizes and resolutions (8b2a4e0)

Bug Fixes

  • Change interactions media mime type to enum (breaking change for experimental feature) (e0f3378)
  • Handle non-list response_stream in HttpResponse.json property (006042d)
  • Handle non-list response_stream in HttpResponse.json property (#1903) (61aec34)
  • Make aiohttp an optional dependency, bump aiohttp version upperbound, and ensure HttpOptions.async_client_args propagates to custom aiohttp.ClientSession request args for proxy etc. (b28d144), closes #2090 #2051 #1950

Documentation

  • Regenerate docs for 1.64.0 (a023141)
  • Update README and codegen_instructions for structured outputs (4d5a978)

v1.64.0

19 Feb 02:01
cff95b4

Choose a tag to compare

1.64.0 (2026-02-18)

Features

  • Add UnifiedMetric support to Vertex Tuning evaluation config (9a9908a)
  • Support multimodal embedding for Gemini Embedding 2.0 and support MaaS models in Models.embed_content() (Vertex AI API) (af40cc6)

v1.63.0

11 Feb 23:39
e15ad64

Choose a tag to compare

1.63.0 (2026-02-11)

Features

  • Add INCOMPLETE status to Interaction. (1a84605)
  • Support encryption_spec in tuning job creation configuration for GenAI SDK (057d6f0)

Bug Fixes

  • Base_url and global location parsing (2c40555)
  • Remove build warning due to extra comma: assertion on a tuple is always true (1cc2c2d)
  • Remove debug print statement. (60c0a2f)
  • Remove unused import of websockets (3b82b5f)

Documentation

  • Add docstrings to C# and Python SDK Operations methods. (f2e85a3)
  • Regenerate docs for 1.62.0 (455ec26)

v1.62.0

04 Feb 21:44
544d8fe

Choose a tag to compare

1.62.0 (2026-02-04)

Features

Bug Fixes

  • Add error handling for live and live music APIs (1148276), closes #668

v1.61.0

30 Jan 20:43
2639363

Choose a tag to compare

1.61.0 (2026-01-30)

Features

  • Add include_input query parameter to Get Interaction endpoint. (a0240d9)
  • Add registerFiles for you can use gcs files with mldev. (965395b)
  • Support distillation tuning (9e49d71)
  • Support OSS Tuning in GenAI SDK (51748a7)

Bug Fixes

  • Add metadata in batch inlined response (08c47aa)

v1.60.0

21 Jan 21:52
c9851d6

Choose a tag to compare

1.60.0 (2026-01-21)

Features

  • Add ModelArmorConfig support for prompt and response sanitization via the Model Armor service (8d1091a)

Documentation

  • Regenerate docs for 1.59.0 (351e490)
  • Update docs to include interactions and file_search_stores module (a21841c)

v1.59.0

15 Jan 20:24
111032c

Choose a tag to compare

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)