xAI Grok Imagine Image Quality Edit API

xAI Grok Imagine Image Quality Edit

xAI Grok Imagine Image Quality Edit edits an input image using natural-language instructions, with support for multiple aspect ratios, two resolution tiers, selectable output formats, and multi-image generation in a single request. It is suitable for image refinement, style changes, composition adjustments, product visuals, and other prompt-driven image editing workflows.

Why Choose This?

• Prompt-based image editing Edit an existing image by describing the changes you want in natural language.

• Quality-focused edit workflow Built for higher-quality image editing with support for resolution tiers and multiple output formats.

• Flexible aspect ratios Choose auto to preserve the source framing, or select a preset aspect ratio for a new composition.

• Multiple image generation Generate up to 4 edited variations in one request with num_images.

• Multiple output formats Export results as jpeg, png, or webp.

• Simple pricing Pricing depends only on resolution and num_images.

Parameters

Parameter	Required	Description
prompt	Yes	Text prompt describing the desired edit.
image	Yes	Input image to edit. Quality edit supports one input image.
aspect_ratio	No	Output aspect ratio. Supported values: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3. Default: auto.
resolution	No	Output resolution tier: 1k or 2k. Default: 1k.
num_images	No	Number of edited images to generate. Range: 1–4. Default: 1.
output_format	No	Output image format: jpeg, png, or webp. Default: jpeg.

How to Use

1. Upload your image — provide the source image you want to edit.
2. Write your prompt — describe what should change and what should remain consistent.
3. Choose aspect ratio — keep auto to follow the source framing, or pick a preset ratio if you want a different composition.
4. Choose resolution — use 1k for lower cost or 2k for higher-quality output.
5. Set number of images — choose how many edited variations you want, from 1 to 4.
6. Choose output format — select jpeg, png, or webp.
7. Submit — run the model and download the edited images.

Example Prompt

Turn this product photo into a premium studio advertisement with soft cinematic lighting, a clean neutral background, realistic reflections, and polished commercial styling.

Pricing

Pricing is based on resolution and num_images.

Per Image

Resolution	Cost per Image
1k	$0.07
2k	$0.09

Example Costs

Resolution	1 Image	2 Images	3 Images	4 Images
1k	$0.07	$0.14	$0.21	$0.28
2k	$0.09	$0.18	$0.27	$0.36

Billing Rules

• 1k costs $0.07 per image
• 2k costs $0.09 per image
• Total price = per-image price × num_images
• aspect_ratio and output_format do not affect pricing

Best Use Cases

• Product photo refinement — Upgrade product shots for ads, listings, and brand materials.
• Style changes — Rework an image into a new visual style or mood.
• Composition adjustments — Use aspect ratio controls to adapt the edit for different formats.
• Creative variations — Generate multiple edited options in one run with num_images.
• Marketing creatives — Produce polished visuals for campaigns, social media, and presentations.

Pro Tips

• Be specific about what should change and what should stay the same.
• Use auto aspect ratio when you want to preserve the original image framing.
• Use 1k for quick testing and 2k for higher-quality final outputs.
• Increase num_images when you want multiple edit variations from the same prompt.
• Choose png when image quality matters more than file size.

Notes

• Both prompt and image are required.
• This edit workflow supports one input image.
• num_images supports values from 1 to 4.
• aspect_ratio defaults to auto.
• resolution defaults to 1k.
• output_format defaults to jpeg.
• Pricing depends only on resolution and num_images.

Related Models

• xAI Grok Imagine Image Quality Text-to-Image — Generate images directly from prompts.