google-genai breaking changes
pypi52 curated breaking changes across major versions of google-genai. Use this as a migration checklist before bumping dependencies.
- 1.67.0 \u2192 1.68.0api
[Interactions] Breaking change to Interactions API to refactor TextContent annotations to use specific citation types ([6c3379f](https://github.com/googleapis/python-genai/commit/6c3379faa5e533d4146eee1b3c88ed80bbff46ce))
- 1.67.0 \u2192 1.68.0renamed
[Interactions] Breaking change to Interactions API to rename rendered_content to search_suggestions ([0e21c4e](https://github.com/googleapis/python-genai/commit/0e21c4ef3234fe195793711b8eb90354e154339f))
- 1.67.0 \u2192 1.68.0renamed
[Interactions] Breaking change for Interactions, rename ContentDelta unions. ([1b03909](https://github.com/googleapis/python-genai/commit/1b03909ac8367205a2f0dd46847a0f6d36fb62fd))
- 1.64.0 \u2192 1.65.0api
Enable server side MCP and disable all other AFC when server side MCP is configured. ([4dd7b16](https://github.com/googleapis/python-genai/commit/4dd7b165dc54d3ae75367f68d05f9d9951688f54))
- 1.64.0 \u2192 1.65.0api
Support more image sizes and resolutions ([8b2a4e0](https://github.com/googleapis/python-genai/commit/8b2a4e04707c86e5f7d46e0483a88457fbf6d533))
- 1.64.0 \u2192 1.65.0api
Change interactions media mime type to enum (breaking change for experimental feature) ([e0f3378](https://github.com/googleapis/python-genai/commit/e0f33786f76a1af6ac3ad1938ab57961833bf0a1))
- 1.64.0 \u2192 1.65.0api
Handle non-list response_stream in HttpResponse.json property ([006042d](https://github.com/googleapis/python-genai/commit/006042db8379d957ac1ac0e57993983a21f7e1d1))
- 1.64.0 \u2192 1.65.0api
Handle non-list response_stream in HttpResponse.json property ([#1903](https://github.com/googleapis/python-genai/issues/1903)) ([61aec34](https://github.com/googleapis/python-genai/commit/61aec3455e886a1c700fb0ba21ed40f59bba65ff))
- 1.64.0 \u2192 1.65.0api
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](https://github.com/googleapis/python-genai/commit/b28d1445bb6c2c46c495ffd1b03a622d9d6942f6)), closes [#2090](https://github.com/googleapis/python-genai/issues/2090) [#2051](https://github.com/googleapis/python-genai/issues/2051) [#1950](https://github.com/googleapis/python-genai/issues/1950)
- 1.64.0 \u2192 1.65.0api
Update README and codegen_instructions for structured outputs ([4d5a978](https://github.com/googleapis/python-genai/commit/4d5a978932e9aacd2569f3058ce5af527ae18210))
- 1.64.0 \u2192 1.65.0api
Regenerate docs for 1.64.0 ([a023141](https://github.com/googleapis/python-genai/commit/a02314197d0dc72e854fa3ea79247f53421511ba))
- 1.64.0 \u2192 1.65.0api
Add gemini-3.1-pro-preview to list of models in Interactions ([fe86870](https://github.com/googleapis/python-genai/commit/fe86870752ca8cc66d140d3942e9b07f19ca092c))
- 1.64.0 \u2192 1.65.0api
Add Image Grounding support to GoogleSearch tool ([0035182](https://github.com/googleapis/python-genai/commit/0035182ec4eaf1ce2503a09f290b1e48a2e1ee1f))
- 1.49.0 \u2192 1.50.0api
Use pytest-xdist for test parallelization ([6ff82fc](https://github.com/googleapis/python-genai/commit/6ff82fca9ed90992c15cfb3affdbb65dd5d5f4d1))
- 1.49.0 \u2192 1.50.0api
Add missing fields to the model types ([4b855e6](https://github.com/googleapis/python-genai/commit/4b855e621525f2bdd7cdd00e3a98edbdd173997b))
- 1.49.0 \u2192 1.50.0api
Don't generate warnings from response.text property because of thought_signature. ([dd9360d](https://github.com/googleapis/python-genai/commit/dd9360d21d0a979ddd7acf994a0aa19bec794182))
- 1.49.0 \u2192 1.50.0api
Fix base_steps parameter for recontext_image ([d94077b](https://github.com/googleapis/python-genai/commit/d94077bdeeddf012eae8134a341c915be5fe24ce))
- 1.49.0 \u2192 1.50.0api
Fix file_search_stores.documents pagination ([8d40d48](https://github.com/googleapis/python-genai/commit/8d40d48d9a048313ec97b60a8941e7b536721d6e))
- 1.49.0 \u2192 1.50.0api
Fix models.list() filter parameter ([7fa1e41](https://github.com/googleapis/python-genai/commit/7fa1e41580052822c90d9b6ba99c66674ab5851a))
- 1.49.0 \u2192 1.50.0api
Handle SSE error message types properly in streaming ([72afa50](https://github.com/googleapis/python-genai/commit/72afa50eb2c4d960a4f6b55909205d0739fde05a))
- 1.49.0 \u2192 1.50.0api
Roll back a breaking change to the import system ([8674003](https://github.com/googleapis/python-genai/commit/86740033fb9c93b822b33100324f6c2ac8ad1f7e))
- 1.49.0 \u2192 1.50.0api
Log Schema.json_schema and Schema.from_json_schema only once ([517300c](https://github.com/googleapis/python-genai/commit/517300caabd58268f06f4091f0cbbb52c2bc889e))
- 1.49.0 \u2192 1.50.0api
Regenerate docs for 1.49.0 ([74b680a](https://github.com/googleapis/python-genai/commit/74b680adfdf74b6e807d50d8595f092cd522a6f8))
- 1.17.0 \u2192 1.18.0api
Ignore struct types when performing forward compatibility field filtering ([7024011](https://github.com/googleapis/python-genai/commit/702401102a34e21e94201c9cc48aa7fe2db68958))
- 1.17.0 \u2192 1.18.0api
Adding `thought_signature` field to the `Part` to store the signature for thoughts. ([303f906](https://github.com/googleapis/python-genai/commit/303f9069f508e544fe2f9c680a700624057b6341))
- 1.17.0 \u2192 1.18.0api
Include UNEXPECTED_TOOL_CALL enum value to FinishReason for Vertex AI APIs. ([ccbc66e](https://github.com/googleapis/python-genai/commit/ccbc66e199b23cecf3a4bd0680c6a52b1260cedb))
- 1.17.0 \u2192 1.18.0api
Support ephemeral auth tokens as API keys for live connections in Python. ([db1d7ee](https://github.com/googleapis/python-genai/commit/db1d7eec869525d41ffc7b1570bd597b12fab323))
- 1.17.0 \u2192 1.18.0removed
Removed `live_ephemeral_connect`, ephemeral auth tokens can now be used as API keys ([db1d7ee](https://github.com/googleapis/python-genai/commit/db1d7eec869525d41ffc7b1570bd597b12fab323))
- 1.17.0 \u2192 1.18.0renamed
Rename LiveEphemeralParameters to LiveConnectConstraints. ([6719faf](https://github.com/googleapis/python-genai/commit/6719faf6be905b192397cfc361283f2bb9cad8de))
- 1.16.1 \u2192 1.17.0api
Send automatic function calling None responses as NULL to the model ([8446e3d](https://github.com/googleapis/python-genai/commit/8446e3deb514fd0bbc929d8dc8bcf79264bc0b45))
- 1.16.1 \u2192 1.17.0api
Support API keys for live in VertexAI mode ([5b5a750](https://github.com/googleapis/python-genai/commit/5b5a750fb25a2cdece16ca4027364ff0c9a591ef))
- 1.16.1 \u2192 1.17.0api
Support new fields in FileData, GenerationConfig, GroundingChunkRetrievedContext, RetrievalConfig, Schema, TuningJob, VertexAISearch, ([b07c549](https://github.com/googleapis/python-genai/commit/b07c549fa0d380629e5e25956291cb0693b23c94))
- 1.16.1 \u2192 1.17.0api
Add generate_audio field for private testing of video generation ([c2bccf3](https://github.com/googleapis/python-genai/commit/c2bccf373806be03c4e69973df8157dba6a2d0dc))
- 1.16.1 \u2192 1.17.0api
Fix comment typo for Modality.AUDIO ([d16cf1e](https://github.com/googleapis/python-genai/commit/d16cf1e9b1c2d210b911d3b3f7da5da891148c39)), closes [#620](https://github.com/googleapis/python-genai/issues/620)
- 1.16.1 \u2192 1.17.0api
Fix README typo. ([59ae8e0](https://github.com/googleapis/python-genai/commit/59ae8e0d18449b4eba109cfc5697d62b149eda6d))
- 1.16.1 \u2192 1.17.0removed
Remove unsupported Lyria enum for music generation mode ([98ff507](https://github.com/googleapis/python-genai/commit/98ff507d368d48066c701256c60718b620b098e2))
- 1.16.1 \u2192 1.17.0removed
Remove unsupported Lyria enum for music generation mode
- 1.9.0 \u2192 1.10.0removed
remove Part.from_video_metadata
- 0.8.0 \u2192 1.0.0removed
Remove deprecated field: `deprecated_response_payload`
- 0.7.0 \u2192 0.8.0renamed
Rename files.upload argument to "file" instead of "path".
- 0.6.0 \u2192 0.7.0api
make Part, FunctionDeclaration, Image, and GenerateContentResponse classmethods argument keyword only
- 0.6.0 \u2192 0.7.0breaking
Moved the HttpOptions class into types.py, by making it autogenerated. This causes the following breaking change:
- 0.6.0 \u2192 0.7.0breaking
Change asynchronous streaming output to an awaitable async iterator for client.aio.models.generate_content_stream and client.aio.chat.send_message_stream
- 0.6.0 \u2192 0.7.0removed
Remove skip_project_and_location_in_path from HttpOption
- 0.6.0 \u2192 0.7.0removed
Remove skip_project_and_location_in_path from async models.list
- 0.6.0 \u2192 0.7.0removed
remove "tuning.distill"
- 0.6.0 \u2192 0.7.0removed
Remove pillow as a required dependency
- 0.6.0 \u2192 0.7.0renamed
Renamed FunctionDeclaration class functions to reflect the fact that they work off of the `Callable` type not just functions.
- 0.6.0 \u2192 0.7.0renamed
rename batches.list method signature.
- 0.6.0 \u2192 0.7.0renamed
rename generate_image() to generate_images(), rename GenerateImageConfig to GenerateImagesConfig, rename GenerateImageResponse to GenerateImagesResponse, rename GenerateImageParameters to GenerateImagesParameters
- 0.3.0 \u2192 0.4.0api
Make Imagen upscale_factor a required argument, make upscale config optional
- unknown \u2192 0.3.0api
contents must be passed to CreateCachedContentConfig instead as a parameter to create_cached_content.
Get this data programmatically \u2014 free, no authentication.
curl https://depscope.dev/api/breaking/pypi/google-genai