xai-sdk-python

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

What's Changed

• Add xai-sdk-version to the request metadata by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/41
• Remove double await in async interceptor by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/42
• Add context manager support and proper channel cleanup to clients by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/43
• Add ability to exclude sensitive attributes for traces by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/44
• Rename internal ChoiceChunk class to CompletionOutputChunk by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/45
• Add support for encrypted content in chat responses by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/47
• Add debug output support in chat responses by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/48
• Optimize streaming chat response memory usage with lazy buffering by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/46
• Add option to use an insecure gRPC channel in clients by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/49
• Support ToolCallType in ToolCall by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/50
• Add util function for retrieving tool-call-type by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/51
• Add remote MCP tool by @gyang-xai in https://github.com/xai-org/xai-sdk-python/pull/52
• Add SERVER_SIDE_TOOL_MCP and SERVER_SIDE_TOOL_COLLECTIONS_SEARCH to usage enum by @gyang-xai in https://github.com/xai-org/xai-sdk-python/pull/53
• Add proto changes and util function for collections-search by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/54
• Set index correctly in parse method by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/55
• Append all output entries for agentic response by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/56
• Allow passing a Pydantic BaseModel to response_format directly in chat.create by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/57
• Implement Files API client SDK support by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/58
• Add new server-side tools examples by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/59
• Auto-detect server-side implicit tool additions in chat by @shawnthapa in https://github.com/xai-org/xai-sdk-python/pull/60
• Bump version from v1.3.1 -> v1.4.0 by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/61

New Contributors

• @shawnthapa made their first contribution in https://github.com/xai-org/xai-sdk-python/pull/43
• @gyang-xai made their first contribution in https://github.com/xai-org/xai-sdk-python/pull/52

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

What's Changed

• Support multiple outputs in chunk and response of chat service by @mark-xai in https://github.com/xai-org/xai-sdk-python/pull/39
• Bump version from v1.3.0 -> v.1.3.1 by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/40

New Contributors

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

Full Changelog: https://github.com/xai-org/xai-sdk-python/compare/v1.3.0...v1.3.1

What's Changed

• Update changelog by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/31
• Add proto support for server side tools by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/32
• Bump version from v1.2.0 -> v1.3.0a0 by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/33
• Add convenience functions for using new server-side tools by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/35
• Updated response handling to use 'outputs' instead of 'choices' by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/37
• Bump version from v1.3.0a0 -> v1.3.0 by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/38

Full Changelog: https://github.com/xai-org/xai-sdk-python/compare/v1.2.0...v1.3.0

What's Changed

• Update changelog by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/31
• Add proto support for server side tools by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/32
• Bump version from v1.2.0 -> v1.3.0a0 by @Omar-V2 in https://github.com/xai-org/xai-sdk-python/pull/33

Full Changelog: https://github.com/xai-org/xai-sdk-python/compare/v1.2.0...v1.3.0a0