xAI 于 2026-09-24 发布 Python SDK v1.20.0（PyPI xai-sdk）。面向 `grok-imagine-video-1.5`：新增 `last_frame_url`/`last_frame_file_id` 精确钉住片尾帧，并可与首帧图像插值；`keyframes` 列表可在片内时间戳钉入最多 4 张参考图（秒级，须严格落在片长内部）。视频生成官方标价约 $0.08/秒，分辨率支持 480p/720p/1080p。适合要做「起止构图可控」或分镜对齐的 Imagine 管线。

核心要点速览 (Key Takeaways)

  • ✓发版：v1.20.0；PyPI `xai-sdk==1.20.0`
  • ✓尾帧钉扎：`last_frame_url` / `last_frame_file_id` 用于 `video.generate` / `start` / `prepare`；与 `image_url`/`image_file_id` 组合时在首尾帧之间插值（仅 `grok-imagine-video-1.5`）
  • ✓keyframes：最多 **4** 条 `{image_url|image_file_id, timestamp}`，`timestamp` 为秒且须严格落在片长内
  • ✓计价参考：Imagine 文档 标明 video 约 **$0.08/秒**，分辨率 480p/720p/1080p
  • ✓升级：`pip install -U xai-sdk`；对照仓库 CHANGELOG 与 REST 参考
🔗

相关资源与官方项目出处

免代理直达
💡 国内无需访问 Twitter，可直接访问上述项目官方资源与文档
🐙
GitHub Release xai-sdk v1.20.0
github.com/xai-org/xai-sdk-python/releases/tag/v1.20.0
↗
🐙
CHANGELOG v1.20.0
github.com/xai-org/xai-sdk-python/blob/v1.20.0/CHANGELOG.md
↗
📖
Imagine / Video Generation docs
docs.x.ai/docs/guides/video-generation
↗
📖
xAI docs home
docs.x.ai/
↗
📖
PyPI xai-sdk 1.20.0
pypi.org/project/xai-sdk/1.20.0/
↗
🐙
GitHub repository
github.com/xai-org/xai-sdk-python
↗
🔬

深度技术解析与实战评估

核心背景与行业痛点

文生/图生视频管线一旦进入广告分镜、产品演示或「起止画面必须对得上品牌板」，只靠文本提示很难锁死第一帧与最后一帧；中间转折也常需要在固定秒点插入参考构图。缺少 SDK 级首尾帧与 keyframe 参数时，团队只能事后裁剪或反复重抽，成本和时延都难控。xAI Imagine 视频线（grok-imagine-video-1.5）已支持最高 1080p，开发者需要把这些控制面写进正式客户端。

架构亮点与底层机制

xai-sdk v1.20.0 在 client.video.generate / start / prepare 上暴露：last_frame_url 与 last_frame_file_id 钉住精确尾帧；与 image_url/image_file_id（及参考输入）组合时，首帧也被钉死并在两端之间插值。keyframes 接受最多 4 个 TypedDict，形如 {"image_url": "https://...", "timestamp": 2.0} 或 file_id 变体，时间戳单位为秒且必须严格落在片长内部。能力仅声明支持 grok-imagine-video-1.5。变更详见仓库 CHANGELOG。

权威 Benchmark 与实测跑分对比

本版发行说明未公布 keyframe/尾帧模式下的独立画质或时延公开榜。产品侧文档给出 Imagine 视频标价约 $0.08/秒，分辨率档位 480p / 720p / 1080p（见 Imagine Overview）。验收建议：固定首尾参考图做往返生成，检查尾帧像素对齐与中间 timestamp 构图是否命中；勿把无钉扎基线的主观分直接外推到钉扎模式。

开发者实战落地与开箱指南

pip install -U "xai-sdk==1.20.0"，配置 XAI_API_KEY。从 Video Generation 指南 与 REST 参考入手，在 generate/prepare 传入 image_*、last_frame_* 与 keyframes。可用 Files API 的 file_id 代替公网 URL。批次/异步路径同样走 prepare。升级后跑一条短 clip 金丝雀，确认模型字符串为 grok-imagine-video-1.5。