Grok Imagine Image 2.0

xAIImages

xAI's Grok Imagine 2.0: the next generation of image generation and editing.

Our price

$0.030

per image

Official

$0.060

−50% vs official

Get an API key Open in playground

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-2",
    prompt="a red fox in the snow",
)
print(img.data[0].url)

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-2"

The model id.

promptstringrequired

The text description of the image.

imagestringURL or base64

Reference images for editing.

aspect_ratioenum1:1 · 2:3 · 3:2 · 16:9 · 9:16default 1:1

Output aspect ratio.

Response

createdinteger

Unix creation time (seconds).

dataarray

Images. Each: url (our CDN), b64_json, revised_prompt.

Example

cURLPythonJSON

curl https://api.altrouter.ai/v1/images/generations \
  -H "Authorization: Bearer ar-..." \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-2",
  "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.

First request

More from xAI