CHANGELOG.md

Changelog

4.12.0 (2026-04-15)

Full Changelog: v4.11.0...v4.12.0

Features

• api: seedance2 (5004f1d)
• client: awaitable task support for seedance2 (c3f73ee)

Bug Fixes

• api: remove spurious api param (92173b3)
• ensure file data are only sent as 1 parameter (fc5a5ef)

4.11.0 (2026-04-10)

Full Changelog: v4.10.0...v4.11.0

Features

• api: add avatar_videos resource (75b6ded)
• polling: add wait_for_task_output to avatar_videos.create (e8fe41b)

Bug Fixes

• client: preserve hardcoded query params when merging with user params (839c38b)

Chores

• pin GitHub Actions to full commit SHAs (8f7689b)

4.10.0 (2026-04-01)

Full Changelog: v4.9.0...v4.10.0

Features

• api: add tools parameter to realtime sessions (c06a7f0)
• internal: implement indices array format for query and form serialization (d8fecc7)

Chores

• tests: bump steady to v0.20.1 (ad84815)
• tests: bump steady to v0.20.2 (7c63591)

4.9.0 (2026-03-25)

Full Changelog: v4.8.0...v4.9.0

Features

• api: add workflow invocation polling support (6eb6fc5)
• api: add workflows and workflow invocations resources (35d8573)

Bug Fixes

• sanitize endpoint path params (84efc12)

Chores

• ci: skip lint on metadata-only changes (1899411)
• internal: update gitignore (8bdac54)
• tests: bump steady to v0.19.4 (8841072)
• tests: bump steady to v0.19.5 (5adc696)
• tests: bump steady to v0.19.6 (135a06b)
• tests: bump steady to v0.19.7 (b7eeb81)

Refactors

• introduce dedicated error types for workflow invocation polling (420f91c)
• tests: switch from prism to steady (0a1bb5a)

4.8.0 (2026-03-18)

Full Changelog: v4.7.1...v4.8.0

Features

• api: Add document update endpoint (f9f8a7d)

4.7.1 (2026-03-16)

Full Changelog: v4.7.0...v4.7.1

Bug Fixes

• deps: bump minimum typing-extensions version (69d3f16)
• pydantic: do not pass by_alias unless set (cae07b4)

Chores

• ci: skip uploading artifacts on stainless-internal branches (f153e58)
• internal: tweak CI branches (f4d6103)

4.7.0 (2026-03-06)

Full Changelog: v4.6.3...v4.7.0

Features

• api: add avatar, voice, document, and realtime session endpoints (18b1573)

Chores

• test: do not count install time for mock server timeout (84988e1)

4.6.3 (2026-02-27)

Full Changelog: v4.6.2...v4.6.3

Chores

• docs: add missing descriptions (f64ea7b)
• internal: make test_proxy_environment_variables more resilient (b0a3688)
• internal: make test_proxy_environment_variables more resilient to env (dd8ca18)

4.6.2 (2026-02-23)

Full Changelog: v4.6.1...v4.6.2

Chores

• internal: add request options to SSE classes (3728b09)
• update mock server docs (2cd81c5)

4.6.1 (2026-02-13)

Full Changelog: v4.6.0...v4.6.1

Bug Fixes

• api: Remove invalid 4.5 i2v ratio (f2fa3d1)

Chores

• format all api.md files (83ca516)
• internal: fix lint error on Python 3.14 (73b877b)

4.6.0 (2026-02-11)

Full Changelog: v4.5.0...v4.6.0

Features

• api: Gen-4.5 t2v+i2v (cd2b196)

Bug Fixes

• client: Update generated types for 4.5 t2v (f024d8e)

Chores

• internal: bump dependencies (c8073c8)

4.5.0 (2026-02-03)

Full Changelog: v4.4.0...v4.5.0

Features

• api: Deprecate v2v ratio (16eb2de)

4.4.0 (2026-01-30)

Full Changelog: v4.3.0...v4.4.0

