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:

CODEBLOCK0

Generate Images

CODEBLOCK1

Generate multiple images in one request:

CODEBLOCK2

Edit Images

Edit an existing image with a text prompt:

CODEBLOCK3

Combine up to 3 source images:

CODEBLOCK4

Concurrent Style Transfers

Apply multiple styles to the same image in parallel:

CODEBLOCK5

Multi-Turn Editing

Chain edits sequentially — each output feeds into the next:

CODEBLOCK6

Common Flags

• - --model: Model name (default: grok-imagine-image)
• INLINECODE2: e.g. 16:9, 4:3, auto (default: 1:1)
• INLINECODE7: 1k or 2k (default: API default)
• INLINECODE10: base64 (default) or INLINECODE12
• INLINECODE13: 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

CODEBLOCK7

Video: Edit

CODEBLOCK8

Video: Concurrent Edits

CODEBLOCK9

Video Flags

• - --model: Model name (default: grok-imagine-video)
• INLINECODE22: Length in seconds, 1–15 (default: 5) — generate only
• INLINECODE24: e.g. 16:9 (default: API default)
• INLINECODE26: 480p or 720p (default: API default)
• INLINECODE29: Max polling wait in seconds (default: SDK default)
• INLINECODE30: 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).