kitsune-den/skulk-skills/xai-imagegen

xAI Image Generation

Generate images from text prompts using xAI's Grok Aurora model.

Setup

API key must be available via either:

• Env var: XAI_API_KEY
• Credentials file: ~/.config/xai/credentials.json → {"api_key": "xai-..."}

Get a key at https://console.x.ai

Quick Generate

Run the bundled script:

bash skills/xai-imagegen/scripts/generate.sh "a fox spirit in a neon-lit library" /tmp/fox.jpg

Returns the local file path on success.

Direct API Usage

curl -s -X POST "https://api.x.ai/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "your prompt here"
  }'

Response contains a temporary URL — download immediately:

{"data": [{"url": "https://imgen.x.ai/...", "mime_type": "image/jpeg"}]}

Parameters

Prompt Tips

• Be specific and descriptive — style, mood, composition, colors
• Reference art styles: "in the style of cyberpunk illustration", "watercolor", "pixel art"
• Specify format when relevant: "square album cover", "wide banner", "portrait avatar"
• Grok handles text-in-images reasonably well (titles, labels)

Image Editing

Provide a source image URL alongside a prompt to edit existing images. See references/api-details.md for the full editing API.

Cost

Each generation costs ~$0.02 (200M cost ticks). Budget accordingly for batch generation.