OpenAI Python SDK 2 to 3

⚠ BREAKING CHANGES api: This minor release includes a breaking change to Decisions types. In Live response models, question instructions can now be a string or a list of structured text, image, or JSON parts; check isinstance(question.instr

Bug Fixes api: honor per-call WebSocket query settings (#4138) (d40a5e1) examples: stop microphone capture between recordings (#4143) (26e5d92) validate browser calls before reading driver state (#4142) (2bfe460) Chores api: clarify service

Features add Vertex AI support for the Responses API (#4139) (3e63d33) api: add 30-minute cache-write usage counts (#4111) (5589146) api: add compaction trigger IDs (#4122) (0e5794d) api: add custom voice consent management (#4135) (de6d70d

Bug Fixes preserve beta Realtime byte reads on websockets 13 (#4102) (5766349)

Features api: add typed Live sideband events (#4099) (8d5cbf0) api: add ultrafast service tier for Agents (#4101) (100bf8f) Bug Fixes realtime: preserve byte receives with websockets 13 (#4098) (309916e)

Features api: add degraded external storage status (#4097) (b216cb2) api: add Realtime Translation WebSocket sessions (#4095) (bfada50)

Features api: add safety identifiers to image requests and responses (#4093) (c969e32) api: share Decisions cache breakpoint parameter type (#4092) (f7cefda)

Features api: add cache settings and key options [2/2] (#4087) (325da45) api: add prompt-based voice creation (#4091) (2e39db7) api: add regional processing residency options (#4081) (21ce0c2) api: add response error diagnostics and model n

Features add browser and computer toolsets (1/4) (#4073) (47b9e4e)

Features api: add beta session spending limits (#4058) (b570279) api: add OCI external-storage provider support (#4060) (9eb83fe) api: add organization Decisions usage reporting (#4062) (5e7a23e) api: expose image tool error and moderation

Features api: add billing_not_active session error code (#4052) (c88b320) api: add shida to named Live voices (#4053) (7352cf5) api: add vault updates and metadata filters (#4047) (e72f493) api: align beta pagination limits and non-null par

Features api: add agent environment suspension and expiration (#4046) (6aa25a9) Chores deps: bump astral-sh/setup-uv from 10.1.0 to 10.2.0 (#4026) (8bfffd4) deps: bump CodeQL init and analyze to 4.38.2 (#4025) (4f5e618) deps: update PyJWT s

Features api: add prewarmed hosted environments (#4043) (c511a77)

Bug Fixes api: correct custom voice creation parameters (#4038) (b9bc5c1)

Features api: add standalone Decisions support (#4033) (b99e3e4)

Features agents: observe local tool failures (#4028) (95d9645) agents: run local tools during streamed session creation (#4027) (919b623) api: add agent turn items and usage source grouping (#4030) (bd74c4e) lib: export type_to_response_for

Features api: add custom voice creation and agent session events (#4013) (e5de2e5) Bug Fixes api: prioritize Python request routing fields (#4014) (ffcc4c4) api: prioritize routing fields in parse helpers (#4016) (ba53a10)

Features agents: [1/n] return typed answers from session streams (#4007) (10f8816) agents: stage files and download turn artifacts (#4009) (4fc2438) api: Add session traces and Realtime translations (#4001) (138e3d1) beta: expose typed appl

Bug Fixes api: correct the missing authentication error message (#3993) (51692ed), closes #3962 transform NotRequired typed dictionary fields (#3995) (5544c18) Chores tests: mark sample_file.txt as text with LF line endings (#3879) (fd78a48

Features api: add computer use to beta agents (#3989) (f5dddb5)

Features api: add GPT-6.1 Sol model identifier (#3986) (160b2c0)

Features api: add Agents credential and session options (#3967) (bb68198) api: add Cyber access programs to Responses (#3956) (09c5b6f) responses: opt in to incremental WebSocket text and tool snapshots (#3973) (d0207b4) responses: preserve

Bug Fixes preserve single files for fallback extraction paths (#3875) (bfd3680) Chores api: clarify approximate web search location defaults (#3953) (a95c95e) api: clarify Realtime modality array definitions (#3954) (e79cf53) api: correct f

Bug Fixes chat: preserve single-pass tool iterables (#3770) (33ffa1f) client: merge HTTP headers case-insensitively (#3486) (5e39766) Chores api: clarify Chat Completions seed limits (#3945) (be9d666) Documentation clarify collaborator-only

Features api: add GCP external storage support (#3943) (d12d60f) api: add GPT-Rosalind research model (#3940) (d041d73) Bug Fixes _utils/_transform: propagate api_exclude in _async_transform_recursive (#3324) (161ae65) api: handle omission

Features api: add GPT-6 Sol and Luna model identifiers (#3935) (455ce1b)

Features api: add external storage configuration management (#3909) (6332577) api: add safety case retrieval (#3911) (a87b938) api: add safety warning and deactivation webhook events (#3908) (19f1f37) api: add session environment reset even

Bug Fixes parsing: drop TextFormatT parameterization in parse_response to fix memory leak (#3084) (#3088) (009b7f6)

Bug Fixes api: avoid loading unrelated API resources on first use (#3898) (68e4317)

Features api: add webhook endpoint management (#3892) (9a11f6e) Chores api: deprecate MCP connector_id (#3894) (1ccaf07)

Features api: add agent session model settings (#3882) (4b15817) api: add audio-mini model choices (#3886) (a6eeb3f) api: add compaction progress events (#3866) (98e1d24) api: add managed Responses WebSocket sessions (#3887) (3b865af) api:

Bug Fixes client: validate retry limits and preserve application errors (#3867) (f86c721) correct typo "th" to "the" in StreamAlreadyConsumed error message (#3022) (7186203) examples: correct Azure endpoint hostname (#3298) (543516c) exampl

Features streaming: normalize errors raised while reading streams (#3827) (d7c41ef) Bug Fixes bound vector store file polling (#3401) (ae41bc4) example: refresh realtime push_to_talk_app session types (#2926) (0b7ad38) files: normalize Path

Features api: add Agents API (1c4284a)

Features api: Add Live API (0e4bfef) Bug Fixes add aclose() to AsyncStream for standard async cleanup (#2854) (802b334) handle bare dict and list annotations without type arguments (#3760) (c7e8c03) preserve finalized output on null respons

Features api: Add expiration controls for service account keys (#3825) (f348ec8)

Features api: add GPT Image 2.5 models and image options (#3824) (5b39c45) api: add service-account API key expiration fields (#3802) (f1cd7f0)

Features api: Add prompt cache diagnostics (#3800) (8326784) api: correct function argument completion event fields (openapi-545) (#3801) (2a98f6a) Bug Fixes api: accept incomplete web search call statuses (#3786) (3cc8d78) refuse overflowi

Features api: add gpt-6-astra and related features (#3791) (09f446f) Documentation add canonical SDK security model (#3778) (2a097b9)

Features api: update usage APIs and documentation (#3779) (6f0da16) Bug Fixes avoid repeated numpy checks for embeddings (#3757) (b19c216)

Features api: add compute_units to Responses and Chat Completions usage (#3749) (52421d1) Bug Fixes auth: harden X.509 workload identity integration (#3740) (fc3ad6c) Chores deps-dev: bump @stdy/cli from 0.22.1 to 0.22.2 (#3719) (4f5598c) d

Features api: make function call output call IDs optional (#3738) (c74501d)

Features api: Add obfuscation field to ChatCompletionChunk (#3690) (c7d8e1d) api: add project residency configuration and cost quantity units (#3726) (bc4f8ef) Bug Fixes api: encode Realtime call offers and session configuration (#3736) (55

Bug Fixes deps: update dependencies with published security fixes (#3680) (53aa4fc) Chores build: migrate to uv (#3653) (b37e85d) deps: remove jsonschema and unused fixture-validation dependencies (0dfdfdd) lock the repository Pyright toolc

Features support named data-residency endpoints (#3646) (11ee914) Bug Fixes require patched optional networking dependencies (#3651) (40e56de) Chores remove unused dependencies and pin build tooling (#3650) (eee8e4a) Documentation strengthe

Features add Bedrock Runtime endpoint support (SDK-290) (#3623) (86267d2) api: Add shell call streaming events and new service/image types (#3635) (ff14a33)

Features api: add WebSocket stream IDs (#3612) (d9029e3) api: add workload identity access token issued event (#3601) (df274d4) api: deprecate Sora video APIs (#3610) (721cb1c) api: Ultrafast tier, structured MCP and websocket errors, separ

⚠ BREAKING CHANGES api: HTTPX2 is now the default HTTP client, and httpx is no longer installed automatically. Applications using custom HTTPX clients, transports, or configuration objects must migrate to their HTTPX2 equivalents or use the