API docs / Image models

Grok Imagine Image API

Generate images from text prompts with strong support for readable text rendering within images. Supports multiple visual styles including photorealistic, anime, oil paintings, digital art, pencil sketches, and abstract art. Features fast generation times around 4 seconds per image and handles detailed prompts covering style, mood, lighting, and composition. Also supports image editing by uploading a source image and describing desired changes. Particularly strong at cinematic character rendering with facial consistency, moody aesthetics with dramatic contrast, and creating graphics with clear typography. Supports multiple aspect ratios for different use cases including social media posts and presentations.

Model id
xai/grok-imagine-image
Provider
xai
Output
Image
Price
From 7 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "xai/grok-imagine-image". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "xai/grok-imagine-image",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light"
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptrequiredstring

Text prompt for image generation or editing

reference_imagesarray of URLs

Input image for editing. When provided, the model edits this image based on the prompt. Supports jpg, jpeg, png, webp.

Up to 1 files · Accepts image/*

aspect_ratiostring

Default: 1:1

One of: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, auto