Skip to content

Grok Imagine Image · Edit

Integrate

Model id xai/grok-imagine-image/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/xai/grok-imagine-image/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $0.022 22 API credits Run it on this page

Get API key
xAI Image Editing up to 2k #grok#xai#image-editing

Grok image editing from up to 3 input images, with aspect ratio that defaults to the first image

Made on Doitong

Public works made with Grok Imagine Image by the Doitong community. Reuse a prompt in one click.

Public works shown: 13
Art style: 3D Cartoon. Opa Sigmund. Ein 70-jähriger Mann mit flauschigem weißem Haar, einem gepfl...

Art style: 3D Cartoon. Opa Sigmund. Ein 70-jähriger Mann mit flauschigem weißem Haar, einem gepflegten weißen Bart und einer runden Brille auf einer freundlich faltigen Nase. Er trägt einen kuscheligen braunen Strick-Cardigan über einem weißen Hemd mit dunkler Fliege. Seine Augen sind ein warmes...

Art style: 3D Cartoon. Der Enkel. Ein sechsjähriger Junge mit zerzaustem dunkelbraunem Haar und g...

Art style: 3D Cartoon. Der Enkel. Ein sechsjähriger Junge mit zerzaustem dunkelbraunem Haar und großen, neugierigen braunen Augen. Er trägt einen groben Wollpullover in Waldgrün. Er sitzt mit verschränkten Beinen auf einem gemusterten Orientteppich und blickt mit offenem Mund und voller...

Art style: 3D Cartoon. Columbus standing in the middle ground. Columbus is standing on deck in th...

Art style: 3D Cartoon. Columbus standing in the middle ground. Columbus is standing on deck in the middle ground in the midground. Torso facing camera. Head facing camera. Eyes on horizon. Gripping railing. Determined. Ships sits in the middle ground in the background. Wide shot from a low angle,...

Art style: 3D Cartoon. Sigmund standing in the near foreground; Enkel standing further back in th...

Art style: 3D Cartoon. Sigmund standing in the near foreground; Enkel standing further back in the frame. Sigmund is standing on floor in the near foreground in the midground. Torso in three-quarter turn to screen-right. Head in three-quarter turn to screen-right. Eyes on Globe. On globe. Serene....

Art style: 3D Cartoon. Rodrigo standing in the middle ground. Rodrigo is standing on crow's nest ...

Art style: 3D Cartoon. Rodrigo standing in the middle ground. Rodrigo is standing on crow's nest in the middle ground in the foreground. Torso facing camera. Ships sits in the middle ground in the midground. Extreme wide shot from a high angle, 9:16. Horizon high. Opening extreme wide, ending...

Art style: Classic Fairytale. Бао. Round chubby plush panda toy, soft black-and-white fur with vi...

Art style: Classic Fairytale. Бао. Round chubby plush panda toy, soft black-and-white fur with visible fabric pile texture, big fat white belly, black ear and limb patches, shiny black button eyes, tiny stitched smile, stubby legs, waddling gait, no clothing and no props. Silhouette tag: widest...

Cinematic head-and-shoulders portrait, face close-up, sharp eyes in crisp focus, shallow depth of...

Cinematic head-and-shoulders portrait, face close-up, sharp eyes in crisp focus, shallow depth of field, soft key light with gentle rim light, filmic colour grading. The character looks slightly past the camera with a natural, expressive gaze. Neutral, softly blurred background. No text, no...

Art style: Paper Cut. PUP. Paper-cut style small sandy-brown puppy, fluffy layered paper fur, ove...

Art style: Paper Cut. PUP. Paper-cut style small sandy-brown puppy, fluffy layered paper fur, oversized paws and ears, bright shiny dark eyes, no grey on muzzle, the same frayed red collar with round brass tag but loose and sliding over one shoulder, textured torn paper edges, brighter warmer...

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required 88 / 8000

Description in text of the image to create.

resolution default 1k

Image resolution choice between standard (`1k`) and high (`2k`).

default auto

Output aspect-ratio setting for image editing, with `auto` using the first input's proportions. This automatic setting is the default.

num_images default 1

Count of images to produce.

Advanced images · output_format · enable_safety_checker
image_urls
Drop a file, or

Image URLs for editing, supplied as a list with at most 3 images.

output_format default jpeg

File format for the resulting image.

POST /run/xai/grok-imagine-image/edit?wait=20 quote → $0.022
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/xai/grok-imagine-image/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Grok Imagine Image · Edit

Edits images described by a prompt of up to 8000 characters, using up to 3 URLs in `image_urls`. `aspect_ratio` defaults to auto, which keeps the ratio of the first input image, or can be set explicitly. Resolution is 1k or 2k, with up to 4 outputs in jpeg, png or webp. A revised prompt is returned.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptrequired
Typestring
≤ 8,000 characters
Description in text of the image to create.
num_imagesoptional num_outputs
Typeinteger
Default1
1 – 4
Count of images to produce.
aspect_ratiooptional
Typeenum
Defaultauto
auto2:120:919.5:916:94:33:21:12:33:49:169:19.59:201:2
Output aspect-ratio setting for image editing, with `auto` using the first input's proportions. This automatic setting is the default.
resolutionoptional
Typeenum
Default1k
1k2k
Image resolution choice between standard (`1k`) and high (`2k`).
output_formatoptional
Typeenum
Defaultjpeg
jpegpngwebp
File format for the resulting image.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Screening can be relaxed by setting false, provided the caller is authorized.
image_urlsoptional images
Typeurl[] · image
Image URLs for editing, supplied as a list with at most 3 images.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "xai/grok-imagine-image/edit",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 22,
    "usd": "0.022",
    "charged": 22,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "revised_prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
images
array of object {url, content_type, file_name, file_size, width, height}URL pointing to the edited image.
revised_prompt
string | nullEnhanced prompt used for image generation.

More models: Image Editing

For AI agents: this page as Markdown is at https://doitong.com/developers/models/xai/grok-imagine-image/edit.md. All models and guides: https://doitong.com/developers/llms.txt