PyPI · #98 most downloaded on PyPI

openai

3.23.0425M downloads/moopenai/openai-python ↗New releases in your daily digest, changelog included.

The official Python library for the openai API

Last release today
01 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
440 releases · first in 2020

Release timeline

440 releases since 2020

2020202120222023202420252026

20202026

One column per quarter.

Releases

2.28.013 Mar 20263 sources agree
## 2.28.0 (2026-03-13) Full Changelog: v2.27.0...v2.28.0 ### Features * api: custom voices
2.28.0 (2026-03-13)

Full Changelog: v2.27.0...v2.28.0

Features

api: custom voices (50dc060)
Open source →
2.27.013 Mar 20263 sources agree
api: sora api improvements: character api, video extensions/edits, higher resolution exports.
2.27.0 (2026-03-13)

Full Changelog: v2.26.0...v2.27.0

Features

api: api update (60ab24a)

api: manual updates (b244b09)

api: manual updates (d806635)

api: sora api improvements: character api, video extensions/edits, higher resolution exports. (58b70d3)

Bug Fixes

api: repair merged videos resource (742d8ee)

Chores

internal: codegen related update (4e6498e)

internal: codegen related update (93af129)

match http protocol with ws protocol instead of wss (026f9de)

use proper capitalization for WebSockets (a2f9b07)

2.26.05 Mar 20263 sources agree

api: The GA ComputerTool now uses the CompuerTool class. The 'computer_use_preview' tool is moved to ComputerUsePreview

2.26.0 (2026-03-05)

Full Changelog: v2.25.0...v2.26.0

Features

api: The GA ComputerTool now uses the CompuerTool class. The 'computer_use_preview' tool is moved to ComputerUsePreview (78f5b3c)

Open source →

2.25.05 Mar 20263 sources agree

api: gpt-5.4, tool search tool, and new computer tool

2.25.0 (2026-03-05)

Full Changelog: v2.24.0...v2.25.0

Features

api: gpt-5.4, tool search tool, and new computer tool (6b2043f)
api: remove prompt_cache_key param from responses, phase field from message types (44fb382)

Bug Fixes

api: internal schema fixes (0c0f970)
api: manual updates (9fc323f)
api: readd phase (1b27b5a)

Chores

internal: codegen related update (bdb837d)
internal: codegen related update (b1de941)
internal: reduce warnings (7cdbd06)

Open source →

2.24.024 Feb 20263 sources agree

internal: make test_proxy_environment_variables more resilient to env

2.24.0 (2026-02-24)

Full Changelog: v2.23.0...v2.24.0

Features

api: add phase (391deb9)

Bug Fixes

api: fix phase enum (42ebf7c)
api: phase docs (7ddc61c)

Chores

internal: make test_proxy_environment_variables more resilient to env (65af8fd)
internal: refactor sse event parsing (2344600)

Open source →

2.23.024 Feb 20263 sources agree

api: add gpt-realtime-1.5 and gpt-audio-1.5 model options to realtime calls

2.23.0 (2026-02-24)

Full Changelog: v2.22.0...v2.23.0

Features

api: add gpt-realtime-1.5 and gpt-audio-1.5 model options to realtime calls (3300b61)

Chores

internal: make test_proxy_environment_variables more resilient (6b441e2)

Open source →

2.22.023 Feb 20263 sources agree

api: websockets for responses api

2.22.0 (2026-02-23)

Full Changelog: v2.21.0...v2.22.0

Features

api: websockets for responses api (c01f6fb)

Chores

internal: add request options to SSE classes (cdb4315)
update mock server docs (91f4da8)

Documentation

api: add batch size limit to file_batches parameter descriptions (16ae76a)
api: enhance method descriptions across audio, chat, realtime, skills, uploads, videos (21f9e5a)
api: update safety_identifier documentation in chat completions and responses (d74bfff)

Open source →

2.21.014 Feb 20263 sources agree

api: container network_policy and skills

2.21.0 (2026-02-13)

Full Changelog: v2.20.0...v2.21.0

Features

api: container network_policy and skills (d19de2e)

Bug Fixes

