Skip to content

Grok Imagine Image 2.0 · Text to Image

Integrate

Model id xai/grok-imagine-image/v2.0/text-to-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/xai/grok-imagine-image/v2.0/text-to-image?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Files like the example: $0.06 60 API credits · ≈ ₽6.45 your files are measured before the run Run it on this page

Get API key
xAI Text to Image up to 2k #text-to-image#xai#grok

Grok Imagine 2.0 text-to-image with 13 aspect ratios, 1k or 2k resolution, and up to 4 images

xAI · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

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`).

quality default medium

Quality setting for the generated image.

default 1:1

Width-to-height ratio for the output image.

num_images default 1

Count of images to produce.

Advanced output_format · enable_safety_checker
output_format default jpeg

File format for the resulting image.

POST /run/xai/grok-imagine-image/v2.0/text-to-image?wait=20 quote → $0.06
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/xai/grok-imagine-image/v2.0/text-to-image?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.ru/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 2.0 · Text to Image

Generates images from a text `prompt` of up to 8000 characters. Produces 1 to 4 images per call, with 13 aspect ratios from 1:2 to 2:1 (default 1:1) and `1k` or `2k` resolution. Output can be jpeg, png or webp, with low or medium `quality`. The response includes the revised prompt that was actually used.

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
Default1:1
2:120:919.5:916:94:33:21:12:33:49:169:19.59:201:2
Width-to-height ratio for the output image.
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.
qualityoptional
Typeenum
Defaultmedium
lowmedium
Quality setting for the generated image.
required Canonical name, also accepted

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "xai/grok-imagine-image/v2.0/text-to-image",
  "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": 60,
    "usd": "0.06",
    "charged": 60,
    "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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 generated image.
revised_prompt
string | nullEnhanced prompt used for image generation.

More models: Text to Image

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