5.24.0 (2026-10-23)
- Add Kling 4.0 text-to-video, image-to-video, and video-to-video generation.
- Support pixel output ratios for text-to-video and automatic 720p or 1080p sizing across Kling 4.0 endpoints.
- Kling 4.0 task responses support
wait_for_task_output()in both synchronous and asynchronous clients.
5.23.0 (2026-10-23)
- add Nano Banana 2 Lite and expand image and video model support (5f5ae46)
- add video-to-audio and newly released image and audio models (a12ad7f)
- internal: align waitable overload return types (fb3e261)
5.22.0 (2026-10-13)
- add Ideogram 4.0 (
ideogram_4_0) and Ideogram 4.5 (ideogram_4_5) to text-to-image
5.21.0 (2026-10-02)
- add Grok Imagine Video 1.5 Lite (
grok_imagine_1_5_lite) to text-to-video and image-to-video - add Eleven v4 (
eleven_v4) text-to-speech
- add new audit-log event types (including
MemberJoinedViaDomain,UserGroupCreditCapUpdated,StudioSessionOpened,OrganizationAgentSandboxUpdated, and ad-connection events) and their metadata fields - add optional
costto workflow invocations, reported once every task in the run is terminal - include
grok_imagine_1_5_liteandeleven_v4in organization usage results
- client: make
grok_imagine_1_5_liteandeleven_v4responses awaitable
5.20.1 (2026-09-23)
- add GPT Image 2.5 Flare and Sunburst, including background, quality, output count, and tagged reference-image options
- add frame-rate enhancement with selectable target frame rates
- expose workflow node failure codes and document how to detect partial workflow runs
- represent unlimited organization model limits as
null - include AWS Marketplace subscription-linking events and additional audit-log metadata
- clarify HDR alpha-channel and ACEScg delivery behavior
5.20.0 (2026-09-04)
- add new models, image options, and audit-log actions (856ccb5)
- reset generated Python SDK update (d865a54)
5.19.1 (2026-09-02)
- reject unknown router and Veo fields (721cbba)
5.19.0 (2026-09-02)
- add image generation options (2a755a9)
5.18.0 (2026-09-01)
- add Seedance and Veo generation options (da970e1)
- stlc: back-sync when trees match but histories diverge (97da4f1)
- stlc: back-sync when trees match but histories diverge (10363ed)
- stlc: no-op back-sync when staging already contains production (1931c36)
- stlc: no-op back-sync when staging already contains production (64c5204)
5.17.1 (2026-08-31)
- cap media data URIs at 5MB (fdbef03)
Full Changelog: v5.16.2...v5.17.0
- initial stlc build (948957a)
- preserve waitable create response types (#2) (e05746a)
- restore waitable Video-to-HDR responses (#3) (d36c0c8)
Full Changelog: v5.16.1...v5.16.2
- ci: also publish on v* tag push (f351d01)
Full Changelog: v5.16.0...v5.16.1
- client: restore waitable wraps and uploads after stlc cutover (e4d247f)
Full Changelog: v5.15.0...v5.16.0
- api: add video_to_hdr (ruby) (7d46450)
- api: add HDR outputFormat on gen4.5 (text/image-to-video) and sdr_rec709_10bit on aleph2 (7d46450)
- client: make video_to_hdr waitable (0a14fa2)
- client: drop duplicate generate/routers properties (499c3c8)
- client: restore Client/AsyncClient aliases (a45e3af)
Full Changelog: v5.14.0...v5.15.0
- api: add 1080p on seedance2_5 (text/image/video-to-video) (46f53db)
- api: add grok_imagine_1_5 (text/image-to-video) (46f53db)
- api: add grok_imagine_image_2 (text-to-image) (46f53db)
- client: make grok_imagine_1_5 and grok_imagine_image_2 responses awaitable (87046d8)
Full Changelog: v5.13.0...v5.14.0
- api: add hailuo3 and seedance2_5 (text/image/video-to-video) (37f2ab3)
- api: add eleven_v3 text-to-speech (37f2ab3)
- api: add Model Router request history and capacity fallback (37f2ab3)
- api: add organization webapp usage and audit logs (37f2ab3)
- api: expose task cost / estimatedCost on retrieve (37f2ab3)
- api: add text-to-image grounding (37f2ab3)
- client: include every overload's type in union method implementation signatures (cf9feee)
- client: make hailuo3, seedance2_5, eleven_v3 responses awaitable (eaf97ec)
Full Changelog: v5.12.0...v5.13.0
- api: Update OpenAPI copy for asset URL and media field descriptions (92684d7)
Full Changelog: v5.11.0...v5.12.0
- api: add Model Router image and audio generation (e9f38d4)
- api: expose generate image and audio endpoints (d19bc95)
- client: make generate.image and generate.audio responses awaitable (d4900ac)
- openapi: keep generate.video SDK schema task-only (4b6e6c4)
Full Changelog: v5.10.0...v5.11.0
- api: add Model Router CRUD and routed video generation (05df606)
- stlc: configurable CI runner and private-production-repo support in workflow templates (d83d189)
- client: make generate.video responses awaitable (9c4e62a)
Full Changelog: v5.9.0...v5.10.0
- api: Seedream 5 Pro/Lite + negativePrompt for Veo models (f98699c)
- client: make seedream5_pro and seedream5_lite responses awaitable (980b632)
Full Changelog: v5.8.0...v5.9.0
- api: add ad_localization recipe (0e13593)
Full Changelog: v5.7.0...v5.8.0
- api: add realtime session external integrations (a4aeded)
Full Changelog: v5.6.0...v5.7.0
- api: add seed_audio model (f1def20)
Full Changelog: v5.5.0...v5.6.0
- api: add seedance2_mini and gemini_omni_flash models (24c83da)
Full Changelog: v5.4.0...v5.5.0
- api: add outputCount and quality to marketing stock image (4fe47ce)
Full Changelog: v5.3.0...v5.4.0
Full Changelog: v5.2.0...v5.3.0
- api: document product_ad 2026-07 (e1e5eeb)
Full Changelog: v5.1.0...v5.2.0
- api: Recipes, aleph2 range (529fc1d)
- client: add recipe endpoints to config (26725b1)
- client: Make recipes waitable (11dbef5)
- api: remove range param (f67c02d)
Full Changelog: v5.0.0...v5.1.0
- api: add outpaint support for Aleph 2.0 (673817e)
Full Changelog: v4.18.0...v5.0.0
- api: Add new avatar and voice routes (36d836d)
- api: update the right config file this time (0ddcaf5)
Full Changelog: v4.17.0...v4.18.0
- api: seedance2_fast (90bc24e)
- client: Make sd2_fast responses awaitable (3d2d3ac)
Full Changelog: v4.16.0...v4.17.0
- api: SD2, HH1 (e457b11)
- client: Make SD2 and HH1 awaitable for task output (894c22f)
Full Changelog: v4.15.0...v4.16.0
- client: Awaitable image upscale also (346f07f)
- client: Updating typing for awaitable task output (485c29c)
Full Changelog: v4.14.0...v4.15.0
- internal/types: support eagerly validating pydantic iterators (67267fb)
Full Changelog: v4.13.0...v4.14.0
- api: Fix bad extra param (f892e71)
- client: add missing f-string prefix in file type error message (52abe91)
- client: Fix types for gpt_image_2 (28fba38)
- internal: reformat pyproject.toml (3f300f0)
Full Changelog: v4.12.0...v4.13.0
- support setting headers via env (fdfdafb)
- use correct field name format for multipart file arrays (e7a8c90)
- client: optimize file structure copying in multipart requests (c5be409)
Full Changelog: v4.11.0...v4.12.0
Full Changelog: v4.10.0...v4.11.0
- api: add avatar_videos resource (75b6ded)
- polling: add wait_for_task_output to avatar_videos.create (e8fe41b)
- client: preserve hardcoded query params when merging with user params (839c38b)
- pin GitHub Actions to full commit SHAs (8f7689b)
Full Changelog: v4.9.0...v4.10.0
- api: add tools parameter to realtime sessions (c06a7f0)
- internal: implement indices array format for query and form serialization (d8fecc7)
Full Changelog: v4.8.0...v4.9.0
- api: add workflow invocation polling support (6eb6fc5)
- api: add workflows and workflow invocations resources (35d8573)
- sanitize endpoint path params (84efc12)
- 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)
- introduce dedicated error types for workflow invocation polling (420f91c)
- tests: switch from prism to steady (0a1bb5a)
Full Changelog: v4.7.1...v4.8.0
- api: Add document update endpoint (f9f8a7d)
Full Changelog: v4.7.0...v4.7.1
- deps: bump minimum typing-extensions version (69d3f16)
- pydantic: do not pass
by_aliasunless set (cae07b4)
- ci: skip uploading artifacts on stainless-internal branches (f153e58)
- internal: tweak CI branches (f4d6103)
Full Changelog: v4.6.3...v4.7.0
- api: add avatar, voice, document, and realtime session endpoints (18b1573)
- test: do not count install time for mock server timeout (84988e1)
Full Changelog: v4.6.2...v4.6.3
- docs: add missing descriptions (f64ea7b)
- internal: make
test_proxy_environment_variablesmore resilient (b0a3688) - internal: make
test_proxy_environment_variablesmore resilient to env (dd8ca18)
Full Changelog: v4.6.1...v4.6.2
Full Changelog: v4.6.0...v4.6.1
- api: Remove invalid 4.5 i2v ratio (f2fa3d1)
Full Changelog: v4.5.0...v4.6.0
- api: Gen-4.5 t2v+i2v (cd2b196)
- client: Update generated types for 4.5 t2v (f024d8e)
- internal: bump dependencies (c8073c8)
Full Changelog: v4.4.0...v4.5.0
- api: Deprecate v2v ratio (16eb2de)
Full Changelog: v4.3.0...v4.4.0
- client: add custom JSON encoder for extended type support (b04154d)
Full Changelog: v4.2.0...v4.3.0
- types: allow pyright to infer TypedDict types within SequenceNotStr (9d4f77c)
- use async_to_httpx_files in patch method (c6b8802)
- add missing docstrings (4c14222)
- internal: add
--fixargument to lint script (4e5931e) - internal: add missing files argument to base client (1c5f3af)
- internal: codegen related update (feac569)
- speedup initial import (cfcc2e9)
Full Changelog: v4.1.1...v4.2.0
- 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)
- docs: use environment variables for authentication in code snippets (cd6776e)
- update lockfile (7199587)
Full Changelog: v4.1.0...v4.1.1
- ensure streams are always closed (22486c4)
- add Python 3.14 classifier and testing (6dd0b91)
- deps: mypy 1.18.1 has a regression, pin to 1.17 (1813032)
Full Changelog: v4.0.1...v4.1.0
- api: veo3.1 audio parameter (0c12058)
Full Changelog: v4.0.0...v4.0.1
- compat: update signatures of
model_dumpandmodel_dump_jsonfor Pydantic v1 (4404c28)
Full Changelog: v3.22.0...v4.0.0
- compat with Python 3.14 (66b332c)
- package: drop Python 3.8 support (0bb6132)
Full Changelog: v3.21.0...v3.22.0
- api: Support ephemeral uploads (d310ee0)
Full Changelog: v3.20.1...v3.21.0
- 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)
- internal/tests: avoid race condition with implicit client cleanup (0c8aaf7)
- internal: grammar fix (it's -> its) (ca4ee8d)
Full Changelog: v3.20.0...v3.20.1
- client: close streams without requiring full consumption (2c8d121)
Full Changelog: v3.19.0...v3.20.0
- bump
httpx-aiohttpversion to 0.1.9 (7a11662)
Full Changelog: v3.18.0...v3.19.0
- api: Veo 3.1 and Veo 3.1 Fast (9486ec1)
- api: Add missing 1080p sizes (2c66c5a)
Full Changelog: v3.17.0...v3.18.0
- api: Voice dubbing and isolation (0bdaaed)
- internal: detect missing future annotations with ruff (b85be28)
Full Changelog: v3.16.0...v3.17.0
- api: Sound effects endpoint (dbb791b)
Full Changelog: v3.15.0...v3.16.0
- api: Additional i2v durations (6990b2f)
Full Changelog: v3.14.2...v3.15.0
- api: Text to Speech update (c43cd76)
- client: Make t2s awaitable (068275c)
- docs: Update docs URL (7ab9607)
Full Changelog: v3.14.1...v3.14.2
- do not install brew dependencies in ./scripts/bootstrap by default (579613c)
- types: change optional parameter type from NotGiven to Omit (1d63c89)
Full Changelog: v3.14.0...v3.14.1
- internal: update pydantic dependency (6d91907)
Full Changelog: v3.13.0...v3.14.0
- api: Add Gemini 2.5 Flash Image to t2i (3cb044a)
Full Changelog: v3.12.1...v3.13.0
- api: Update t2v parameters (7163db8)
- api: Veo3 integration (37e7224)
- client: Make t2v waitable (d21c4e4)
Full Changelog: v3.12.0...v3.12.1
- internal: move mypy configurations to
pyproject.tomlfile (0ff4ea5) - tests: simplify
get_platformtest (5b651b2)
Full Changelog: v3.11.0...v3.12.0
- improve future compat with pydantic v3 (9207df5)
Full Changelog: v3.10.3...v3.11.0
- types: replace List[str] with SequenceNotStr in params (a55b44c)
Full Changelog: v3.10.2...v3.10.3
- internal: add Sequence related utils (520aeec)
Full Changelog: v3.10.1...v3.10.2
- avoid newer type syntax (54dd3a0)
- internal: change ci workflow machines (986c007)
- internal: update comment in script (48cad7b)
- internal: update pyright exclude list (03a8696)
- update github action (2fd7626)
Full Changelog: v3.10.0...v3.10.1
Full Changelog: v3.9.0...v3.10.0
- api: Add gen4_image_turbo model (5d5aab2)
- readme: Fix for readme example (083bb47)
- readme: gen4_turbo ratio (7a5a486)
Full Changelog: v3.8.0...v3.9.0
- api: Gen-4 Aleph (b1cf4db)
Full Changelog: v3.7.2...v3.8.0
- client: support file upload requests (9a12ee4)
- project: add settings file for vscode (d2a3908)
Full Changelog: v3.7.1...v3.7.2
- parsing: parse extra field types (dc5dd24)
Full Changelog: v3.7.0...v3.7.1
- parsing: ignore empty metadata (33c5e49)
Full Changelog: v3.6.5...v3.7.0
- api: Act Two, credit usage endpoints (f1114e0)
- api: Awaitability on new resources (7612c78)
- clean up environment call outs (caa8eff)
- client: lint (d745891)
Full Changelog: v3.6.4...v3.6.5
- client: don't send Content-Type header on GET requests (6567867)
- readme: fix version rendering on pypi (f38de2a)
Full Changelog: v3.6.3...v3.6.4
- parsing: correctly handle nested discriminated unions (813daf2)
Full Changelog: v3.6.2...v3.6.3
Full Changelog: v3.6.1...v3.6.2
- ci: change upload type (1ca0a49)
- ci: only run for pushes and fork pull requests (0821c24)
- internal: codegen related update (cfd7b38)
Full Changelog: v3.6.0...v3.6.1
- tests: skip some failing tests on the latest python versions (732236d)
Full Changelog: v3.5.0...v3.6.0
- client: add support for aiohttp (7d5490c)
- tests: fix: tests which call HTTP endpoints directly with the example parameters (33301dd)
- readme: update badges (147dc95)
- client: fix httpx.Timeout documentation reference (af9fecb)
Full Changelog: v3.4.0...v3.5.0
- api: SDK updates, contentModeration for i2v (1286e32)
- api: SDK updates, contentModeration for i2v (8ff202e)
- client: correctly parse binary response | stream (fc9bedb)
- 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)
Full Changelog: v3.3.0...v3.4.0
- api: Add video upscale endpoint (aac6a70)
Full Changelog: v3.2.0...v3.3.0
- client: add follow_redirects request option (742ca3b)
- docs: fix confusing example in README (54904f7)
Full Changelog: v3.1.0...v3.2.0
- api: Add 720p t2i ratios (b722686)
- docs: grammar improvements (fbf2481)
Full Changelog: v3.0.6...v3.1.0
- api: Gen-4 Image (text-to-image) support (8adcf96)
- ci: fix installation instructions (a04350d)
Full Changelog: v3.0.5...v3.0.6
- ci: upload sdks to package manager (23f0756)
Full Changelog: v3.0.4...v3.0.5
- package: support direct resource imports (f317064)
- internal: avoid errors for isinstance checks on proxies (a549b98)
Full Changelog: v3.0.3...v3.0.4
- api: Fix for parameters with missing descriptions (1ab27c6)
- api: Make
ratioa required parameter for i2v (e1b73a5)
Full Changelog: v3.0.2...v3.0.3
- pydantic v1: more robust ModelField.annotation check (1f45aa4)
- 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)
Full Changelog: v3.0.1...v3.0.2
Full Changelog: v3.0.0...v3.0.1
- client: minor internal fixes (09dd17f)
- internal: expand CI branch coverage (8bde5ff)
- internal: reduce CI branch coverage (5892e7a)
- internal: update pyright settings (8b3a8ae)
Full Changelog: v2.3.8...v3.0.0
- internal: remove trailing character (#132) (cd78e34)
- internal: slight transform perf improvement (#134) (33e5a68)
Full Changelog: v2.3.7...v2.3.8
Full Changelog: v2.3.6...v2.3.7
Full Changelog: v2.3.5...v2.3.6
- internal: bump rye to 0.44.0 (#120) (ea18df4)
- internal: codegen related update (#119) (e72357e)
- internal: remove extra empty newlines (#117) (4f0e93e)
Full Changelog: v2.3.4...v2.3.5
Full Changelog: v2.3.3...v2.3.4
Full Changelog: v2.3.2...v2.3.3
Full Changelog: v2.3.1...v2.3.2
Full Changelog: v2.3.0...v2.3.1
Full Changelog: v2.2.2...v2.3.0
- client: mark some request bodies as optional (fda401a)
Full Changelog: v2.2.1...v2.2.2
Full Changelog: v2.2.0...v2.2.1
- internal: fix type traversing dictionary params (#90) (49d44b9)
- internal: minor type handling changes (#92) (f4f122f)
Full Changelog: v2.1.11...v2.2.0
Full Changelog: v2.1.10...v2.1.11
- internal: bummp ruff dependency (#83) (3d1be9d)
- internal: change default timeout to an int (#82) (38e5767)
Full Changelog: v2.1.9...v2.1.10
Full Changelog: v2.1.8...v2.1.9
- add back missing docstrings (#73) (8eac71e)
- client: only call .close() when needed (#69) (4a48c73)
- correctly handle deserialising
clsfields (#71) (6db1a75) - tests: make test_get_platform less flaky (#75) (7199a24)
- 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)
Full Changelog: v2.1.7...v2.1.8
Full Changelog: v2.1.6...v2.1.7
Full Changelog: v2.1.5...v2.1.6
- 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)
Full Changelog: v2.1.4...v2.1.5
Full Changelog: v2.1.3...v2.1.4
Full Changelog: v2.1.2...v2.1.3
Full Changelog: v2.1.1...v2.1.2
Full Changelog: v2.1.0...v2.1.1
- 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-propertydep (#26) (21e64d0)
Full Changelog: v2.0.0...v2.1.0
Full Changelog: v1.0.0...v2.0.0
- internal: codegen related update (#10) (b1b5a5f)
- internal: codegen related update (#11) (6a8ccd0)
- internal: codegen related update (#8) (c66ad91)
Full Changelog: v0.1.0-alpha.1...v1.0.0
Full Changelog: v0.0.1-alpha.0...v0.1.0-alpha.1
- api: update via SDK Studio (d2b36be)
- api: update via SDK Studio (458cea2)
- api: update via SDK Studio (8218b59)
- go live (#1) (9de5b2d)
- internal: bump pyright / mypy version (329a9ff)
- internal: bump ruff (8152032)
- internal: codegen related update (05e04a7)
- internal: codegen related update (a6d2ae7)
- update CONTRIBUTING.md (3fd55c0)