Grok Imagine Image Quality

Grok

grok-imagine-image-quality

Higher-fidelity official Grok Imagine Image. Send size and resolution; do not send quality.

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 Quality

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-quality-generate-001" \
  -d '{
  "model": "grok-imagine-image-quality",
  "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
}'

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-quality.

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.

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

Higher-fidelity official xAI image route. Do not send quality.

Up to three reference images. Resolution is 1K or 2K.

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-quality-edit-001" \
  -d '{
  "model": "grok-imagine-image-quality",
  "prompt": "Preserve the subject and composition. Change the scene to soft blue hour.",
  "size": "16:9",
  "resolution": "1K",
  "n": 1,
  "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.