Grok API

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

xAI's fast coding model trained specifically for agentic coding, currently in early access. The model slug is grok-build-0.1.

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

Grok Build is now available in beta. Use the interactive TUI, run headlessly in scripts, or build apps and orchestrators with the Agent Client Protocol.

Install with a single command:

curl -fsSL https://x.ai/cli/install.sh | bash

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

You can now clone a voice from a short audio clip and use it across the Text-to-Speech and Voice Agent APIs. Create and manage your voice catalog from the xAI console.

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

Every API response now includes the exact cost of the request via a cost_in_usd_ticks field in the usage object. Works across chat completions, Responses API, image generation, video generation, and streaming.

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

You can now set an expiration policy on uploaded files using expires_after or an explicit expires_at timestamp. Expired files are automatically deleted.

You can now use grok-voice-think-fast-1.0 with the Voice Agent API. See the blog post for more details.

The xAI Speech to Text API is now generally available. Transcribe audio to text in 25 languages with batch and streaming modes.

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

• 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

The Text-to-Speech API is now generally available. Generate natural-sounding speech from text with Grok.

The Batch API now supports image generation, image editing, and video generation in addition to chat completions. Both server-side tools and client-side function tools are also now supported in batch requests. Image and video URLs in batch results expire after 1 hour.