structured outputs: resolve memory leak in parse methods (#2860) (6dcbe21)
webhooks: preserve method visibility for compatibility checks (44a8936)

Chores

internal: fix lint error on Python 3.14 (534f215)

Documentation

split api.md by standalone resources (96e41b3)
update comment (63def23)

Open source →

2.20.010 Feb 20263 sources agree

api: support for images in batch api

2.20.0 (2026-02-10)

Full Changelog: v2.19.0...v2.20.0

Features

api: support for images in batch api (28edb6e)

Open source →

2.19.010 Feb 20263 sources agree

## 2.19.0 (2026-02-10) Full Changelog: v2.18.0...v2.19.0 ### Features * api: skills and hosted shell (27fdf68) ### Chores * internal: bump dependencie

2.19.0 (2026-02-10)

Full Changelog: v2.18.0...v2.19.0

Features

api: skills and hosted shell (27fdf68)

Chores

internal: bump dependencies (fae10fd)

Open source →

2.18.09 Feb 20263 sources agree

api: add context_management to responses

2.18.0 (2026-02-09)

Full Changelog: v2.17.0...v2.18.0

Features

api: add context_management to responses (137e992)
api: responses context_management (c3bd017)

Open source →

2.17.05 Feb 20263 sources agree

api: add shell_call_output status field

2.17.0 (2026-02-05)

Full Changelog: v2.16.0...v2.17.0

Features

api: add shell_call_output status field (1bbaf88)
api: image generation actions for responses; ResponseFunctionCallArgumentsDoneEvent.name (7d96513)
client: add custom JSON encoder for extended type support (9f43c8b)

Bug Fixes

client: undo change to web search Find action (8f14eb0)
client: update type for find_in_page action (ec54dde)

Open source →

2.16.027 Jan 2026Deprecated3 sources agree

api: mark assistants as deprecated

2.16.0 (2026-01-27)

Full Changelog: v2.15.0...v2.16.0

Features

api: api update (b97f9f2)
api: api updates (9debcc0)
client: add support for binary request streaming (49561d8)

Bug Fixes

api: mark assistants as deprecated (0419cbc)

Chores

ci: upgrade actions/github-script (5139f13)
internal: update actions/checkout version (f276714)

Documentation

examples: update Azure Realtime sample to use v1 API (#2829) (3b31981)

Open source →

2.15.09 Jan 20263 sources agree

api: add new Response completed_at prop

2.15.0 (2026-01-09)

Full Changelog: v2.14.0...v2.15.0

Features

api: add new Response completed_at prop (f077752)

Chores

internal: codegen related update (e7daba6)

Open source →

2.14.019 Dec 20253 sources agree

api: slugs for new audio models; make all model params accept strings

2.14.0 (2025-12-19)

Full Changelog: v2.13.0...v2.14.0

Features

api: slugs for new audio models; make all model params accept strings (e517792)

Bug Fixes

use async_to_httpx_files in patch method (a6af9ee)

Chores

internal: add --fix argument to lint script (93107ef)

Open source →

2.13.016 Dec 2025Breaking3 sources agree

ci: add CI job to detect breaking changes with the Agents SDK

2.13.0 (2025-12-16)

Full Changelog: v2.12.0...v2.13.0

Features

api: gpt-image-1.5 (1c88f03)

Chores

ci: add CI job to detect breaking changes with the Agents SDK (#1436) (237c91e)
internal: add missing files argument to base client (e6d6fd5)

Open source →

2.12.015 Dec 20253 sources agree

api: fix grader input list, add dated slugs for sora-2

2.12.0 (2025-12-15)

Full Changelog: v2.11.0...v2.12.0

Features

api: api update (a95c4d0)
api: fix grader input list, add dated slugs for sora-2 (b2c389b)

Open source →

2.11.011 Dec 20253 sources agree

## 2.11.0 (2025-12-11) Full Changelog: v2.10.0...v2.11.0 ### Features * api: gpt 5.2

2.11.0 (2025-12-11)

Full Changelog: v2.10.0...v2.11.0

Features

api: gpt 5.2 (dd9b8e8)

Open source →

2.9.04 Dec 20253 sources agree

api: gpt-5.1-codex-max and responses/compact

2.9.0 (2025-12-04)

Full Changelog: v2.8.1...v2.9.0

Features

api: gpt-5.1-codex-max and responses/compact (22f646e)

Bug Fixes

client: avoid mutating user-provided response config object (#2700) (e040d22)
ensure streams are always closed (0b1a27f)
streaming: correct indentation (575bbac)

Chores

deps: mypy 1.18.1 has a regression, pin to 1.17 (22cd586)
docs: use environment variables for authentication in code snippets (c2a3cd5)
internal: codegen related update (307a066)
update lockfile (b4109c5)

Open source →

2.8.117 Nov 20253 sources agree

api: align types of input items / output items for typescript

2.8.1 (2025-11-17)

Full Changelog: v2.8.0...v2.8.1

Bug Fixes

api: align types of input items / output items for typescript (64c9fb3)

Open source →

2.8.013 Nov 20253 sources agree

compat: update signatures of model_dump and model_dump_json for Pydantic v1

2.8.0 (2025-11-13)

Full Changelog: v2.7.2...v2.8.0

Features

api: gpt 5.1 (8d9f2ca)

Bug Fixes

compat: update signatures of model_dump and model_dump_json for Pydantic v1 (c7bd234)

Open source →

2.7.210 Nov 20253 sources agree

package: drop Python 3.8 support

2.7.2 (2025-11-10)

Full Changelog: v2.7.1...v2.7.2

Bug Fixes

compat with Python 3.14 (15a7ec8)

Chores

package: drop Python 3.8 support (afc14f2)

Open source →

2.7.14 Nov 20253 sources agree

api: fix nullability of logprobs

2.7.1 (2025-11-04)

Full Changelog: v2.7.0...v2.7.1

Bug Fixes

api: fix nullability of logprobs (373b7f6)

Open source →

2.7.03 Nov 20253 sources agree

api: Realtime API token_limits, Hybrid searching ranking options

2.7.0 (2025-11-03)

Full Changelog: v2.6.1...v2.7.0

Features

api: Realtime API token_limits, Hybrid searching ranking options (5b43992)
api: remove InputAudio from ResponseInputContent (bd70a33)

Bug Fixes

client: close streams without requiring full consumption (d8bb7d6)
readme: update realtime examples (#2714) (d0370a8)
uploads: avoid file handle leak (4f1b691)

Chores

internal/tests: avoid race condition with implicit client cleanup (933d23b)
internal: grammar fix (it's -> its) (f7e9e9e)

Open source →

2.6.124 Oct 20253 sources agree

client: clean up custom translations code

2.6.1 (2025-10-24)

Full Changelog: v2.6.0...v2.6.1

Bug Fixes

api: docs updates (d01a0c9)

Chores

client: clean up custom translations code (cfb9e25)

Open source →

2.6.020 Oct 20253 sources agree

api: Add responses.input_tokens.count

2.6.0 (2025-10-20)

Full Changelog: v2.5.0...v2.6.0

Features

api: Add responses.input_tokens.count (6dd09e2)

Bug Fixes

api: internal openapi updates (caabd7c)

Open source →

2.5.017 Oct 20253 sources agree

bump httpx-aiohttp version to 0.1.9

2.5.0 (2025-10-17)

Full Changelog: v2.4.0...v2.5.0

Features

api: api update (8b280d5)

Chores

bump httpx-aiohttp version to 0.1.9 (67f2f0a)

Open source →

2.4.016 Oct 20253 sources agree

api: Add support for gpt-4o-transcribe-diarize on audio/transcriptions endpoint

2.4.0 (2025-10-16)

Full Changelog: v2.3.0...v2.4.0

Features

api: Add support for gpt-4o-transcribe-diarize on audio/transcriptions endpoint (bdbe9b8)

Chores

fix dangling comment (da14e99)
internal: detect missing future annotations with ruff (2672b8f)

Open source →

2.3.010 Oct 20253 sources agree

api: comparison filter in/not in

2.3.0 (2025-10-10)

Full Changelog: v2.2.0...v2.3.0

Features

api: comparison filter in/not in (aa49f62)

Chores

package: bump jiter to >=0.10.0 to support Python 3.14 (#2618) (aa445ca)

Open source →

2.2.06 Oct 20253 sources agree

client: add chatkit to beta resource

2.2.0 (2025-10-06)

Full Changelog: v2.1.0...v2.2.0

Features

api: dev day 2025 launches (38ac009)

Bug Fixes

client: add chatkit to beta resource (de3e561)

Open source →

2.1.02 Oct 20253 sources agree

api: add support for realtime calls

2.1.0 (2025-10-02)

Full Changelog: v2.0.1...v2.1.0

Features

api: add support for realtime calls (7f7925b)

Open source →

2.0.11 Oct 20253 sources agree

api: add status, approval_request_id to MCP tool call

2.0.1 (2025-10-01)

Full Changelog: v2.0.0...v2.0.1

Bug Fixes

api: add status, approval_request_id to MCP tool call (2a02255)

Open source →

2.0.030 Sept 20253 sources agree

api: ResponseFunctionToolCallOutputItem.output and ResponseCustomToolCallOutput.output now return string | Array instead of string only. This may brea

2.0.0 (2025-09-30)

Full Changelog: v1.109.1...v2.0.0

⚠ BREAKING CHANGES

api: ResponseFunctionToolCallOutputItem.output and ResponseCustomToolCallOutput.output now return string | Array<ResponseInputText | ResponseInputImage | ResponseInputFile> instead of string only. This may break existing callsites that assume output is always a string.

Features

api: Support images and files for function call outputs in responses, BatchUsage (4105376)

Open source →

1.109.124 Sept 20253 sources agree

compat: compat with pydantic<2.8.0 when using additional fields

1.109.1 (2025-09-24)

Full Changelog: v1.109.0...v1.109.1

Bug Fixes

compat: compat with pydantic<2.8.0 when using additional fields (5d95ecf)

Open source →

1.109.023 Sept 20253 sources agree

## 1.109.0 (2025-09-23) Full Changelog: v1.108.2...v1.109.0 ### Features * api: gpt-5-codex

1.109.0 (2025-09-23)

Full Changelog: v1.108.2...v1.109.0

Features

api: gpt-5-codex (34502b5)

Open source →

1.108.222 Sept 20253 sources agree

api: openapi updates for conversations

1.108.2 (2025-09-22)

Full Changelog: v1.108.1...v1.108.2

Bug Fixes

api: fix mcp tool name (fd1c673)

Chores

api: openapi updates for conversations (3224f6f)
do not install brew dependencies in ./scripts/bootstrap by default (6764b00)
improve example values (20b58e1)

Open source →

1.108.119 Sept 20253 sources agree

types: change optional parameter type from NotGiven to Omit

1.108.1 (2025-09-19)

Full Changelog: v1.108.0...v1.108.1

Features

api: add reasoning_text (18d8e12)

Chores

types: change optional parameter type from NotGiven to Omit (acc190a)

Open source →

1.108.017 Sept 20253 sources agree

api: type updates for conversations, reasoning_effort and results for evals

1.108.0 (2025-09-17)

Full Changelog: v1.107.3...v1.108.0

Features

api: type updates for conversations, reasoning_effort and results for evals (c2ee28c)

Chores

internal: update pydantic dependency (369d10a)

Open source →

1.107.315 Sept 20253 sources agree

tests: simplify get_platform test

1.107.3 (2025-09-15)

Full Changelog: v1.107.2...v1.107.3

Chores

api: docs and spec refactoring (9bab5da)
tests: simplify get_platform test (0b1f6a2)

Open source →

1.107.212 Sept 20253 sources agree

api: Minor docs and type updates for realtime

1.107.2 (2025-09-12)

Full Changelog: v1.107.1...v1.107.2

Chores

api: Minor docs and type updates for realtime (ab6a10d)
tests: simplify get_platform test (01f03e0)

Open source →

1.107.110 Sept 20253 sources agree

## 1.107.1 (2025-09-10) Full Changelog: v1.107.0...v1.107.1 ### Chores * api: fix realtime GA types

1.107.1 (2025-09-10)

Full Changelog: v1.107.0...v1.107.1

Chores

api: fix realtime GA types (570fc5a)

Open source →

1.107.08 Sept 20253 sources agree

api: ship the RealtimeGA API shape

1.107.0 (2025-09-08)

Full Changelog: v1.106.1...v1.107.0

Features

api: ship the RealtimeGA API shape (dc319d8)

Chores

internal: codegen related update (b79b7ca)

Open source →

1.106.14 Sept 20253 sources agree

internal: move mypy configurations to pyproject.toml file

1.106.1 (2025-09-04)

Full Changelog: v1.106.0...v1.106.1

Chores

internal: move mypy configurations to pyproject.toml file (ca413a2)

Open source →

1.106.04 Sept 20253 sources agree

client: support callable api_key

1.106.0 (2025-09-04)

Full Changelog: v1.105.0...v1.106.0

Features

client: support callable api_key (#2588) (e1bad01)
improve future compat with pydantic v3 (6645d93)

Open source →

1.105.03 Sept 20253 sources agree

## 1.105.0 (2025-09-03) Full Changelog: v1.104.2...v1.105.0 ### Features * api: Add gpt-realtime models

1.105.0 (2025-09-03)

Full Changelog: v1.104.2...v1.105.0

Features

api: Add gpt-realtime models (8502041)

Open source →

1.104.22 Sept 20253 sources agree

types: add aliases back for web search tool types

1.104.2 (2025-09-02)

Full Changelog: v1.104.1...v1.104.2

Bug Fixes

types: add aliases back for web search tool types (2521cd8)

Open source →

1.104.12 Sept 20253 sources agree

api: manual updates for ResponseInputAudio

1.104.1 (2025-09-02)

Full Changelog: v1.104.0...v1.104.1

Chores

api: manual updates for ResponseInputAudio (0db5061)

Open source →

1.104.02 Sept 20253 sources agree

types: replace List[str] with SequenceNotStr in params

1.104.0 (2025-09-02)

Full Changelog: v1.103.0...v1.104.0

Features

types: replace List[str] with SequenceNotStr in params (bc00bda)

Bug Fixes

types: update more types to use SequenceNotStr (cff135c)
types: update some types to SequenceNotStr (03f8b88)

Chores

remove unused import (ac7795b)

Open source →

1.103.02 Sept 20253 sources agree

responses: add missing params to stream() method

1.103.0 (2025-09-02)

Full Changelog: v1.102.0...v1.103.0

Features

api: realtime API updates (b7c2ddc)

Bug Fixes

responses: add missing params to stream() method (bfc0673)

Chores

bump inline-snapshot version to 0.28.0 (#2590) (a6b0872)
client: format imports (7ae3020)
internal: add Sequence related utils (d3d72b9)
internal: fix formatting (3ab273f)
internal: minor formatting change (478a348)
internal: update pyright exclude list (66e440f)

Open source →

1.102.026 Aug 20253 sources agree

internal: change ci workflow machines

1.102.0 (2025-08-26)

Full Changelog: v1.101.0...v1.102.0

Features

api: add web search filters (1c199a8)

Bug Fixes

avoid newer type syntax (bd0c668)

Chores

internal: change ci workflow machines (3e129d5)
internal: codegen related update (b6dc170)

Open source →

1.101.021 Aug 20253 sources agree

api: Add connectors support for MCP tool

1.101.0 (2025-08-21)

Full Changelog: v1.100.3...v1.101.0

Features

api: Add connectors support for MCP tool (a47f962)
api: adding support for /v1/conversations to the API (e30bcbc)

Chores

update github action (7333b28)

Open source →

1.100.219 Aug 20253 sources agree

api: accurately represent shape for verbosity on Chat Completions

1.100.2 (2025-08-19)

Full Changelog: v1.100.1...v1.100.2

Chores

api: accurately represent shape for verbosity on Chat Completions (c39d5fd)

Open source →

1.100.118 Aug 20253 sources agree

types: revert response text config deletion

1.100.1 (2025-08-18)

Full Changelog: v1.100.0...v1.100.1

Bug Fixes

types: revert response text config deletion (ac4fb19)

Open source →

1.100.018 Aug 20253 sources agree

api: add new text parameters, expiration options

1.100.0 (2025-08-18)

Full Changelog: v1.99.9...v1.100.0

Features

api: add new text parameters, expiration options (e3dfa7c)

Open source →

1.99.912 Aug 20253 sources agree

types: actually fix ChatCompletionMessageToolCall type

1.99.9 (2025-08-12)

Full Changelog: v1.99.8...v1.99.9

Bug Fixes

types: actually fix ChatCompletionMessageToolCall type (20cb0c8)

Open source →

1.99.811 Aug 2025Breaking3 sources agree

types: revert ChatCompletionMessageToolCallUnion breaking change

1.99.8 (2025-08-11)

Full Changelog: v1.99.7...v1.99.8

Bug Fixes

internal/tests: correct snapshot update comment (2784a7a)
types: revert ChatCompletionMessageToolCallUnion breaking change (ba54e03)

Chores

internal/tests: add inline snapshot format command (8107db8)
internal: fix formatting (f03a03d)
tests: add responses output_text test (971347b)

Refactors

tests: share snapshot utils (791c567)

Open source →

1.99.711 Aug 20253 sources agree

types: rename ChatCompletionMessageToolCallParam

1.99.7 (2025-08-11)

Full Changelog: v1.99.6...v1.99.7

Bug Fixes

types: rename ChatCompletionMessageToolCallParam (48085e2)
types: revert ChatCompletionMessageToolCallParam to a TypedDict (c8e9cec)

Open source →

1.99.69 Aug 20253 sources agree

types: re-export more tool call types

1.99.6 (2025-08-09)

Full Changelog: v1.99.5...v1.99.6

Bug Fixes

types: re-export more tool call types (8fe5741)

Chores

internal: update comment in script (e407bb5)
update @stainless-api/prism-cli to v5.15.0 (a1883fc)

Open source →

1.99.58 Aug 20253 sources agree

client: fix verbosity parameter location in Responses

1.99.5 (2025-08-08)

Full Changelog: v1.99.4...v1.99.5

Bug Fixes

client: fix verbosity parameter location in Responses (2764ff4)

Open source →

1.99.48 Aug 20253 sources agree

types: rename chat completion tool

1.99.4 (2025-08-08)

Full Changelog: v1.99.3...v1.99.4

Bug Fixes

types: rename chat completion tool (8d3bf88)
types: revert ChatCompletionToolParam to a TypedDict (3f4ae72)

Open source →

Your coding agent can read these notes before it upgrades. Set up the MCP server →

openai

Release timeline

Releases

2.28.0 (2026-03-13)

Features

2.27.0 (2026-03-13)

Features

Bug Fixes

Chores

2.26.0 (2026-03-05)

Features

2.25.0 (2026-03-05)

Features

Bug Fixes

Chores

2.24.0 (2026-02-24)

Features

Bug Fixes

Chores

2.23.0 (2026-02-24)

Features

Chores

2.22.0 (2026-02-23)

Features

Chores

Documentation

2.21.0 (2026-02-13)

Features

Bug Fixes

Chores

Documentation

2.20.0 (2026-02-10)

Features

2.19.0 (2026-02-10)

Features

Chores

2.18.0 (2026-02-09)

Features

2.17.0 (2026-02-05)

Features

Bug Fixes

2.16.0 (2026-01-27)

Features

Bug Fixes

Chores

Documentation

2.15.0 (2026-01-09)

Features

Chores

2.14.0 (2025-12-19)

Features

Bug Fixes

Chores

2.13.0 (2025-12-16)

Features

Chores

2.12.0 (2025-12-15)

Features

2.11.0 (2025-12-11)

Features

2.9.0 (2025-12-04)

Features

Bug Fixes

Chores

2.8.1 (2025-11-17)

Bug Fixes

2.8.0 (2025-11-13)

Features

Bug Fixes

2.7.2 (2025-11-10)

Bug Fixes

Chores

2.7.1 (2025-11-04)

Bug Fixes

2.7.0 (2025-11-03)

Features

Bug Fixes

Chores

2.6.1 (2025-10-24)

Bug Fixes