Grok Imagine Image Pro

API Key: $XAI_API_KEY (already configured)
Save dir: ~/.openclaw/media/ (resolves to /data/.openclaw/media/ — allowed for Telegram sending)

Available Models

• - grok-imagine-image — standard quality, faster
• INLINECODE4 — higher quality (default for generation)

1. Image Generation

CODEBLOCK0

Aspect Ratios

Add "aspect_ratio": "<ratio>" to the JSON body. Supported values:

Batch Generation

Set "n": <count> (1-10) to generate multiple images in one request.

2. Image Editing / Style Transfer

Edit an existing image by providing a source image plus an edit prompt.
Uses the same /v1/images/generations endpoint with an added image_url field.

Do NOT use /v1/images/edits with multipart — xAI requires JSON.

IMPORTANT: For local files, use Python to build the payload JSON file, then curl with @file.
Inline base64 in curl args causes "Argument list too long" for images >~100KB.

NOTE: This is NOT true image editing — the API generates a new image inspired by the source.
It cannot make pixel-precise edits (e.g. changing only a car's color while keeping everything else identical).

Edit from local file (recommended approach):

CODEBLOCK1

Edit from URL:

CODEBLOCK2

Style Transfer Examples

Use editing with a style prompt, e.g.:

• - "Render this as an oil painting in impressionist style"
• "Make this a pencil sketch with detailed shading"
• "Convert to pop art with bold colors"
• "Watercolor painting with soft edges"

3. Sending to Telegram

CODEBLOCK3

• - Always include message field (required even for media-only sends)
• Allowed media paths: /tmp/, ~/.openclaw/media/, INLINECODE24

Notes

• - Do NOT pass size parameter — returns 400
• Aspect ratio: pass aspect_ratio in JSON body (not size)
• Editing: use image_url field in the generations endpoint (NOT the edits endpoint with multipart)
• Always use "response_format": "b64_json" — URL format returns temporary URLs that often 403
• For large images: build payload with Python → save to /tmp/ → curl with @file syntax
• Max 10 images per request
• Images are subject to content moderation
• Editing is style-transfer/reimagination, NOT pixel-precise inpainting