Grok Imagine API
AI ImageGrok Imagine is xAI's entry image route on OmniaKey, turning text prompts into images through the same asynchronous, per-call media API.
- Per successful call$0.04
- OperationsText to image
- View tool pricing and billing rules
Your result will appear here once you run the model.
01
Where it fits
Grok Imagine is xAI's entry image route on OmniaKey, turning text prompts into images through the same asynchronous, per-call media API.
Choose Grok Imagine for text-to-image drafts with xAI's original image model. All three Grok image models share the same per-call price.
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.04per call
More xAI image models
Related articles
Grok Imagine API: Python Guide and 3 Models Tested Side by Side
Three Grok image models, the same four prompts. Here is which to use.
Read articleGrok Imagine 2.0 Prompt Guide: Structure, Examples and Real Images
Eight recipes with real images: what Grok Imagine 2.0 followed, what it added and how to steer it.
Read articleFrequently 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.04 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.
