OpenAI Python SDK

Release 2.44.0 primarily addresses a bug in authentication header prioritization.

Release 2.43.0 primarily updates the underlying OpenAPI specification or Stainless configuration.

This release introduces new API features including admin spend alerts, manual updates, and OpenAPI spec configuration updates.

This patch release primarily addresses internal build system maintenance by removing a scheduled release workflow trigger.

This release introduces new features allowing direct access to moderation results on API responses for both general responses and chat completions.

This release introduces support for Amazon Bedrock Responses and fixes an issue allowing Bedrock API keys to be set directly on the client.

This release introduces new features related to audit logs, response structures, and optional query parameters in ActionSearch.

This release primarily focuses on updating the underlying API specifications and configurations. It includes several minor API updates and associated chore work.

Release 2.37.0 introduces API enhancements like the service_tier parameter and internal validation improvements, alongside removing an unnecessary client ID for workload identity authentication.

This release introduces manual API updates and new Realtime 2 API capabilities.

Version 2.35.1 addresses a specific bug fix related to the image generation API size enumeration.

This release introduces updates to the image API and includes chores related to removing and renaming the legacy Python CLI entrypoint. Documentation for top_logprobs has also been updated.

This release introduces support for setting headers via environment variables and adds functionality for Admin API Keys per endpoint. It also includes numerous bug fixes related to authentication handling and type corrections in response models.

This release includes an API update and fixes a bug related to the prompt_cache_retention enum value.

This release introduces significant enhancements to websocket handling, including event handlers, reconnection support, and the ability to enqueue messages when disconnected. It also adds detail to InputFileContent and the OAuthErrorCode type.

This release introduces support for short-lived tokens, raw websocket data transmission, and updates API message structures, while also correcting an inconsistency regarding the 'web_search_call.results' field in ResponseIncludable.

Version 2.30.0 introduces new fields for computer actions and includes several bug fixes related to API response types and input validation.

This release introduces new model slugs, adds video batch creation support, and includes several API enhancements along with minor dependency and serialization fixes.

This release introduces support for custom voices via the API.

This release introduces significant updates to the API, including enhancements for Sora video capabilities, and resolves a bug in the merged videos resource.

This release updates the GA ComputerTool to use the ComputerTool class and moves the 'computer_use_preview' tool to 'ComputerUsePreview'.

This release introduces support for new models and tools, while simultaneously removing the `prompt_cache_key` parameter and the `phase` field from message types.

This release introduces API support for the 'phase' field and includes related bug fixes and documentation updates.

Version 2.23.0 introduces new model options for realtime API interactions, specifically gpt-realtime-1.5 and gpt-audio-1.5.

This release introduces websocket support for the responses API and includes various documentation enhancements across several API endpoints.

Version 2.21.0 introduces new API capabilities for container network policy and skills, alongside fixes for memory leaks in structured output parsing.

Version 2.20.0 introduces support for images within the batch API operations.

Version 2.19.0 introduces new API capabilities for skills and hosted shell support, along with internal dependency bumps.

This release introduces the addition of the context_management field to API responses.

Release 2.17.0 introduces new API fields for shell output and image generation actions, alongside client improvements for JSON encoding. Several minor client-side bug fixes related to web search actions were also addressed.

This release introduces support for binary request streaming and includes general API updates. Additionally, the Assistants API endpoints have been marked as deprecated.

This release introduces a new `completed_at` property on the Response object for API interactions and includes internal code generation updates.

This release introduces support for new audio model slugs and allows all model parameters to accept string inputs, alongside a fix for the patch method using async file handling.

This release introduces support for the new gpt-image-1.5 model and includes internal CI/chore updates.

This release includes general API updates and specific fixes related to grader input lists and sora-2 dated slugs.

This release introduces support for the new gpt 5.2 model via the API.

Version 2.10.0 makes the model parameter mandatory for the responses/compact endpoint and fixes a type inference issue for pyright.

This release introduces support for the new gpt-5.1-codex-max model and includes several bug fixes related to stream closing and client configuration mutation. A temporary pin on mypy was also introduced due to a regression in version 1.18.1.

Version 2.8.1 primarily addresses a bug fix related to aligning input and output item types for better TypeScript compatibility within the API.

This release introduces support for the gpt 5.1 model and includes a bug fix related to Pydantic v1 compatibility for model serialization methods.

This patch release fixes Python 3.14 compatibility and officially drops support for Python 3.8.

Version 2.7.1 is a patch release primarily focused on fixing a bug concerning the nullability of logprobs in API responses.

This release introduces support for Realtime API token limits and new hybrid search ranking options. It also includes several bug fixes, notably ensuring streams are properly closed and preventing file handle leaks.

Version 2.6.1 primarily contains minor bug fixes, specifically updating API documentation, alongside internal code cleanup.

