xAI Studio

xai-studio 是一个基于 Python 的 CLI 技能，通过 xai-sdk 调用 xAI 模型生成与编辑图像和视频：支持文生图、批量生成、多图编辑（最多 3 张）、并发风格迁移、多轮链式编辑，以及文生视频、图生视频、视频编辑与并发视频编辑；结果按 UTC 日期保存到输出目录，运行需配置 XAI_API_KEY。

h0llyw00dzz

热度 83.97

最近更新 2026-05-17 15:03:35

分类：创作依赖：代码执行 / 第三方 API / 读写文件应用场景：图像生成 / 视频编辑 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add xai-studio

Metadata

name: xai-studio
description: xAI Studio — generate and edit images and videos via the xAI API. Image: text-to-image, batch generation, multi-image editing, concurrent style transfers, multi-turn chaining. Video: text-to-video, image-to-video, video editing, concurrent video edits. All from a single expandable CLI.
license: MIT-0
repository: https://github.com/H0llyW00dzZ/xai-studio-skills
metadata: {"openclaw":{"homepage":"https://github.com/H0llyW00dzZ/xai-studio-skills","emoji":"📽️","requires":{"bins":["python3"],"env":["XAI_API_KEY"]},"primaryEnv":"XAI_API_KEY","useVenv":true,"files":["scripts/run.py"],"install":[{"id":"pip3","kind":"apt","package":"python3-pip","label":"Install pip3"},{"id":"xai-sdk","kind":"pip3","package":"xai-sdk","label":"Install official xAI SDK"}]}}

xAI Studio

Generate and edit images and videos using xAI's models via the xAI SDK.

Setup (Venv + SDK)

Create an isolated virtual environment and install the SDK:

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

Generate Images

venv/bin/python3 scripts/run.py generate --prompt "A futuristic cityscape at dawn"

Generate multiple images in one request:

venv/bin/python3 scripts/run.py generate --prompt "Abstract art" --count 4

Edit Images

Edit an existing image with a text prompt:

venv/bin/python3 scripts/run.py edit --prompt "Make it a watercolor painting" --image photo.png

Combine up to 3 source images:

venv/bin/python3 scripts/run.py edit --prompt "Add the cat to the landscape" --image cat.png --image landscape.png

Concurrent Style Transfers

Apply multiple styles to the same image in parallel:

venv/bin/python3 scripts/run.py concurrent --image photo.png --prompt "oil painting" --prompt "pencil sketch" --prompt "pop art"

Multi-Turn Editing

Chain edits sequentially — each output feeds into the next:

venv/bin/python3 scripts/run.py multi-turn --image photo.png --prompt "Add dramatic clouds" --prompt "Make it a sunset"

Common Flags

--model: Model name (default: grok-imagine-image)
--aspect-ratio: e.g. 16:9, 4:3, auto (default: 1:1)
--resolution: 1k or 2k (default: API default)
--format: base64 (default) or url
--out-dir: Output directory (default: media/xai-output)

Output

Images are saved to <out-dir>/<YYYY-MM-DD>/<prefix>_<NNN>_<HHMMSS>.<ext>, organized by UTC date. The prefix reflects the subcommand: generate, edit, style (concurrent), or step (multi-turn). The file extension is detected automatically from image magic bytes (PNG, JPEG, WebP, GIF).

Video: Generate

# Text-to-video
venv/bin/python3 scripts/run.py video-generate --prompt "A rocket launching from Mars" --duration 10 --resolution 720p

# Image-to-video
venv/bin/python3 scripts/run.py video-generate --prompt "Animate this scene" --image photo.png --duration 5

Video: Edit

venv/bin/python3 scripts/run.py video-edit --prompt "Add a silver necklace" --video https://example.com/clip.mp4

Video: Concurrent Edits

venv/bin/python3 scripts/run.py video-concurrent --video https://example.com/clip.mp4 --prompt "Add a hat" --prompt "Change outfit to red"

Video Flags

--model: Model name (default: grok-imagine-video)
--duration: Length in seconds, 1–15 (default: 5) — generate only
--aspect-ratio: e.g. 16:9 (default: API default)
--resolution: 480p or 720p (default: API default)
--timeout: Max polling wait in seconds (default: SDK default)
--poll-interval: Seconds between status checks (default: SDK default)

Videos are saved as .mp4 to <out-dir>/<YYYY-MM-DD>/<prefix>_<NNN>_<HHMMSS>.mp4. The prefix reflects the subcommand: video (generate), video_edit, or video_style (concurrent).