Features

• client: add custom JSON encoder for extended type support (b04154d)

Chores

• ci: upgrade actions/github-script (c05f08a)
• internal: update actions/checkout version (ab246dd)

4.3.0 (2026-01-17)

Full Changelog: v4.2.0...v4.3.0

Features

• api: Sunset upscale endpoint (a0b9bbe)
• client: add support for binary request streaming (384cd8b)

Bug Fixes

• types: allow pyright to infer TypedDict types within SequenceNotStr (9d4f77c)
• use async_to_httpx_files in patch method (c6b8802)

Chores

• add missing docstrings (4c14222)
• internal: add --fix argument to lint script (4e5931e)
• internal: add missing files argument to base client (1c5f3af)
• internal: codegen related update (feac569)
• speedup initial import (cfcc2e9)

4.2.0 (2025-12-04)

Full Changelog: v4.1.1...v4.2.0

Features

• api: Autogen spec updates (e9d2114)
• api: gemini_3_pro t2i (1f1fcfa)
• api: gemini_3_pro t2i (ea8a4ec)
• api: Remove unreleased model (ee474d5)
• api: Revert G3P changes (3959ddf)

Chores

• docs: use environment variables for authentication in code snippets (cd6776e)
• update lockfile (7199587)

4.1.1 (2025-11-28)

Full Changelog: v4.1.0...v4.1.1

Bug Fixes

• ensure streams are always closed (22486c4)

Chores

• add Python 3.14 classifier and testing (6dd0b91)
• deps: mypy 1.18.1 has a regression, pin to 1.17 (1813032)

4.1.0 (2025-11-17)

Full Changelog: v4.0.1...v4.1.0

Features

• api: veo3.1 audio parameter (0c12058)

4.0.1 (2025-11-12)

Full Changelog: v4.0.0...v4.0.1

Bug Fixes

• compat: update signatures of model_dump and model_dump_json for Pydantic v1 (4404c28)

4.0.0 (2025-11-11)

Full Changelog: v3.22.0...v4.0.0

Bug Fixes

• compat with Python 3.14 (66b332c)

Chores

• package: drop Python 3.8 support (0bb6132)

3.22.0 (2025-11-06)

Full Changelog: v3.21.0...v3.22.0

Features

• api: Support ephemeral uploads (d310ee0)

3.21.0 (2025-11-04)

Full Changelog: v3.20.1...v3.21.0

Features

• api: Resolve missing prompt_image unions (c5dca58)
• api: Update discriminated union schema (65b09c3)
• client: Resolve i2v overload return type conflict (17a5eb8)
• client: Resolve t2v overload return type conflict (dfdf65b)

Chores

