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
autoto preserve the source framing, or select a preset aspect ratio for a new composition. -
Multiple image generation Generate up to
4edited variations in one request withnum_images. -
Multiple output formats Export results as
jpeg,png, orwebp. -
Simple pricing Pricing depends only on
resolutionandnum_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
- Upload your image — provide the source image you want to edit.
- Write your prompt — describe what should change and what should remain consistent.
- Choose aspect ratio — keep
autoto follow the source framing, or pick a preset ratio if you want a different composition. - Choose resolution — use
1kfor lower cost or2kfor higher-quality output. - Set number of images — choose how many edited variations you want, from
1to4. - Choose output format — select
jpeg,png, orwebp. - 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
1kcosts $0.07 per image2kcosts $0.09 per image- Total price = per-image price ×
num_images aspect_ratioandoutput_formatdo 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
autoaspect ratio when you want to preserve the original image framing. - Use
1kfor quick testing and2kfor higher-quality final outputs. - Increase
num_imageswhen you want multiple edit variations from the same prompt. - Choose
pngwhen image quality matters more than file size.
Notes
- Both
promptandimageare required. - This edit workflow supports one input image.
num_imagessupports values from1to4.aspect_ratiodefaults toauto.resolutiondefaults to1k.output_formatdefaults tojpeg.- Pricing depends only on
resolutionandnum_images.
Related Models
- xAI Grok Imagine Image Quality Text-to-Image — Generate images directly from prompts.
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
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The prompt for image generation or editing. | |
| image | string | Yes | - | Input image to edit. Quality edit supports one input image. | |
| aspect_ratio | string | No | auto | auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 | Aspect ratio of the generated image. |
| resolution | string | No | 1k | 1k, 2k | Output resolution tier. |
| num_images | integer | No | 1 | 1 ~ 4 | Number of images to generate. Range: 1-4. |
| output_format | string | No | jpeg | jpeg, png, webp | Output image format. |
| enable_base64_output | boolean | No | false | - | 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
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated images. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |