Grok Imagine Image API

xAI Grok Imagine image generation and editing

·Features·FAQ

Documentation

Prompt *

Text description or edit instruction

Aspect Ratio

Output aspect ratio

Reference Images

Upload 1-5 reference images to trigger edit mode

0/5

Click or drag & dropPNG, JPG, WEBP, GIF · Max 100MB

Enable Pro

Enable pro mode for higher quality results

Upsample Prompt

Let AI enhance your prompt for better results

Enable NSFW

Enable NSFW content generation

Output

Your generated image will appear here

Features

What Grok Imagine Image API offers

Text-to-image when you omit reference uploads

Reference-guided passes when you include 1 to 5 images in the same request

Aspect ratios: 1:1, 2:3, 3:2, 9:16, 16:9

Enable Pro toggle switches billing to the xai/grok-imagine-image-pro price key for higher fidelity outputs

Upsample prompt toggle asks the service to expand or tighten your wording before sampling

Enable NSFW mirrors the provider flag for accounts that explicitly allow mature generations

JSON generate and poll workflow identical to other image models here

Use cases

Built for

Primary

Hero art - Text-only drafts first, then attach references once layout stabilizes

E-commerce cleanup - Multi-reference edits for colorway swaps or background control

Social sizing - Same creative idea exported across square, vertical, and widescreen crops

Production tiers - Run bulk jobs with Enable Pro off, reroll winners with Enable Pro on

Agency workflows - Clear booleans map to API fields for staging versus client-facing renders

Instructional design - Combine precise prompts with photo references for slide imagery

FAQ

About Grok Imagine Image API

It exposes xAI Grok Imagine image generation with prompt plus aspect_ratio, optional image_urls (up to five files), optional enable Pro, optional upsample_prompt, and optional enable_nsfw aligned with your policy.

Reference images are optional. If image_urls is empty you get pure text-to-image. With one or more URLs the call behaves as an edit grounded in those frames.

They are the same architecture but enable Pro true selects the xai/grok-imagine-image-pro billing key for higher quality settings. Disabled uses xai/grok-imagine-image.

It allows the provider to rewrite or enrich your text prompt prior to sampling, which helps when instructions are short or underspecified.