Browse ModelsX AIX AI Grok Imagine Image Edit

X Ai Grok Imagine Image Edit

X Ai Grok Imagine Image Edit

Playground

Try it on WavespeedAI!

X-AI Grok Imagine Image enables precise image editing with xAI’s Grok Imagine model. Transform and modify images using text prompts with AI-powered precision. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Grok Imagine Image Edit

Grok Imagine Image Edit is X-AI’s image editing model that transforms existing images based on text prompts. Upload your source image and describe the changes you want — the model intelligently edits while maintaining visual coherence.


Why Choose This?

  • Text-driven editing Modify images using natural language instructions for intuitive control.

  • Context-aware modifications Understands scene structure and object relationships for coherent edits.

  • Style preservation Maintains the original image’s visual quality during edits.

  • Prompt Enhancer Built-in tool to automatically improve your editing instructions.

  • Cost-effective Affordable per-image pricing for high-volume editing workflows.


Parameters

ParameterRequiredDescription
promptYesText instruction describing the desired edit
imageYesSource image to edit (URL or upload)

How to Use

  1. Upload your image — provide the source image you want to edit.
  2. Write your prompt — describe the changes you want to make.
  3. Run — submit and download your edited image.

Pricing

OutputCost
Per image$0.022

Best Use Cases

  • Photo Retouching — Remove unwanted objects, fix imperfections, enhance details.
  • Scene Modification — Change backgrounds, add or remove elements.
  • Style Transfer — Apply different visual styles to existing images.
  • Content Adaptation — Modify images for different contexts and platforms.
  • Creative Exploration — Experiment with variations of existing visuals.

Pro Tips

  • Use the Prompt Enhancer to refine your editing instructions.
  • Be specific about what to change and what to preserve.
  • Describe the desired outcome rather than the process (e.g., “the man wearing a red shirt” instead of “change the shirt color to red”).
  • Use high-quality source images for better editing results.
  • Combine with Grok Imagine Image T2I to generate base images, then edit.

Notes

  • Both prompt and image are required fields.
  • Ensure uploaded image URLs are publicly accessible.
  • For best results, use clear and specific edit instructions.

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/edit" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "num_images": 1,
    "output_format": "png"
}'

# 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 to edit the image with.
imagestringYes-The source image to edit.
num_imagesintegerNo11 ~ 10Number of images to generate (1-10).
output_formatstringNopngpng, jpegOutput image format.

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.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
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 content.
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.