---
name: xai-sdk-python
slug: xai-sdk-python
type: github
source_url: https://github.com/xai-org/xai-sdk-python
organization: xAI
organization_slug: xai
total_releases: 33
latest_version: v1.20.0
latest_date: 2026-09-24
last_updated: 2026-10-15
tracking_since: 2025-06-13
canonical: https://releases.sh/xai/xai-sdk-python
organization_url: https://releases.sh/xai
---

<Release version="v1.20.0" date="September 24, 2026" published="2026-09-24T18:05:54.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.20.0">
## What's Changed
* Update changelog by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/199
* Fetch the correct version from PyPI in the release workflow by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/200
* Update changelog by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/201
* Add last frame and keyframes to video generation by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/218
* Prepare to release v1.20.0 of the xAI Python SDK by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/219


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.19.0...v1.20.0
</Release>

<Release version="v1.19.0" date="August 18, 2026" published="2026-08-18T18:02:24.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.19.0">
## What's Changed
* Update README examples to use grok-4.6 by @gyang-xai in https://github.com/xai-org/xai-sdk-python/pull/191
* Set `tool_call_id` when replaying tool outputs via `chat.append(response)` by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/192
* Add quality parameter to image generation and regen protos from xai-proto by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/193
* Add `reference_audios`, `generate_audio`, and 1080p to video generation by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/194
* Set default gRPC User-Agent to XaiSdk/{version} by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/195
* Add image_generation server-side tool by @yanxi0830 in https://github.com/xai-org/xai-sdk-python/pull/186
* Prepare to release v1.19.0 of the xAI Python SDK by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/198

## New Contributors
* @yanxi0830 made their first contribution in https://github.com/xai-org/xai-sdk-python/pull/186

**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.18.0...v1.19.0
</Release>

<Release version="v1.18.0" date="August 13, 2026" published="2026-08-13T01:27:00.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.18.0">
## What's Changed
* Accept xhigh reasoning_effort and add grok-4.6 to ChatModel by @gyang-xai in https://github.com/xai-org/xai-sdk-python/pull/189
* chore: bump version to 1.18.0 by @gyang-xai in https://github.com/xai-org/xai-sdk-python/pull/190


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.17.1...v1.18.0
</Release>

<Release version="v1.17.0" date="June 12, 2026" published="2026-06-12T03:44:39.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.17.0">
## What's Changed
* feat: add service_tier support for priority processing by @double-di in https://github.com/xai-org/xai-sdk-python/pull/163
* chore: bump version to 1.17.0 by @double-di in https://github.com/xai-org/xai-sdk-python/pull/165


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.16.0...v1.17.0
</Release>

<Release version="v1.16.0" date="June 10, 2026" published="2026-06-10T17:41:54.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.16.0">
## What's Changed
* Add Imagine file storage & file-ID inputs to image/video generation by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/160
* Add public file URLs and list filtering to the files client by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/161
* Add new grok imagine models to types/model.py for editor autocomplete by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/162
* Prepare to release v1.16.0 of the xAI Python SDK by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/164


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.15.0...v1.16.0
</Release>

<Release version="v1.15.0" date="May 30, 2026" published="2026-05-30T01:42:34.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.15.0">
## What's Changed
* Add grok-build-0.1 to ChatModel by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/155
* Add context compaction support by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/156
* Bump version from 1.14.0 to 1.15.0 by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/157


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.14.0...v1.15.0
</Release>

<Release version="v1.14.0" date="May 27, 2026" published="2026-05-27T05:15:34.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.14.0">
## What's Changed
* Add enable_image_search to web_search and SERVER_SIDE_TOOL_IMAGE_SEARCH enum by @ushiromiya-lion in https://github.com/xai-org/xai-sdk-python/pull/152
* Bump version to 1.14.0 by @ushiromiya-lion in https://github.com/xai-org/xai-sdk-python/pull/153

## New Contributors
* @ushiromiya-lion made their first contribution in https://github.com/xai-org/xai-sdk-python/pull/152

**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.13.0...v1.14.0
</Release>

<Release version="v1.13.0" date="May 16, 2026" published="2026-05-16T18:00:46.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.13.0">
## What's Changed
* feat: add prepare_extension() for batch video extension by @double-di in https://github.com/xai-org/xai-sdk-python/pull/141


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.12.2...v1.13.0
</Release>

<Release version="v1.12.2" date="May 7, 2026" published="2026-05-07T00:07:20.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.12.2">
## What's Changed
* Add none and medium reasoning effort levels by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/139
* Bump version from 1.12.1 to 1.12.2 by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/140


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.12.1...v1.12.2
</Release>

<Release version="v1.12.1" date="April 30, 2026" published="2026-04-30T22:35:52.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.12.1">
## What's Changed
* Update the CHANGELOG with missing entries by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/135
* Add grok-4.3 to ChatModel by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/137
* Bump version from 1.12.0 to 1.12.1 by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/138


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.12.0...v1.12.1
</Release>

