xAI Python SDK v1.16.0：Grok Imagine文件存储与新模型标识符

xAI于2026年6月10日发布了Python SDK的1.16.0版本。这是一个小型SDK版本，专注于改进通过Grok Imagine接口进行图像和视频生成时的文件操作体验。所有变更均来自单一贡献者**@Omar-V2**的三个pull request。

Grok Imagine集成的新功能

此版本中最重要的变更（PR #160）新增了Imagine文件存储——在xAI基础设施内存储文件并通过文件ID将其作为图像和视频生成任务输入引用的能力。

此前，每当用户希望在任务中使用某个文件（例如用于生成的参考图像），都需要随请求附带该文件。有了新的支持，文件可以一次上传并存储，之后所有请求都只需通过ID引用。这简化了重复使用相同输入文件的自动化流水线，减少了不必要的数据传输。

文件客户端改进

PR #161为文件客户端（files client）带来两项新功能：

• 文件公共URL——生成或存储的文件现在可以获得公开可访问的URL，方便与外部系统共享和集成。
• 列表筛选——客户端现在支持在获取文件列表时按条件筛选，当程序管理大量存储并需要选择性获取子集时非常有用。

面向IDE的新模型标识符

PR #162在types/model.py文件中添加了新的Grok Imagine模型标识符。这一变更在功能上并未引入新的模型能力——它是对类型的更新，服务于VS Code、PyCharm或Cursor等IDE环境中的代码自动补全（editor autocomplete）。

背景与变更规模

有必要说明这次发布的规模：这是一个小型SDK版本，不引入新的AI模型，也不对SDK架构进行重大变更。所有变更都具有实际意义，旨在改善开发者体验——更便捷的媒体内容生成文件管理，以及更好的代码编辑器支持。

xAI Python SDK是一个随Grok模型和Imagine生成能力持续演进的活跃项目。v1.16.0已在PyPI和项目GitHub仓库上发布。