---
title: Grok Imagine Image 2.0 | Runware Docs
url: https://runware.ai/docs/models/xai-grok-imagine-image-2-0
description: Next-generation Grok image generation and editing with quality-aware output control
---
# Grok Imagine Image 2.0

![Grok Imagine Image 2.0](https://assets.runware.ai/covers/xai-grok-imagine-image-2-0.jpg)

Grok Imagine Image 2.0 is xAI's next-generation image generation and editing model for both text-to-image and prompt-guided image transformation. It keeps the same core workflow as the current Grok Imagine image family, including aspect-ratio control and image-based editing, while adding a dedicated quality parameter so teams can tune output fidelity within the same API shape. It is a strong fit for creative production pipelines that want one Grok image endpoint for generation, editing, and quality-sensitive iteration without switching to a separate model family.

- **Status**: live
- **ID**: `xai:grok-imagine@image-2.0`
- Try in Playground
- **Creator**: xAI
- **Release Date**: August 10, 2026
- **Zero Data Retention**: Yes
- **Capabilities**: Text to Image, Image to Image, Checkpoint

## Pricing

$0.04 from, per run · ~1m 3s per request

**Rates**

- quality low · 1K · per run: `$0.04`
- quality medium · 1K · per run: `$0.06`
- quality low · 2K · per run: `$0.06`
- quality medium · 2K · per run: `$0.08`
- Input image · per input image: `$0.01`

**4 example generations**

- [text-to-image](https://runware.ai/docs/models/xai-grok-imagine-image-2-0/examples#example-underground-cycling-tourism-campaign-image) · 1248×832 · quality medium: `$0.06` (~1m 44s)
- [text-to-image](https://runware.ai/docs/models/xai-grok-imagine-image-2-0/examples#example-concert-harp-auction-cutout) · 1248×832 · quality medium: `$0.06` (~1m 54s)
- [reference-to-image](https://runware.ai/docs/models/xai-grok-imagine-image-2-0/examples#example-national-seed-curator-persona-portrait) · 2K · quality low: `$0.08` (~22s)
- [reference-to-image](https://runware.ai/docs/models/xai-grok-imagine-image-2-0/examples#example-ammonite-exhibition-gala-invitation) · 2K · quality low: `$0.08` (~23s)

times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Compatibility & Validation

Either provide `inputs.referenceImages`, or specify `width/height`.

---

`resolution` cannot be used with `width/height`.

---

When `resolution` is provided, `inputs.referenceImages` is required.

---

`width` and `height` must be used together.

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `1K (1:1)` | `1024x1024` |
| `1K (3:4)` | `864x1152` |
| `1K (4:3)` | `1152x864` |
| `1K (9:16)` | `720x1280` |
| `1K (16:9)` | `1280x720` |
| `1K (2:3)` | `832x1248` |
| `1K (3:2)` | `1248x832` |
| `1K (9:19.5)` | `576x1248` |
| `1K (19.5:9)` | `1248x576` |
| `1K (9:20)` | `576x1280` |
| `1K (20:9)` | `1280x576` |
| `1K (1:2)` | `704x1408` |
| `1K (2:1)` | `1408x704` |
| `2K (1:1)` | `2048x2048` |
| `2K (3:4)` | `1776x2368` |
| `2K (4:3)` | `2368x1776` |
| `2K (9:16)` | `1584x2816` |
| `2K (16:9)` | `2816x1584` |
| `2K (2:3)` | `1664x2496` |
| `2K (3:2)` | `2496x1664` |
| `2K (9:19.5)` | `1344x2912` |
| `2K (19.5:9)` | `2912x1344` |
| `2K (9:20)` | `1440x3200` |
| `2K (20:9)` | `3200x1440` |
| `2K (1:2)` | `1456x2912` |
| `2K (2:1)` | `2912x1456` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Image output type.

**Allowed values**: `URL` `base64Data` `dataURI`

### [outputFormat](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-outputformat)

- **Type**: `string`
- **Default**: `JPG`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`JPG\`: Best for photorealistic images with smaller file sizes (no transparency).
- \`PNG\`: Lossless compression, supports high quality and transparency (alpha channel).
- \`WEBP\`: Modern format providing superior compression and transparency support.

> [!NOTE]
> \*\*Transparency\*\*: If you are using features like background removal or LayerDiffuse that require transparency, you must select a format that supports an alpha channel (e.g., \`PNG\`, \`WEBP\`, \`TIFF\`). \`JPG\` does not support transparency.

**Allowed values**: `JPG` `PNG` `WEBP`

### [outputQuality](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-deliverymethod)

- **Type**: `string`
- **Default**: `sync`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (1 property)`

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`

Enable or disable content safety checking. Increases total generation time and adds a small charge on top of the generation cost.

### [ttl](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `20`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [referenceImages](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-inputs-referenceimages)

- **Path**: `inputs.referenceImages`
- **Type**: `array of strings`
- **Min items**: `1`
- **Max items**: `5`

List of reference images (UUID, URL, Data URI, or Base64).

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `xai:grok-imagine@image-2.0`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `1`
- **Max**: `64000`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [width](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-width)

- **Type**: `integer`
- **Required**: conditional — Required when inputs.referenceImages is not provided
- **Paired with**: height

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [height](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-height)

- **Type**: `integer`
- **Required**: conditional — Required when inputs.referenceImages is not provided
- **Paired with**: width

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [resolution](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-resolution)

- **Type**: `string`
- **Default**: `1K`

Resolution preset for the output. When used with input media, automatically matches the aspect ratio from the input.

**Allowed values**: `1K` `2K`

**Settings**

Technical parameters to fine-tune the inference process. These must be nested inside the \`settings\` object.

### [quality](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-settings-quality)

- **Path**: `settings.quality`
- **Type**: `string`
- **Default**: `medium`

Image quality level.

**Allowed values**:

- `low` Faster generation with acceptable quality for rapid iteration.
- `medium` Balanced quality suitable for most use cases.

**Features**

Standalone addons and post-processing features.

### [watermark](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-advancedfeatures-watermark)

- **Path**: `advancedFeatures.watermark`
- **Type**: `object (6 properties)`

Configuration object for adding watermarks to generated videos. Watermarks can be applied using either text or image content with customizable positioning and appearance. You must provide either `text` or `image` content for the watermark, but not both.

**Text watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "© 2025 Company",
    "displayPosition": "bottom-right",
    "opacity": 0.6,
    "fontColor": "#ffffff",
    "bgColor": "#000000"
  }
}
```

**Image watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "image": "c64351d5-4c59-42f7-95e1-eace013eddab",
    "displayPosition": "top-left",
    "opacity": 0.6
  }
}
```

**Tiled watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "PREVIEW",
    "tiled": true,
    "opacity": 0.4,
    "fontColor": "#cccccc"
  }
}
```

#### [text](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-advancedfeatures-watermark-text)

- **Path**: `advancedFeatures.watermark.text`
- **Type**: `string`
- **Min**: `2`
- **Max**: `32`

Watermark text.

#### [image](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-advancedfeatures-watermark-image)

- **Path**: `advancedFeatures.watermark.image`
- **Type**: `string`

Watermark image (UUID, URL, Data URI, or Base64).

#### [displayPosition](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-advancedfeatures-watermark-displayposition)

- **Path**: `advancedFeatures.watermark.displayPosition`
- **Type**: `string`

Watermark position.

**Allowed values**: `top-left` `top-center` `top-right` `center-left` `center-center` `center-right` `bottom-left` `bottom-center` `bottom-right` `tiled`

#### [opacity](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-advancedfeatures-watermark-opacity)

- **Path**: `advancedFeatures.watermark.opacity`
- **Type**: `float`
- **Min**: `0.1`
- **Max**: `1`
- **Step**: `0.01`

Watermark opacity.

#### [fontColor](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-advancedfeatures-watermark-fontcolor)

- **Path**: `advancedFeatures.watermark.fontColor`
- **Type**: `string`

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#request-advancedfeatures-watermark-bgcolor)

- **Path**: `advancedFeatures.watermark.bgColor`
- **Type**: `string`

Background color in hex format.

## Response Parameters

### [taskType](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [imageUUID](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#response-imageuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#response-imageurl)

- **Type**: `string`
- **Format**: `uri`

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#response-imagedatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output image.

### [NSFWContent](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/xai-grok-imagine-image-2-0#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### text-to-image (text-to-image)

![Underground Cycling Tourism Campaign Image](https://assets.runware.ai/examples/xai-grok-imagine-image-2-0/e65fd23f-7736-49a0-8f5d-4acb709a6170.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "6083c011-716f-4255-b8be-9a73a38ab0d6",
  "model": "xai:grok-imagine@image-2.0",
  "positivePrompt": "High-end adventure tourism campaign photography inside the historic Peca lead and zinc mine beneath Mežica, Slovenia. A helmeted mountain biker in practical dark trail gear rides through a vast wet rock tunnel toward the camera, leaning dynamically around a shallow bend while a guide follows farther behind. Warm helmet lamps and discreet amber tunnel lights carve luminous paths through cool blue-gray stone; reflections shimmer across puddles and the damp rails of an old mine track. Frame the lead cyclist in the right third, leaving the tunnel’s sweeping curve and layered geological textures visible across the landscape composition. Low camera angle near the water, crisp rider and bicycle, subtle wheel spray, believable safety equipment, atmospheric mineral haze, dramatic chiaroscuro, restrained palette of slate blue, graphite, rust, and amber. Authentic documentary detail elevated with polished European travel-editorial art direction, exhilarating but welcoming, photorealistic, natural anatomy and bicycle geometry, no lettering, no logos, no border.",
  "width": 1248,
  "height": 832,
  "settings": {
    "quality": "medium"
  }
}
```

---

### text-to-image (text-to-image)

![Concert Harp Auction Cutout](https://assets.runware.ai/examples/xai-grok-imagine-image-2-0/b5a23e99-5625-42fd-a5ac-19ae6fe85e7b.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "3723f5e8-9b64-42bc-a2ab-6c4a363d591e",
  "model": "xai:grok-imagine@image-2.0",
  "positivePrompt": "Finished auction-catalog product photograph of one full-size antique concert harp, completely isolated against a smooth warm ivory seamless studio background as if its original cluttered surroundings were professionally removed and replaced. Show the entire harp from crown to feet in a refined three-quarter view, centered with generous negative space and no cropping. Dark walnut sound box, restrained hand-gilded neoclassical ornament, visible red and blue strings, brass mechanisms, subtle signs of authentic age and careful restoration. Preserve crisp, natural edges around every string, pedal, carved flourish, and narrow gap. Large diffused key light from upper left, gentle fill, realistic soft contact shadow directly beneath the feet, accurate wood and metal reflections. High-end European auction-house photography, understated, archival, color-accurate, photorealistic. No people, furniture, props, text, labels, borders, showroom interior, or decorative scenery.",
  "width": 1248,
  "height": 832,
  "settings": {
    "quality": "medium"
  }
}
```

---

### reference-to-image (reference-to-image)

![National Seed Curator Persona Portrait](https://assets.runware.ai/examples/xai-grok-imagine-image-2-0/35ad1c4a-afb8-456b-b912-511cacaebf4a.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "b73f28af-b93c-4d2f-9b12-d42e5bd0436f",
  "model": "xai:grok-imagine@image-2.0",
  "positivePrompt": "Create a finished 3:4 environmental persona portrait for a national seed-bank public education campaign. Use reference image 1 as the definitive character identity: preserve the same facial structure, skin tone, close-cropped hair, tortoiseshell glasses, age, burgundy chore coat, and calm, quietly confident presence so this woman can remain recognizable across future campaign images. Use reference image 2 to define the workplace, color palette, lighting, and visual atmosphere: powder-blue archival seed drawers, stainless work surfaces, glass accession vials, cool cyan ambient light, and a warm amber inspection lamp. Show the curator waist-up at a seed examination table, facing the camera with composed authority, one hand resting beside several carefully arranged seed vials and the other lightly holding a small paper accession envelope. Authentic contemporary agricultural science, practical and human rather than futuristic. Refined medium-format editorial photography, subtle film grain, natural skin texture, crisp eyes, controlled depth of field, cool blue and burgundy palette with amber highlights. Vertical composition with modest breathing room around the head and enough environmental detail to establish her profession. No typography, logos, badges, legible labels, or additional people.",
  "resolution": "2K",
  "settings": {
    "quality": "low"
  },
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/58ade791-3d5a-4a64-8bb7-fd1207d5021e.jpg",
      "https://assets.runware.ai/assets/inputs/8943b1f3-ed6e-44fe-bc75-03611bcbf67e.jpg"
    ]
  }
}
```

---

### reference-to-image (reference-to-image)

![Ammonite Exhibition Gala Invitation](https://assets.runware.ai/examples/xai-grok-imagine-image-2-0/d9a8abbe-f03d-4cf6-a289-938d6683604a.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "ae37269f-4554-4077-b6f1-0944104a08e6",
  "model": "xai:grok-imagine@image-2.0",
  "positivePrompt": "Create the finished flat artwork for a premium portrait museum gala invitation, not a photographed mockup. Use reference image 1 to define the central ammonite precisely: preserve its recognizable spiral silhouette, fine rib structure, mineral texture and bronze-gold coloration. Use reference image 2 to define the surrounding visual language and environment: flowing suminagashi currents, midnight-indigo field, oxidized-copper and sea-green accents, ivory paper grain and elegant organic movement. Place the ammonite large and centered in the lower-middle of the composition, appearing to emerge from tidal rings that echo its spiral. Add restrained copper-foil-style rules and tiny scientific engraving marks for a luxurious natural-history editorial character. Maintain generous negative space and a clear formal hierarchy. Include only this exact invitation copy, set in sophisticated high-contrast serif typography with small widely tracked capitals: “MIDNIGHT TIDE” at the top, “Opening Gala” beneath it, then “18 OCTOBER 2026 · 7 PM” and “NORTH COAST NATURAL HISTORY MUSEUM” near the bottom. Moody, ceremonial and tactile, with excellent print detail and legible lettering; no envelope, hands, table, frame, UI, logos, extra text or mockup presentation.",
  "resolution": "2K",
  "settings": {
    "quality": "low"
  },
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/a2c727dd-69b3-41c1-bd48-ff73e6dab1ee.jpg",
      "https://assets.runware.ai/assets/inputs/80684144-f723-4693-98f5-c915f577bef4.jpg"
    ]
  }
}
```