xai-sdk-python

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

What's Changed

• Add user-location support for web-search tool by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/80
• Add tool_call_id field by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/81
• Add developer role by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/86
• Add batch API support (#46) by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/82
• Instrument Collections Methods by @aaditjuneja in https://github.com/xai-org/xai-sdk-python/pull/85
• Instrument File Methods by @aaditjuneja in https://github.com/xai-org/xai-sdk-python/pull/84
• Update Emitted Chat Spans to be compliant with OTEL gen_ai spec's changes by @aaditjuneja in https://github.com/xai-org/xai-sdk-python/pull/83
• Bump version from v1.5.0 -> v1.6.0 by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/89

New Contributors

• @aaditjuneja made their first contribution in https://github.com/xai-org/xai-sdk-python/pull/85

Full Changelog: https://github.com/xai-org/xai-sdk-python/compare/v1.5.0...v1.6.0

What's Changed

• Add end_index, rename document search tools, and add verbose_streaming include option by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/71
• Add inline citations support to Chunk and Response classes by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/73
• Add new features to Collections API client by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/74
• Add util functions to retrieve server-side tool outputs by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/75
• Bump version from 1.4.1 to 1.5.0 by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/76

Full Changelog: https://github.com/xai-org/xai-sdk-python/compare/v1.4.1...v1.5.0

What's Changed

• Update changelog following the v.1.4.0 release by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/63
• Update the metadata sent on requests to also include the language by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/62
• Update proto definitions to include new tool call status field on tool calls by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/65
• Add max_turns parameter in chat creation for agentic conversations by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/67
• Support including tool output and inline citations by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/68
• Restructure the literals for chat API by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/69
• Bump version from 1.4.0 to 1.4.1 by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/70

Full Changelog: https://github.com/xai-org/xai-sdk-python/compare/v1.4.0...v1.4.1