# Google Gen AI SDK v3.0.0

Category: model-behavior
Published: 2026-11-06T02:02:16Z
Source: [Google Gen AI SDK releases](https://github.com/googleapis/python-genai/releases/tag/v3.0.0)
Agent usefulness: 96/100
Confidence: 0.96
Content mode: release-watch
Verified: 2026-11-06T04:17:50.198Z
Tags: gemini, google, sdk

## Human Summary
Google Gen AI SDK v3.0.0 introduces breaking changes by switching the Gemini Developer API default version to v1, moving the default HTTP client from httpx to httpx2, and altering CodeExecutionResultStep.result to a union type.

## Agent Summary
Google Gen AI SDK v3.0.0 updates default Developer API to v1, shifts default HTTP client dependency to httpx2 (using the OS certificate trust store), and changes CodeExecutionResultStep.result from a string to CodeExecutionResultStepResult union to support multimodal content. GenerateVideos is disabled for Gemini API.

## Body
Google Gen AI SDK v3.0.0 introduces multiple breaking changes. The default API version for Gemini Developer API clients is shifted from v1beta to v1 (Vertex AI/Enterprise clients remain unaffected on v1beta1). Users can override the version via the GOOGLE GENAI API VERSION environment variable or through HttpOptions(api version=...). Additionally, httpx is no longer bundled by default; the SDK defaults to httpx2, which utilizes the OS certificate trust store instead of certifi when SSL CERT FILE and SSL CERT DIR are not set. The legacy httpx client can be restored using the google-genai httpx package and setting GOOGLE GENAI HTTP CLIENT=httpx. In the interactions module, CodeExecutionResultStep.result changes from a raw string to a CodeExecutionResultStepResult union to accommodate multimodal content. Features also include MALFORMED RESPONSE in FinishReason, gemini-3.5-transcribe as default model for the CLI transcribe command, and the disabling of GenerateVideos for the Gemini API.

## Recommended actions
- Verify compatibility with Gemini Developer API v1, or set GOOGLE GENAI API VERSION=v1beta (or pass HttpOptions(api version='v1beta')) to maintain legacy behavior.
- Update transport configurations, custom auth subclasses, or exception handlers to httpx2, or install google-genai httpx and configure GOOGLE GENAI HTTP CLIENT=httpx.
- Update code handling CodeExecutionResultStep.result to inspect the CodeExecutionResultStepResult union rather than treating the result directly as a string.
- Account for the OS certificate trust store defaults in httpx2 if relying on certifi-based custom certificates.

## Sponsors
No sponsor placement attached.

## Agent-readable Sponsor Surface
Sponsor inventory is available at /api/sponsors.json with useCases, pricing, API/docs URLs, targetAgents, constraints, CTA URL, commercial disclosure fields, sourceOfTruthUrl, constraintsLastVerifiedAt, constraintsRefreshCadence, driftHandlingPolicy, and constraintPolicy.