<Release version="v1.12.0" date="April 29, 2026" published="2026-04-29T18:43:26.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.12.0">
## What's Changed
* docs: add video generation and extension documentation to README by @double-di in https://github.com/xai-org/xai-sdk-python/pull/127
* Add collection descriptions, field definition updates, and bytes chunking by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/130
* Add `expires_after` to file uploads, drop `team_id` from `File` by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/131
* Add `cost_usd` tracking, model migration, example fixes by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/132
* docs: update default API requests timeout from 15min(900s) to 27min(1620s) by @dcbert in https://github.com/xai-org/xai-sdk-python/pull/101
* Add `cost_usd` property to image and video responses by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/133
* Prepare to release v1.12.0 of the xAI Python SDK by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/134

## New Contributors
* @dcbert made their first contribution in https://github.com/xai-org/xai-sdk-python/pull/101

**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.11.0...v1.12.0
</Release>

<Release version="v1.11.0" date="March 27, 2026" published="2026-03-27T18:23:29.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.11.0">
## What's Changed
* Support inline file attachments by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/122
* Add url support for FileContent by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/123
* Bump version from 1.10.0 to 1.11.0 by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/124


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.10.0...v1.11.0
</Release>

<Release version="v1.10.0" date="March 24, 2026" published="2026-03-24T17:25:18.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.10.0">
## What's Changed
* Add video extension API and reference_image_urls support by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/120
* Prepare to release v1.10.0 of the xAI Python SDK by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/121


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.9.1...v1.10.0
</Release>

<Release version="v1.9.1" date="March 19, 2026" published="2026-03-19T22:58:07.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.9.1">
## What's Changed
* Update grok-4.20 and multi-agent model variants in ChatModel by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/117
* Bump version from 1.9.0 to 1.9.1 by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/118


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.9.0...v1.9.1
</Release>

<Release version="v1.9.0" date="March 19, 2026" published="2026-03-19T01:02:11.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.9.0">
## What's Changed
* feat: add image/video batch support and input_file_id by @double-di in https://github.com/xai-org/xai-sdk-python/pull/112
* Fix unknown status handling in polling loops by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/113
* Use model type aliases in image and video method signatures by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/114
* Prepare to release v1.9.0 of the xAI Python SDK by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/116

## New Contributors
* @double-di made their first contribution in https://github.com/xai-org/xai-sdk-python/pull/112

**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.8.2...v1.9.0
</Release>

<Release version="v1.8.2" date="March 16, 2026" published="2026-03-16T18:07:49.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.8.2">
## What's Changed
* Handle video generation failure case by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/110
* Prepare to release v1.8.2 of the xAI Python SDK by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/111


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.8.1...v1.8.2
</Release>

<Release version="v1.8.1" date="March 11, 2026" published="2026-03-11T03:05:41.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.8.1">
## What's Changed
* Update grok-4.20 beta and multi-agent model variants in ChatModel by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/107
* Bump version from 1.8.0 to 1.8.1 by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/109


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.8.0...v1.8.1
</Release>

<Release version="v1.8.0" date="March 5, 2026" published="2026-03-05T06:51:09.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.8.0">
## What's Changed
* Add grok-imagine-image-pro to ImageGenerationModel by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/103
* Add agent_count parameter to chat API for multi-agent models by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/104
* Add grok-4.20 experimental beta and multi-agent model variants to ChatModel by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/105
* Bump version from 1.7.0 to 1.8.0 by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/106


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.7.0...v1.8.0
</Release>

<Release version="v1.7.0" date="February 18, 2026" published="2026-02-18T20:53:56.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.7.0">
## What's Changed
* Deprecate `BaseImageResponse.prompt` after `up_sampled_prompt` proto removal by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/96
* Add 2K image resolution support by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/97
* Reduce default PollTimer poll interval and introduce default video polling settings by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/98
* Add support for multi-reference image editing with new `image_urls` parameter by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/99
* Prepare to release v1.7.0 of the xAI Python SDK by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/100


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.6.1...v1.7.0
</Release>

<Release version="v1.6.1" date="January 29, 2026" published="2026-01-29T03:13:27.000Z" url="https://github.com/xai-org/xai-sdk-python/releases/tag/v1.6.1">
## What's Changed
* Update changelog by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/90
* Add Imagine image/video API support by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/91
* Bump version from 1.6.0 to 1.6.1 by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/92


**Full Changelog**: https://github.com/xai-org/xai-sdk-python/compare/v1.6.0...v1.6.1
</Release>

<Pagination cursor="2026-01-29T03:13:27.000Z|2026-05-26T12:24:32.701Z|rel_JOP0rPqhUVVpoC1mSCTAT" next="https://releases.sh/xai/xai-sdk-python.md?cursor=2026-01-29T03%3A13%3A27.000Z%7C2026-05-26T12%3A24%3A32.701Z%7Crel_JOP0rPqhUVVpoC1mSCTAT&limit=20" />