Browse ModelsX AIX AI Grok Imagine Image Quality Edit

X Ai Grok Imagine Image Quality Edit

X Ai Grok Imagine Image Quality Edit

Playground

Try it on WavespeedAI!

xAI Grok Imagine Image Quality Edit is a fast AI image editing model that edits and enhances images with high-quality visual output using a dedicated RunPod workflow. Ready-to-use REST inference API for photo retouching, creative image edits, product image enhancement, marketing assets, social media visuals, and professional AI image editing workflows with simple integration, no coldstarts, and affordable pricing.

Features

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

ParameterRequiredDescription
promptYesText prompt describing the desired edit.
imageYesInput image to edit. Quality edit supports one input image.
aspect_ratioNoOutput aspect ratio. Supported values: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3. Default: auto.
resolutionNoOutput resolution tier: 1k or 2k. Default: 1k.
num_imagesNoNumber of edited images to generate. Range: 1–4. Default: 1.
output_formatNoOutput 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

ResolutionCost per Image
1k$0.07
2k$0.09

Example Costs

Resolution1 Image2 Images3 Images4 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.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/x-ai/grok-imagine-image-quality/edit" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "aspect_ratio": "auto",
    "resolution": "1k",
    "num_images": 1,
    "output_format": "jpeg",
    "enable_base64_output": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The prompt for image generation or editing.
imagestringYes-Input image to edit. Quality edit supports one input image.
aspect_ratiostringNoautoauto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3Aspect ratio of the generated image.
resolutionstringNo1k1k, 2kOutput resolution tier.
num_imagesintegerNo11 ~ 4Number of images to generate. Range: 1-4.
output_formatstringNojpegjpeg, png, webpOutput image format.
enable_base64_outputbooleanNofalse-If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated images.
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.