Grok Imagine API
Grok Imagine is xAI's entry image route on OmniaKey, turning text prompts into images through the same asynchronous, per-call media API.
- Model ID
- grok-imagine-image
- Provider
- xAI
- Modality
- AI Image
- Per successful call
- $0.10
- Last verified
- 2026-09-11
Playground
Use this model with your OmniaKey account.
Your next idea, made visible
Start with your own idea or make this prompt yours.
01
Where it fits
Pick Grok Imagine when you want xAI's image model at the lowest Grok price; step up to Grok Imagine 2.0 when output quality matters more than cost.
02
What it does
Text to image
grok-imagine-image
Turn a text prompt into a new image.
03
Call it
Media models run asynchronously. Create a task, poll it until it finishes, then download the signed asset URL.
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: grok-imagine-image-001" \
-d '{
"model": "grok-imagine-image",
"type": "image",
"operation": "generate",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"size": "1024x1024", "quality": "medium"}
}'
# 2. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 3. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"04
Pricing
Image jobs are billed per successful call, not per token. Failed or canceled jobs are refunded automatically.
$0.10per call
More xAI image models
Frequently asked questions
How do I call Grok Imagine on OmniaKey?
POST to /v1/media/tasks with the model id, type "image", and operation "generate" or "edit". Reuse one Idempotency-Key across retries so a timeout never starts a second paid job.
What does Grok Imagine cost?
Grok Imagine bills $0.10 per call. Creation pre-charges that amount from your prepaid balance, and failed or canceled jobs are refunded automatically.
Why does the API return a task id instead of the image?
Provider latency runs from seconds to about a minute, so OmniaKey normalizes every image route into one asynchronous lifecycle. Poll GET /v1/media/tasks/{id} until the status is succeeded, then read the signed asset URL.