pypi / google-genai

google-genai

What changed in google-genai 2, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-19.

1 breaking1 security9 new APIs and options2 behavior and defaults11 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

google-genai 224 changes

Unsupported 2.5 and 1.6 models are removed from Interactions model options.
2.30.0release notes

Matches the mTLS endpoint to each transport's SSL context, including plain aiohttp.
2.31.0release notes

Adds gemini-4-argon to the Model enum, making it available as a model choice.
2.31.0release notes
Generate content and generate content stream can automatically resume continuation tokens; this behavior is disabled by default.
2.30.0release notes
New fields provide billable token counts.
2.30.0release notes
Interactions adds a CONTINUATION_REQUIRED status.
2.30.0release notes
The Interactions interaction.status_update event now includes a continuation token.
2.30.0release notes
Streaming continuation usage metadata is accumulated and exposes initial_prompt_token_count.
2.30.0release notes
InteractionStatusUpdate events now include usage.
2.30.0release notes
RealtimeInputConfig gains interimTranscriptTimestampEnabled.
2.30.0release notes
Transcription gains startOffset and endOffset fields.
2.30.0release notes

The chats module now automatically resumes continuation tokens.
2.30.0release notes
Default HTTP timeouts are raised so long-running requests are not killed client-side.
2.30.0release notes

Clears continuation state and preserves prompt feedback when a continuation hop returns no candidates.
2.31.0release notes
Retries dropped hops, stops on prompt_feedback, and preserves real errors in generate_content.
2.31.0release notes
Fixes parsing of function declarations that use union types.
2.31.0release notes
Fixes grounding metadata merging during automatic continuation in generate content and generate content stream.
2.31.0release notes
Concatenates output_text across multi-step model responses in a turn.
2.30.1release notes
Incomplete continuation stream turns are no longer recorded in curated chat history.
2.30.0release notes
The env schema now maps keys to EnvVar or string.
2.30.0release notes
The httpx and websocket transports now use the mTLS endpoint.
2.30.0release notes
A stale checkpoint token is discarded when the finish reason is non-resumable.
2.30.0release notes
Intermediate CONTINUATION finish_reason values are cleared during streaming continuation.
2.30.0release notes
Streaming generation resumes from the latest checkpoint continuation token after mid-stream errors or cutoffs.
2.30.0release notes