xAI Studio

通过 xAI SDK 调用 xAI 的模型，生成和编辑图像与视频。

环境配置（Venv + SDK）

创建隔离的虚拟环境并安装 SDK：

python3 -m venv venv
source venv/bin/activate
pip3 install xai-sdk
deactivate

生成图像

venv/bin/python3 scripts/run.py generate --prompt "黎明时分的未来主义城市景观"

单次请求生成多张图像：

venv/bin/python3 scripts/run.py generate --prompt "抽象艺术" --count 4

编辑图像

使用文本提示编辑已有图像：

venv/bin/python3 scripts/run.py edit --prompt "将其改为水彩画风格" --image photo.png

最多合并 3 张源图像：

venv/bin/python3 scripts/run.py edit --prompt "将猫添加到风景中" --image cat.png --image landscape.png

并发风格迁移

并行地对同一张图像应用多种风格：

venv/bin/python3 scripts/run.py concurrent --image photo.png --prompt "油画风格" --prompt "铅笔素描风格" --prompt "波普艺术风格"

多轮编辑

按顺序链式执行编辑操作——前一步的输出作为下一步的输入：

venv/bin/python3 scripts/run.py multi-turn --image photo.png --prompt "添加戏剧性的云层" --prompt "改为日落场景"

常用参数标志

• --model：模型名称（默认：grok-imagine-image）
• --aspect-ratio：宽高比，例如 16:9、4:3 或 auto（默认：1:1）
• --resolution：1k 或 2k（默认：API 默认值）
• --format：base64（默认）或 url
• --out-dir：输出目录（默认：media/xai-output）

输出格式

图像保存至 //__.，按 UTC 日期组织。文件名前缀对应子命令：generate（生成）、edit（编辑）、style（并发风格迁移）或 step（多轮编辑）。文件扩展名根据图像魔数（magic bytes）自动识别（支持 PNG、JPEG、WebP、GIF）。

视频：生成

# 文本生成视频
venv/bin/python3 scripts/run.py video-generate --prompt "一枚火箭从火星发射升空" --duration 10 --resolution 720p

# 图像生成视频
venv/bin/python3 scripts/run.py video-generate --prompt "为该场景添加动画效果" --image photo.png --duration 5

视频：编辑

venv/bin/python3 scripts/run.py video-edit --prompt "添加一条银色项链" --video https://example.com/clip.mp4

视频：并发编辑

venv/bin/python3 scripts/run.py video-concurrent --video https://example.com/clip.mp4 --prompt "添加一顶帽子" --prompt "将服装更换为红色"

视频相关参数标志

• --model：模型名称（默认：grok-imagine-video）
• --duration：视频时长（单位：秒），取值范围为 1–15（默认：5）——仅适用于生成操作
• --aspect-ratio：宽高比，例如 16:9（默认：API 默认值）
• --resolution：480p 或 720p（默认：API 默认值）
• --timeout：最大轮询等待时间（单位：秒）（默认：SDK 默认值）
• --poll-interval：状态检查间隔（单位：秒）（默认：SDK 默认值）

视频以 .mp4 格式保存至 //__.mp4。文件名前缀对应子命令：video（生成）、video_edit（编辑）或 video_style（并发编辑）。