Version 2.6.0 introduces a new field for token counts in API responses and incorporates internal OpenAPI specification updates.

This release introduces an API update and bumps the dependency version for httpx-aiohttp.

Version 2.4.0 introduces support for the gpt-4o-transcribe-diarize model on the audio transcription endpoint and includes minor internal chore updates.

This release introduces new comparison filter capabilities for the API and updates dependencies to ensure compatibility with Python 3.14.

Version 2.2.0 introduces support for new API features from dev day 2025 and includes a minor bug fix related to beta resources.

Version 2.1.0 introduces support for realtime API calls. This release focuses on expanding real-time interaction capabilities.

This patch release includes a bug fix for MCP tool calls, adding missing status and approval request ID fields.

This major release introduces support for multi-modal function call outputs (images and files) and BatchUsage, while changing the output type of tool call response items from string to a union type.

This patch release addresses a compatibility bug with older versions of Pydantic when handling additional fields.

This release introduces support for the gpt-5-codex model to the OpenAI Python SDK.

This patch release focuses on fixing MCP tool naming and updating OpenAPI definitions for conversations, alongside minor internal script improvements.

This release introduces the reasoning_text field to the API and updates internal type handling for optional parameters from NotGiven to Omit.

This release introduces type updates for conversations and reasoning effort in evaluations, alongside internal Pydantic dependency maintenance.

This is a maintenance release focused on internal API documentation refactoring, specification updates, and test simplification.

This patch release includes minor documentation and type updates for the realtime API, along with internal test simplifications.

This patch release focuses on correcting type definitions for the Realtime API following its General Availability.

This release introduces the API shape for RealtimeGA and includes internal codegen updates.

This patch release focuses on internal maintenance by moving mypy configurations to the pyproject.toml file.

This release introduces support for dynamic API keys via callables and enhances forward compatibility with Pydantic v3.

This release introduces support for the new gpt-realtime models in the OpenAI API.

Version 1.104.2 is a maintenance patch that restores type aliases for web search tools to fix potential type-checking regressions.

This patch release includes manual updates to the ResponseInputAudio API components.

This release focuses on internal type safety improvements by replacing List[str] with SequenceNotStr in various parameter definitions.

This release introduces updates to the Realtime API and fixes a bug where parameters were missing from the stream() method.

This release introduces web search filters to the API and fixes a bug related to modern type syntax usage.

This release introduces support for the /v1/conversations endpoint and adds connector support for MCP tools.

This is a maintenance release focused on internal CI improvements, specifically setting up breaking change detection.

This patch release updates the internal API representation for the verbosity parameter in Chat Completions to ensure accurate data shaping.

This patch release reverts an accidental deletion of response text configuration types to ensure type consistency.

This release introduces new text parameters and expiration options to the API.

This patch release specifically addresses a typing issue within the ChatCompletionMessageToolCall class.

Release 1.99.8 focuses on internal test improvements and reverts a breaking change to the ChatCompletionMessageToolCallUnion type.

Release 1.99.7 focuses on fixing type definitions by reverting ChatCompletionMessageToolCallParam to a TypedDict.

This release focuses on improving type exports for tool calls and internal maintenance updates.

This patch release fixes a bug regarding the location of the verbosity parameter within the Responses class.

This patch release focuses on type definition fixes, specifically reverting ChatCompletionToolParam to a TypedDict and renaming internal chat completion tool types.

This patch release restores the missing 'output_text' field to response objects.

This release introduces support for GPT-5 and associated API features, alongside a fix for tool-related type definitions.

This patch release addresses a bug regarding internal event imports.

This release introduces support for file upload requests and adds missing prompt cache parameters to the client.

This release includes manual updates to the API.

This patch release includes internal refactoring of the streaming client for future-proofing and adds VS Code project settings.

This patch release focuses on improving parsing logic for metadata and extra field types, alongside internal API event shape refinements.

This release includes manual updates to the API definitions.

This patch release updates the internal Realtime API specifications.

This release focuses on internal maintenance, including environment call-out cleanup and updates to the Realtime API specifications.

This patch release fixes a bug in the client where Content-Type headers were incorrectly being sent during GET requests.

This release introduces file_url support to the API and includes minor fixes for event IDs and README rendering on PyPI.

Release 1.94.0 improves API error messaging specifically for missing embeddings.

This patch release addresses a bug in the parsing logic to correctly handle nested discriminated unions.

This maintenance release adds official support for Python 3.13 and updates the internal h11 dependency constraint.

This patch release focuses on fixing missing arguments in vector store file polling methods and response parsing, alongside CI improvements.

This release introduces CLI support for managing fine-tuning jobs.

This patch release fixes an encoding error triggered by empty API keys and updates documentation regarding macOS requirements for realtime examples.

This maintenance release removes an unsupported 'api' property from the library.