Glowing marble cyborgExample 01
grok-image
grok-image is available through TTAPI. Fast image generation with a minimal request shape and flexible aspect ratios.
InputPrompttext
Models1available
FlowAsyncresult URL
Price2 quota/ image
Glowing marble cyborgExample 01
Submerged sleeping beautyExample 02
Emerald leaf emergenceExample 03
Misty hillsideExample 04Examples
Prompt to image, in context
Prompt
front shot of a hyper-realistic glowing marble cyborg woman wearing a greek dress made of fabric and illuminated electronic pieces, glowing background
Prompt
a woman seeing from above in a transparent water tank, minimalist setting, she is mostly submerged in water, she is wearing a random colour dedicated dress, random illumination, ethereal pose, like a goddess or a sleeping beauty
Prompt
hyper realistic scene where a beautiful white woman wearing a delicate frills dress is emerging from big and abundant dark green leafs, covered almost completely by the leafs, so the face and a few parts of the body are emerging only
Prompt
A surrealist, dreamlike masterpiece of a lush, misty green hillside enveloped in thick, ethereal fog. The aesthetic is defined by a vintage 2000s CCD digicam texture, featuring characteristic digital grain, slight motion blur, and a soft-focus glow. Low-contrast, dreamy pastel color palette with muted greens and hazy whites. The lighting is diffused and atmospheric, as if captured during a foggy dawn. Masterful composition, ethereal and calm, high-art photography style, 4k, cinematic atmosphere, nostalgic filmic quality.
Prompt
A photograph of an albino woman in an acrobatic pose, wearing a tracksuit against a dark background.
Prompt
An ethereal female figure with futuristic and retro elements, in a serene, vintage photographic style.
Capabilities
What you can build with grok-image
Prompt driven generation
Submit a concise prompt and get production-ready image output through one TTAPI job.
Core controls only
Keep integration simple with prompt, model, output settings, and callback handling.
Async result flow
Use polling or webhook callbacks so long-running generations do not block your UI.
Ready for product UI
Return Grok Image results that can be displayed, stored, or passed into downstream workflows.
Pricing
Per-action, in quota
Usage is metered in quota by model, action, and output settings.
OperationPriceUnit
Generate image2 quota/ image
Fetch resultFree/ request
API request
Headers and submit parameters
Use the endpoint below with your TTAPI key and the request fields shown.
/grok/imageSubmit a Grok text-to-image task.
Official reference/grok/image/editsEdit an existing image with Grok.
Official reference/grok/image/fetchRetrieve the generated Grok image result.
Official referenceHeaders
TT-API-KEYstringrequiredYour TTAPI API key.
Content-TypestringrequiredUse application/json.
Body
promptstringrequiredImage generation prompt.
modelenumoptionalDefaults to grok-imagine-1.0. The current API also lists grok-imagine-image and grok-imagine-image-quality.
enable_probooleanoptionalDefaults to true for quality mode; set false for speed mode.
aspect_ratioenumoptionalDefaults to 1:1. 1.0 supports 1:1, 16:9, 9:16, 3:2, and 2:3; the Image models add 4:3, 3:4, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, and auto.
resolutionenumoptionalDefaults to 1k. All listed models support 1k; 2k is available for grok-imagine-image and grok-imagine-image-quality.
nintegeroptionalNumber of images to generate, from 1 to 4.
hook_urlstringoptionalCallback URL for job completion.
Integrate
From key to first result
Copy the resolved endpoint, authentication headers, and request body for this model.
curl --request POST \
--url https://api.ttapi.io/grok/image \
--header 'TT-API-KEY: $TTAPI_KEY' \
--header 'Content-Type: application/json' \
--data '{"prompt":"A surrealist, dreamlike masterpiece of a lush, misty green hillside enveloped in thick, ethereal fog.","model":"grok-image","enable_pro":true,"aspect_ratio":"16:9","resolution":"1k","n":1,"hook_url":"https://example.com/callback"}'
