xAI upgrades the Grok Imagine API with auto quality, more reference images, and cinematic aspect ratios

xAI has shipped a set of updates to the Grok Imagine image API, expanding the controls developers have over quality, source-image inputs, and output framing.

What's new

According to xAI's release notes, the update covers three changes:

• Auto quality: the quality parameter now accepts an auto option. xAI says "Auto currently uses low for image generation and medium for image editing," letting the API pick a sensible default cost/quality tradeoff without the caller having to specify one.
• More reference images for editing: "Image editing now accepts up to 5 source images per request (was 3)," a meaningful jump for workflows that composite or restyle from multiple references at once.
• New aspect ratios: the API adds 21:9, described by xAI as "cinematic widescreen," and 5:2, described as "wide banners," available for both generation and editing.

The changes landed in the August 28 entry of xAI's official docs release notes.

Context

Grok Imagine is xAI's image generation and editing product, exposed to developers through the same API surface as the rest of the xAI platform (docs.x.ai). Since launch, xAI has iterated steadily on the endpoint's controls — quality tiers, reference-image limits, and aspect-ratio support are the kinds of incremental developer-experience upgrades that determine whether an image API is usable for production creative pipelines rather than just demos. Competing providers, including OpenAI's image models and Google's Gemini image tooling, have been making similar moves this year, adding wider aspect ratios and more flexible editing inputs as image generation shifts from novelty to a production tool for marketing and design teams.

Why it matters

None of these three changes is a headline model release, but together they matter for anyone building on Grok Imagine. The jump from 3 to 5 reference images directly expands what's possible in multi-image composition and product-shot workflows — a common ask from developers doing ad creative or e-commerce imagery. The new wide aspect ratios (21:9, 5:2) target formats — cinematic crops and banner ads — that previously required cropping a square or standard-ratio output after the fact, adding a post-processing step. And auto quality is a small but practical convenience: it removes a decision point for callers who don't want to manage cost/quality tradeoffs themselves, defaulting editing to a higher quality tier than generation given editing's typically higher precision requirements. Collectively, the update signals xAI treating Grok Imagine as an actively maintained product surface rather than a one-shot release, which matters for developers evaluating platform stability before committing to it in production.