Grok Imagine Image Quality Edit

Name: Grok Imagine Image Quality Edit
Author: xAI

xai/grok-imagine-image/quality/edit

Grok Imagine Image Quality Edit is xAI's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Use in agent Get API key

Base price: $0.05USD / run
Execution: async
Model type: image
Input fields: 4

Try the model

Playground

Open playground

Input

Prompt(string)

Text description of the desired image.

Image URL or upload(array)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

List of URLs of the images to edit. A maximum of 3 images are supported.

Resolution(string)

Resolution of the generated image. `1k` for standard resolution, `2k` for high resolution. Allowed values: 1k, 2k.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Specifications

Pricing

Base price: $0.05 / run
Billing formula: params.resolution == "2K" ? 0.07 : 0.05

Context & modalities

Input: Schema-defined
Output: image

Capabilities

Chat: Not supported
Vision: Not supported
Reasoning: Not supported
Structured output: Not supported
Function calling: Not supported
Audio input: Not supported

Access

Provider: xAI
Model ID: xai/grok-imagine-image/quality/edit
Execution: async
API: Unified Run API
Endpoint: /v1/run

API README

Grok Imagine Image Quality Edit

Grok Imagine Image Quality Edit is a specialized SandBase endpoint built to revise up to three supplied images through natural-language direction. It is most useful when teams need controlled image revision and reference blending, with the route’s inputs defining a repeatable production contract instead of leaving critical delivery choices to an ad-hoc manual workflow.

Use this exact route when its input mode matches the creative asset already in hand: describe the visual or spoken result clearly, set only the controls that support the intended delivery, and keep the subject, action, environment, camera or performance direction internally consistent. The result is returned asynchronously as a downloadable media URL suitable for review, automation, or downstream finishing.

Highlights

Finish-focused image revision. Apply a natural-language change while aiming at a higher-fidelity asset suitable for publishing or further design work.
Multi-source editing. Up to three images can jointly anchor the subjects, products, palette, or style that must survive the transformation.
Resolution-specific finishing. Select 1K for standard placements or 2K when the edit must retain more texture and edge detail.
Recomposition across formats. Ten aspect ratios allow the revised content to be staged for widescreen, square, portrait, or vertical delivery.

Pricing

Pricing is determined by output resolution.

Resolution	Price
1K	$0.0500
2K	$0.0700

When to Use

Scenario	Why this route fits
Concept development	Choose Grok Imagine Image Quality Edit when its edit workflow matches the starting material and you need several clearly directed variations.
Production iteration	Use explicit duration, resolution, ratio, seed, or quality controls to compare versions without changing the core creative brief.
Channel adaptation	Generate directly in the landscape, square, portrait, or vertical format required by the destination whenever that control is available.
Automated pipelines	Integrate the asynchronous media URL into review queues, asset libraries, publishing tools, or a later finishing stage.
Alternative route	Pick a related text-, image-, reference-, edit-, or turbo route when the available source media or required degree of control is different.

Prompt Guide

Lead with the main subject or source asset, then describe the intended action or transformation, environment, composition, camera or vocal delivery, lighting and mood. Keep instructions concrete and compatible; use the route’s explicit fields for duration, resolution, ratio, quality, voice, or reproducibility instead of burying those settings in prose.

{
  "prompt": "A cinematic product reveal with deliberate subject motion, coherent lighting, and a slow camera push.",
  "resolution": "1k",
  "aspect_ratio": "21:9",
  "images": [
    "https://example.com/reference-1.jpg"
  ]
}

Technical Specs

Property	Details
Model ID	`xai/grok-imagine-image/quality/edit`
Required inputs	`prompt`
Execution	Asynchronous; poll the returned generation ID
Output	Downloadable media URL
`images`	array; optional
`prompt`	string; required
`resolution`	string; optional; choices: 1k, 2k; default: 1k
`aspect_ratio`	string; optional; choices: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16

Related Models

Model	Best for
`xai/grok-tts`	Alternative grok tts workflow
`xai/grok-imagine-video/text-to-video`	Alternative text to video workflow
`xai/grok-imagine-video/extend`	Alternative extend workflow
`xai/grok-imagine-video/image-to-video`	Alternative image to video workflow

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API

Unified Run API endpoint

https://api.sandbase.ai/v1/run

Model ID

xai/grok-imagine-image/quality/edit

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "xai/grok-imagine-image/quality/edit",
  "images": [
    "https://static.sandbase.ai/examples/xai/grok-imagine-image/quality/edit/input_images_0.png"
  ],
  "prompt": "Make this scene more realistic but still keep the game vibes",
  "resolution": "1k"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All language models

Model	Context	Input / 1M	Output / 1M	Released
Grok Imagine Image Quality EditThis model `xAI`	—	—	—	May 7, 2026
Grok Imagine Image Quality `xAI`	—	—	—	May 7, 2026
Grok Imagine Image Edit `xAI`	—	—	—	Jan 29, 2026