• internal/tests: avoid race condition with implicit client cleanup (0c8aaf7)
• internal: grammar fix (it's -> its) (ca4ee8d)

3.20.1 (2025-10-30)

Full Changelog: v3.20.0...v3.20.1

Bug Fixes

• client: close streams without requiring full consumption (2c8d121)

3.20.0 (2025-10-22)

Full Changelog: v3.19.0...v3.20.0

Features

• api: Add speech to speech (8757b22)
• api: Added speech to speech (a2cb1d2)

Chores

• bump httpx-aiohttp version to 0.1.9 (7a11662)

3.19.0 (2025-10-15)

Full Changelog: v3.18.0...v3.19.0

Features

• api: Veo 3.1 and Veo 3.1 Fast (9486ec1)

Bug Fixes

• api: Add missing 1080p sizes (2c66c5a)

3.18.0 (2025-10-14)

Full Changelog: v3.17.0...v3.18.0

Features

• api: Voice dubbing and isolation (0bdaaed)

Chores

• internal: detect missing future annotations with ruff (b85be28)

3.17.0 (2025-10-09)

Full Changelog: v3.16.0...v3.17.0

Features

• api: Sound effects endpoint (dbb791b)

3.16.0 (2025-10-08)

Full Changelog: v3.15.0...v3.16.0

Features

• api: Additional i2v durations (6990b2f)

3.15.0 (2025-09-23)

Full Changelog: v3.14.2...v3.15.0

Features

• api: Text to Speech update (c43cd76)
• client: Make t2s awaitable (068275c)
• docs: Update docs URL (7ab9607)

3.14.2 (2025-09-20)

Full Changelog: v3.14.1...v3.14.2

Chores

• do not install brew dependencies in ./scripts/bootstrap by default (579613c)
• types: change optional parameter type from NotGiven to Omit (1d63c89)

3.14.1 (2025-09-17)

Full Changelog: v3.14.0...v3.14.1

Chores

• internal: update pydantic dependency (6d91907)

3.14.0 (2025-09-11)

Full Changelog: v3.13.0...v3.14.0

Features

• api: Add Gemini 2.5 Flash Image to t2i (3cb044a)

3.13.0 (2025-09-10)

Full Changelog: v3.12.1...v3.13.0

Features

• api: Update t2v parameters (7163db8)
• api: Veo3 integration (37e7224)
• client: Make t2v waitable (d21c4e4)

3.12.1 (2025-09-06)

Full Changelog: v3.12.0...v3.12.1

Chores

• internal: move mypy configurations to pyproject.toml file (0ff4ea5)
• tests: simplify get_platform test (5b651b2)

3.12.0 (2025-09-04)

Full Changelog: v3.11.0...v3.12.0

Features

• improve future compat with pydantic v3 (9207df5)

3.11.0 (2025-09-03)

Full Changelog: v3.10.3...v3.11.0

Features

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

3.10.3 (2025-08-30)

Full Changelog: v3.10.2...v3.10.3

Chores

• internal: add Sequence related utils (520aeec)

3.10.2 (2025-08-27)

Full Changelog: v3.10.1...v3.10.2

Bug Fixes

• avoid newer type syntax (54dd3a0)

Chores

• internal: change ci workflow machines (986c007)
• internal: update comment in script (48cad7b)
• internal: update pyright exclude list (03a8696)
• update github action (2fd7626)

3.10.1 (2025-08-09)

Full Changelog: v3.10.0...v3.10.1

Chores

• internal: fix ruff target version (cce2c55)
• update @stainless-api/prism-cli to v5.15.0 (b1ea815)

3.10.0 (2025-08-05)

Full Changelog: v3.9.0...v3.10.0

Features

• api: Add gen4_image_turbo model (5d5aab2)
• readme: Fix for readme example (083bb47)
• readme: gen4_turbo ratio (7a5a486)

3.9.0 (2025-08-01)

Full Changelog: v3.8.0...v3.9.0

Features

• api: Gen-4 Aleph (b1cf4db)

3.8.0 (2025-07-31)

Full Changelog: v3.7.2...v3.8.0

Features

• client: support file upload requests (9a12ee4)

Chores

• project: add settings file for vscode (d2a3908)

3.7.2 (2025-07-23)

Full Changelog: v3.7.1...v3.7.2

Bug Fixes

• parsing: parse extra field types (dc5dd24)

3.7.1 (2025-07-22)

Full Changelog: v3.7.0...v3.7.1

Bug Fixes

• parsing: ignore empty metadata (33c5e49)

3.7.0 (2025-07-19)

Full Changelog: v3.6.5...v3.7.0

Features

• api: Act Two, credit usage endpoints (f1114e0)
• api: Awaitability on new resources (7612c78)
• clean up environment call outs (caa8eff)

Chores

• client: lint (d745891)

3.6.5 (2025-07-12)

Full Changelog: v3.6.4...v3.6.5

Bug Fixes

• client: don't send Content-Type header on GET requests (6567867)

Chores

• readme: fix version rendering on pypi (f38de2a)

3.6.4 (2025-07-10)

Full Changelog: v3.6.3...v3.6.4

Bug Fixes

• parsing: correctly handle nested discriminated unions (813daf2)

3.6.3 (2025-07-09)

Full Changelog: v3.6.2...v3.6.3

Chores

• internal: bump pinned h11 dep (25ee0aa)
• package: mark python 3.13 as supported (b50298a)

3.6.2 (2025-07-08)

Full Changelog: v3.6.1...v3.6.2

Bug Fixes

• ci: correct conditional (04df1e3)
• ci: release-doctor — report correct token name (5c77b20)

Chores

• ci: change upload type (1ca0a49)
• ci: only run for pushes and fork pull requests (0821c24)
• internal: codegen related update (cfd7b38)

3.6.1 (2025-06-24)

Full Changelog: v3.6.0...v3.6.1

Chores

• tests: skip some failing tests on the latest python versions (732236d)

3.6.0 (2025-06-23)

Full Changelog: v3.5.0...v3.6.0

Features

• client: add support for aiohttp (7d5490c)

Bug Fixes

• tests: fix: tests which call HTTP endpoints directly with the example parameters (33301dd)

Chores

• readme: update badges (147dc95)

Documentation

• client: fix httpx.Timeout documentation reference (af9fecb)

3.5.0 (2025-06-17)

Full Changelog: v3.4.0...v3.5.0

Features

• api: SDK updates, contentModeration for i2v (1286e32)
• api: SDK updates, contentModeration for i2v (8ff202e)

Bug Fixes

• client: correctly parse binary response | stream (fc9bedb)

Chores

• ci: enable for pull requests (4b439c9)
• internal: update conftest.py (0ff71fd)
• tests: add tests for httpx client instantiation & proxies (89e5fbe)
• tests: run tests in parallel (7edbcd1)

3.4.0 (2025-06-04)

Full Changelog: v3.3.0...v3.4.0

Features

• api: Add video upscale endpoint (aac6a70)

3.3.0 (2025-06-04)

Full Changelog: v3.2.0...v3.3.0

Features

• client: add follow_redirects request option (742ca3b)

Bug Fixes

• docs: fix confusing example in README (54904f7)

Chores

• docs: remove reference to rye shell (e207562)
• docs: remove unnecessary param examples (d1ca063)

3.2.0 (2025-05-29)

Full Changelog: v3.1.0...v3.2.0

Features

• api: Add 720p t2i ratios (b722686)

Chores

• docs: grammar improvements (fbf2481)

3.1.0 (2025-05-16)

Full Changelog: v3.0.6...v3.1.0

Features

• api: Gen-4 Image (text-to-image) support (8adcf96)

Chores

• ci: fix installation instructions (a04350d)

3.0.6 (2025-05-15)

Full Changelog: v3.0.5...v3.0.6

Chores

• ci: upload sdks to package manager (23f0756)

3.0.5 (2025-05-10)

Full Changelog: v3.0.4...v3.0.5

Bug Fixes

• package: support direct resource imports (f317064)

Chores

• internal: avoid errors for isinstance checks on proxies (a549b98)

3.0.4 (2025-04-30)

Full Changelog: v3.0.3...v3.0.4

Bug Fixes

• api: Fix for parameters with missing descriptions (1ab27c6)
• api: Make ratio a required parameter for i2v (e1b73a5)

3.0.3 (2025-04-24)

Full Changelog: v3.0.2...v3.0.3

Bug Fixes

• pydantic v1: more robust ModelField.annotation check (1f45aa4)

Chores

• broadly detect json family of content-type headers (7adcad9)
• ci: add timeout thresholds for CI jobs (a59f6e6)
• ci: only use depot for staging repos (bdd8635)
• internal: codegen related update (6ec7118)
• internal: fix list file params (c745a86)
• internal: import reformatting (a991a2d)
• internal: minor formatting changes (0f34a44)
• internal: refactor retries to not use recursion (b5637fb)
• internal: update models test (79488d6)

3.0.2 (2025-04-17)

Full Changelog: v3.0.1...v3.0.2

Chores

• internal: base client updates (6d4d8bb)
• internal: bump pyright version (5693e26)

3.0.1 (2025-04-15)

Full Changelog: v3.0.0...v3.0.1

Bug Fixes

• perf: optimize some hot paths (0c187d1)
• perf: skip traversing types for NotGiven values (a65d4b0)

Chores

• client: minor internal fixes (09dd17f)
• internal: expand CI branch coverage (8bde5ff)
• internal: reduce CI branch coverage (5892e7a)
• internal: update pyright settings (8b3a8ae)

3.0.0 (2025-04-09)

Full Changelog: v2.3.8...v3.0.0

Features

• api: Update with gen4_turbo, org endpoint (#135) (7f5d1ae)

Chores

• internal: remove trailing character (#132) (cd78e34)
• internal: slight transform perf improvement (#134) (33e5a68)

2.3.8 (2025-03-27)

Full Changelog: v2.3.7...v2.3.8

Chores

• fix typos (#129) (c8047c8)

2.3.7 (2025-03-17)

Full Changelog: v2.3.6...v2.3.7

Bug Fixes

• ci: ensure pip is always available (#123) (e456349)
• ci: remove publishing patch (#125) (3592469)

2.3.6 (2025-03-15)

Full Changelog: v2.3.5...v2.3.6

Bug Fixes

• types: handle more discriminated union shapes (#121) (51f8b42)

Chores

• internal: bump rye to 0.44.0 (#120) (ea18df4)
• internal: codegen related update (#119) (e72357e)
• internal: remove extra empty newlines (#117) (4f0e93e)

2.3.5 (2025-03-11)

Full Changelog: v2.3.4...v2.3.5

2.3.4 (2025-03-04)

Full Changelog: v2.3.3...v2.3.4

Chores

• internal: remove unused http client options forwarding (#111) (c0fa5a9)

2.3.3 (2025-02-28)

Full Changelog: v2.3.2...v2.3.3

Chores

• docs: update client docstring (#108) (3a6daf5)

Documentation

• update URLs from stainlessapi.com to stainless.com (#107) (efae113)

2.3.2 (2025-02-26)

Full Changelog: v2.3.1...v2.3.2

Chores

• internal: properly set pydantic_private (#104) (2d7a59f)

2.3.1 (2025-02-22)

Full Changelog: v2.3.0...v2.3.1

Chores

• internal: fix devcontainers setup (#101) (7a01b9a)

2.3.0 (2025-02-21)

Full Changelog: v2.2.2...v2.3.0

Features

• client: allow passing NotGiven for body (#98) (fda401a)

Bug Fixes

• client: mark some request bodies as optional (fda401a)

2.2.2 (2025-02-14)

Full Changelog: v2.2.1...v2.2.2

Bug Fixes

• asyncify on non-asyncio runtimes (#96) (c478bc7)

Chores

• internal: update client tests (#94) (d8892cd)

2.2.1 (2025-02-07)

Full Changelog: v2.2.0...v2.2.1

Chores

• internal: fix type traversing dictionary params (#90) (49d44b9)
• internal: minor type handling changes (#92) (f4f122f)

2.2.0 (2025-02-06)

Full Changelog: v2.1.11...v2.2.0

Features

• client: send X-Stainless-Read-Timeout header (#87) (43e6f00)

2.1.11 (2025-02-04)

Full Changelog: v2.1.10...v2.1.11

Chores

• internal: bummp ruff dependency (#83) (3d1be9d)
• internal: change default timeout to an int (#82) (38e5767)

2.1.10 (2025-01-24)

Full Changelog: v2.1.9...v2.1.10

Chores

• internal: minor formatting changes (#80) (067f47a)
• internal: minor style changes (#78) (bd0eb4a)

2.1.9 (2025-01-21)

Full Changelog: v2.1.8...v2.1.9

Bug Fixes

• add back missing docstrings (#73) (8eac71e)
• client: only call .close() when needed (#69) (4a48c73)
• correctly handle deserialising cls fields (#71) (6db1a75)
• tests: make test_get_platform less flaky (#75) (7199a24)

Chores

• internal: avoid pytest-asyncio deprecation warning (#76) (bff6464)
• internal: codegen related update (#67) (027aa11)
• internal: codegen related update (#70) (38c71dc)
• internal: codegen related update (#72) (d4b14b4)

Documentation

• raw responses: fix duplicate the (#74) (0d563ee)

2.1.8 (2025-01-08)

Full Changelog: v2.1.7...v2.1.8

Chores

• add missing isclass check (#64) (a90a201)

2.1.7 (2025-01-02)

Full Changelog: v2.1.6...v2.1.7

Chores

• internal: codegen related update (#61) (6248aa2)

2.1.6 (2024-12-18)

Full Changelog: v2.1.5...v2.1.6

Chores

• internal: codegen related update (#48) (f999274)
• internal: codegen related update (#50) (187e174)
• internal: codegen related update (#51) (1c70164)
• internal: codegen related update (#52) (07e7dda)
• internal: codegen related update (#54) (5540248)
• internal: codegen related update (#55) (75daba1)
• internal: codegen related update (#56) (c98ed80)
• internal: fix some typos (#58) (404c771)

Documentation

• readme: example snippet for client context manager (#57) (e62b5e9)

2.1.5 (2024-12-13)

Full Changelog: v2.1.4...v2.1.5

Chores

• internal: add support for TypeAliasType (#46) (278afad)
• internal: bump pyright (#44) (eb51ffa)

2.1.4 (2024-12-10)

Full Changelog: v2.1.3...v2.1.4

Chores

• internal: bump pydantic dependency (#40) (ae3a845)

Documentation

• readme: fix http client proxies example (#42) (d1389f7)

2.1.3 (2024-12-04)

Full Changelog: v2.1.2...v2.1.3

Chores

• make the Omit type public (#35) (a333528)

2.1.2 (2024-12-03)

Full Changelog: v2.1.1...v2.1.2

Chores

• internal: bump pyright (#32) (7d36972)

2.1.1 (2024-11-28)

Full Changelog: v2.1.0...v2.1.1

Bug Fixes

• client: compat with new httpx 0.28.0 release (#28) (f5e637e)

Chores

• internal: exclude mypy from running on tests (#27) (d724387)
• internal: fix compat model_dump method when warnings are passed (#24) (61c8490)
• rebuild project due to codegen change (#19) (2a4cf56)
• rebuild project due to codegen change (#21) (e680d5b)
• rebuild project due to codegen change (#22) (ecddf51)
• remove now unused cached-property dep (#26) (21e64d0)

Documentation

• add info log level to readme (#25) (d6e4ed4)

2.1.0 (2024-11-06)

Full Changelog: v2.0.0...v2.1.0

Features

• api: API version 2024-11-06 (#15) (39c096f)
• api: Set latest default API version (#17) (2ad66fd)

2.0.0 (2024-10-04)

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

Features

• api: update via SDK Studio (#7) (e31ea2c)

Chores

• internal: codegen related update (#10) (b1b5a5f)
• internal: codegen related update (#11) (6a8ccd0)
• internal: codegen related update (#8) (c66ad91)

1.0.0 (2024-09-18)

Full Changelog: v0.1.0-alpha.1...v1.0.0

Chores

• update SDK settings (#4) (50c8fb7)

0.1.0-alpha.1 (2024-09-16)

Full Changelog: v0.0.1-alpha.0...v0.1.0-alpha.1

Features

• api: update via SDK Studio (d2b36be)
• api: update via SDK Studio (458cea2)
• api: update via SDK Studio (8218b59)

Chores

• go live (#1) (9de5b2d)
• internal: bump pyright / mypy version (329a9ff)
• internal: bump ruff (8152032)
• internal: codegen related update (05e04a7)
• internal: codegen related update (a6d2ae7)

Documentation

• update CONTRIBUTING.md (3fd55c0)