Grok Imagine

xAIImages

xAI's Grok Imagine: image generation and editing.

Our price
$0.030
per image

First request

from openai import OpenAI

client = OpenAI(
    base_url="https://api.altrouter.ai/v1",
    api_key="ar-...",
)

img = client.images.generate(
    model="grok-imagine",
    prompt="a red fox in the snow",
)
print(img.data[0].url)

The interface is OpenAI-compatible: in existing code only the base_url, the key and the model id change — nothing else.

Grok Imagine against its price neighbours

Grok Imagine and its closest neighbours by price: prices and parameters from the AltRouter AI catalog
ModelPriceUnitDiscount
Qwen Image 3.0Alibaba$0.028image−8%Open
Nano Banana 2 LiteGoogle$0.028image−17%Open
FLUX.2 ProBlack Forest$0.030image—Open
Wan 2.7Alibaba$0.030image—Open
Grok Imaginethis pagexAI$0.030image—

Prices and parameters come from the same catalog as the price above; this is not a benchmark, it is comparable billing terms.

Limits

Pricing is flat — $0.030 per image, regardless of prompt length. Allowed aspect_ratio values: 1:1, 16:9, 9:16, 2:3, 3:2.

There is no subscription: every successful request is billed at the price above, and a failed one is not billed at all. There is no markup over the vendor's official price. No xAI account of your own is needed: requests go to api.altrouter.ai and we make the upstream call.

Rate limiting is shared across models and counted per key: 600 requests per minute by default, and a 429 with retry-after: 60 above it. An individual key can get its own limit and a spending cap per day, week, month or lifetime in the dashboard.

Full limits and credits

When to pick Grok Imagine, and when a neighbour

The cheaper neighbour is Nano Banana 2 Lite: $0.028 per image against $0.030 for Grok Imagine. On the same volume the bill comes out 1.1× smaller. It is the sensible pick where the task is repetitive and high-volume — labelling, classification, short templated answers — the kind of work where quality is bounded by the prompt rather than the model.

The dearer neighbour is FLUX.2 Pro: $0.030 per image. On catalog parameters it offers the same capabilities and the same order of context, so the premium is only justified if Grok Imagine falls short on your own task.

Guessing is more expensive than checking: the table above is prices and parameters, not a benchmark, and it cannot tell you which model does better on your own prompt. Switching costs one line — the model id in the request changes, the base_url and the key stay — so running both on your own data takes minutes.

API

OpenAI-compatible image generation endpoint. The result is re-hosted on our CDN and returned as a URL.

POST/v1/images/generations
Body parameters
modelstringrequired"grok-imagine"
The model id.
promptstringrequired
The text description of the image.
imagestringURL or base64
Reference images for editing.
aspect_ratioenum1:1 · 16:9 · 9:16 · 2:3 · 3:2default 1:1
Output aspect ratio.
enable_probooleandefault false
Pro mode: higher quality, costs more.
Response
createdinteger
Unix creation time (seconds).
dataarray
Images. Each: url (our CDN), b64_json, revised_prompt.
Example
cURLPythonJavaScriptJSON
curl https://api.altrouter.ai/v1/images/generations \
  -H "Authorization: Bearer ar-..." \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine",
  "prompt": "a red fox in the snow",
  "aspect_ratio": "1:1"
}'
Errors
400Invalid request.
401Missing or invalid API key.
402Insufficient credits, or the key’s spending cap is exhausted.
404Model not found.
429Rate limit exceeded.

More from xAI