Grok Imagine Image 2.0

Grok

grok-imagine-image-2.0

Official Grok Imagine Image 2.0. Quality applies to text-to-image only. Use references for edits.

Text-to-imageImage-to-imageImage editMulti-image

Get API key Official docs

Output

Completed images appear here after a successful Credit debit.

API

Call Grok Imagine Image 2.0

ImgRouter uses one request contract. Send this model ID to POST /v1/images/generations. Examples below match the recommended defaults on this page.

POST/v1/images/generations

cURL

curl https://api.imgrouter.com/v1/images/generations \
  -H "Authorization: Bearer $IMGROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: grok-imagine-image-2.0-generate-001" \
  -d '{
  "model": "grok-imagine-image-2.0",
  "prompt": "A cozy coffee shop interior with warm lighting, wooden tables, and plants by the window on a rainy afternoon.",
  "size": "16:9",
  "resolution": "1K",
  "n": 1,
  "quality": "medium"
}'

Request body

Parameters and usage notes

These are the ImgRouter fields. Official upstream names such as image_urls are mapped from reference_images.

modelstring · requiredDefault and required: grok-imagine-image-2.0.

promptstring · requiredText instruction, 1–5,000 characters. Describe the image or the edit you want.

sizestring · default 16:9Aspect ratio. Supported: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, auto. Prefer an explicit ratio instead of auto when you need predictable framing.

resolutionstring · default 1KOutput tier. Supported: 1K, 2K. Higher tiers cost more Credits.

ninteger · 1–10Number of output images. Send a number, not a quoted string. Defaults to 1 and cannot exceed 10.

qualitystringRecommended value: medium.

reference_imagesstring[] · max 3Public HTTPS image URLs for image-to-image or edit. Send this field to POST /v1/images/edits. Official docs may call this image_urls.

Controls

Size, resolution, and output

Aspect ratio or size

1:116:99:164:33:43:22:32:11:2auto

Resolution

1K2K

Output format

url

Route notes

Official xAI image route. quality is low or medium for text-to-image only.

Do not send quality when reference_images is present.

Up to three reference images. Image URLs expire.

Reference workflow

Edit with reference images

Send public HTTPS source images with the same core controls. This route accepts up to 3 reference images.

POST/v1/images/edits

cURL

curl https://api.imgrouter.com/v1/images/edits \
  -H "Authorization: Bearer $IMGROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: grok-imagine-image-2.0-edit-001" \
  -d '{
  "model": "grok-imagine-image-2.0",
  "prompt": "Preserve the subject and composition. Change the scene to soft blue hour.",
  "size": "16:9",
  "resolution": "1K",
  "n": 1,
  "quality": "medium",
  "reference_images": [
    "https://example.com/reference.jpg"
  ]
}'

Response

Read the completed output

Successful requests return completed image URLs and a request ID. Store the assets you need permanently; routed output URLs may expire.

200 · JSON

{
  "id": "req_01K4…",
  "object": "image.generation",
  "created": 1787424152,
  "data": [
    { "url": "https://static.imgrouter.com/images/req_01K4.webp" }
  ],
  "usage": { "images": 1 }
}

Use GET /v1/requests/{request_id} for reconciliation and GET /v1/balance for the authenticated key's current Credit position.