xai / grok-imagine-image-v2
grok-imagine-image-v2
Create new images or edit a source photo with xAI’s Grok Imagine Image V2. Choose 1K or 2K output, quality level, and aspect ratio.
## Overview Grok Imagine Image V2 is xAI’s image generation and image editing model. It turns a written instruction into 1–10 images, or edits a single source image while keeping the rest stable. It’s tuned for tight instruction following, cleaner layout control, and sharper on-image text. That makes it useful for real assets like posters, product shots, and social creatives. ## What you can build - Product shots on clean backdrops with controlled lighting and styling - Posters and thumbnails with readable headlines and small print - Social creatives in story, feed, banner, and cinematic formats without manual cropping - Photo restyles like pencil sketch, film still, editorial, or illustration looks - Background swaps and scene changes while preserving the main subject - Iteration loops where you change one detail at a time, not the whole image ## Inputs - A required written instruction that describes the image you want, or the edit you want applied. - An optional source image for editing. It must be a JPG or PNG, up to 20 MiB. This Wiro version accepts only 1 image. - The number of output images you want in one run, from 1 to 10 variations. - A target aspect ratio. You can keep the original framing automatically when editing, or pick a fixed ratio such as 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 2:1, or 5:2. - An output resolution preset: 1K or 2K. - A quality mode: Low for drafts and exploration, Medium for finer detail. ## Outputs - A set of 1–10 generated images. - Each image follows the requested aspect ratio, resolution, and quality mode. - Results come back as image files (typically delivered as downloadable URLs, or as base64-encoded image data depending on the serving system). Common formats include JPEG and PNG. ## Recommended settings - Drafting and exploration: Low quality, 1K resolution, and 4–10 variations. - Final selects: Medium quality, 2K resolution, and 1–2 variations. - Image editing: Keep the aspect ratio set to automatic so the framing stays consistent. ## Limitations - This Wiro model accepts only 1 source image for edits. Some other integrations allow more reference images. - Hosted image links can be temporary. Save the results soon after you generate them. - Dense scenes can drift on small background details, especially at Low quality. - Low-quality inputs reduce edit fidelity. Heavy compression, motion blur, screenshots of screenshots, and scanned images can cause unexpected changes. - Large edits can change parts of the image you did not mention. Ask for smaller, specific changes when you need control. ## Safety & compliance - xAI applies content moderation to generated images. If a request fails moderation, the system may return a filtered placeholder instead of the requested output. - Don’t request sexual content involving minors or any non-consensual intimate imagery. These are blocked. - If your output includes a watermark or provenance signal, don’t remove, alter, or hide it. - You’re responsible for permissions and rights for any photos, logos, and brand assets you upload or reference.
Example prompts
Great starting points for grok-imagine-image-v2.
API quick start
Run grok-imagine-image-v2 with a single API call.
{
"prompt": "Make the woman in the image play drums in…",
"samples": 1,
"resolution": "1k",
"quality": "low"
}