Image Generation
Grok Image API
xAI Grok Imagine. Fast tier for quick iteration, Quality tier for higher fidelity at 1k or 2k. Integrate this model via REST with endpoint docs, parameters, and code examples.
Get API Key
Create auth keys for apps and agents
See Usage
Track requests, credits, and logs
Buy Credits
Top up prepaid API capacity
API Endpoint
/api/v1/models/xai-image/runTest This Model
Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.
LLM.txt
For AI assistants
Copy this model's documentation into Claude, GPT, or any AI for instant integration help.
/llm/xai-image.txtOpenAPI Spec
Swagger compatible
Import into Postman, Swagger UI, or generate client SDKs in any language.
/api/openapiParameters
Input parameters accepted by this model
| Parameter | Type | Default |
|---|---|---|
promptrequired | string | - |
aspect_ratio | enum | 1:1 |
quality | enum | fast |
resolution | enum | 2k |
Use saved characters (@Name)
@Name of a saved character is refused (400) before anything is charged. A saved location, prop or style with a description is inserted as text. For saved characters, use a model that takes reference images, such as Nano Banana Pro or Seedream 5 for images, or Seedance 2.5 or WAN 3.0 for video.Supported Aspect Ratios
See also
Related endpoints on this model — you may need a different apiId for a different operation (e.g. image edit vs generation).
Example Outputs
Real outputs generated by this model
A misty mountain valley at dawn, layered ridgelines, a winding river through pine forest, soft light
A cozy independent bookshop interior with warm lamplight and towering shelves, inviting reading nook
A delicate hummingbird hovering beside a trumpet flower, iridescent feathers, crisp macro photography
A playful golden retriever leaping into a lake to fetch a stick, water splashing, sunny summer day
A dramatic desert landscape with towering red rock arches under a star-filled night sky, long exposure
A charming Parisian cafe corner with a striped awning and flowers, cobblestone street, soft morning light
A vintage typewriter on a desk beside a steaming coffee and an open notebook, warm cinematic lighting
A vibrant coral reef alive with tropical fish and a sea turtle, crystal-clear water, sun rays underwater
A surreal floating island with waterfalls spilling into the clouds, fantasy landscape, golden light
A field of vibrant tulips stretching to a windmill on the horizon, bright blue sky, Dutch countryside
A snow-dusted log cabin glowing warmly in a pine forest at twilight, smoke from the chimney, peaceful
A detailed steaming bowl of ramen with fresh herbs and a soft egg, overhead shot, appetizing food photography
A retro 1960s diner at dusk, neon signs glowing, classic cars parked outside, nostalgic warm tones
A curious orange tabby kitten peeking out of a wicker basket, soft window light, adorable detail
A powerful waterfall cascading through a lush green canyon, mist catching rainbow light, wide landscape
A rustic loaf of crusty bread and a glass of red wine on a wooden table, candlelit, moody food photography
A whimsical hot air balloon shaped like a whale floating over rolling green hills, dreamy pastel sky
An elegant modern living room with floor-to-ceiling windows overlooking a misty forest, warm natural light
A vibrant street food market at night, glowing lanterns and sizzling woks, rich atmospheric color
A lone red sailboat on a calm turquoise sea at golden hour, minimalist composition, gentle reflections
A close-up of a bee collecting pollen from a sunflower, wings mid-flutter, macro detail, soft bokeh
A serene Japanese tea garden in spring, cherry blossoms drifting over a koi pond, soft morning light, highly detailed
A cozy attic art studio bathed in afternoon sun, canvases and brushes everywhere, warm dust motes in the light
A majestic snow leopard resting on a rocky Himalayan ledge, piercing eyes, crisp wildlife photography
a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelated dragon and reads "Pixel Dojo". The woman says "Gotta have that pixel dojo candy. with over 60 ai tools, it's basically zero calories."
a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelated dragon and reads "Pixel Dojo". The woman says "Gotta have that pixel dojo candy. with over 60 ai tools, it's basically zero calories."
a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelated dragon and reads "Pixel Dojo". The woman says "Gotta have that pixel dojo candy. with over 60 ai tools, it's basically zero calories."
A dramatic low-angle photograph of a master martial artist mid-strike inside a sleek modern dojo, shattering a wooden board that explodes into thousands of glowing purple and pink pixel fragments that scatter through the air like embers. The dojo has polished concrete floors, floor-to-ceiling windows revealing a rain-soaked Tokyo cityscape at night, and minimal Japanese architectural details — clean wooden beams, a torii gate silhouette visible through the glass. The pixel fragments cast colored light across the fighter's face and the wet floor reflections. Shot on Sony A7R V, 35mm f/1.4, shallow depth of field, dramatic side lighting from a single overhead spotlight cutting through atmospheric haze, rain streaks visible on the windows. Hyperrealistic, editorial photography, 8K resolution
Code Examples
Generate image(s) — copy and paste to get started
curl -X POST "https://pixeldojo.ai/api/v1/models/xai-image/run" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A retro-futurist skyline at dawn",
"num_outputs": 2
}'Response Format
Submit Response (202 Accepted)
{
"jobId": "job_abc123...",
"status": "pending",
"statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
"creditCost": 1,
"creditsRemaining": 95,
"expiresAt": "2026-10-10T02:49:48Z"
}Completed Response
{
"jobId": "job_abc123...",
"status": "completed",
"output": {
"images": [
"https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
]
},
"creditCost": 1,
"expiresAt": "2026-10-10T02:49:48Z"
}