> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ekly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Imagine Image 2.0

> Create polished images or edit up to three references with Grok Imagine Image 2.0.

Create polished images or edit up to three references with Grok Imagine Image 2.0.

| | |
| - | - |
| Model id | `grok-imagine-image-2.0` |
| Media | image |
| Submit to | `POST /v1/images` |
| Price | 3.3 credits per\_generation before discounts |
| Typical time | about 20.0 s |

## Request

**Required:** `prompt`\
**Optional:** `reference_images`, `aspect_ratio`, `image_quality`, `image_resolution`, `generate_image_count`, `output_format`

```json theme={null}
{
  "model": "grok-imagine-image-2.0",
  "prompt": "Editorial portrait of a textile designer in a sunlit studio, handwoven indigo jacket, soft window light, natural skin texture, 85mm lens, no text."
}
```

| Field | Allowed | Default |
| - | - | - |
| `aspect_ratio` | `2:1`, `20:9`, `19.5:9`, `16:9`, `4:3`, `3:2`, `1:1`, `2:3`, `3:4`, `9:16`, `9:19.5`, `9:20` … | `"1:1"` |
| `image_quality` | `low`, `medium` | `"medium"` |
| `image_resolution` | `1k`, `2k` | `"1k"` |
| `generate_image_count` | 1.0 – 1.0 | `1` |
| `output_format` | `jpeg`, `png`, `webp` | `"jpeg"` |
| `reference_images` | asset ids (up to 3) | |

Reference inputs take asset ids from [`POST /v1/uploads`](/uploads) or an earlier output's `asset_id`.
Prices and allowed values come from the live catalog; `GET /v1/models/grok-imagine-image-2.0` is always current.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.