grok-imagine-video (Official)
Official-channel Grok video generation with prompt, aspect-ratio, duration, resolution, fetch, and extension operations.
InputPrompttext
Models1available
FlowAsyncresult URL
Price3 quota480P official output
Examples
Prompt to video, in context
Text-to-video · no reference images
Prompt
The wave crests fully and pitches forward, the translucent green crest folding and crashing down onto the dark rocks with tremendous force. White foam explodes upward and outward. Sound: the deep boom of a heavy swell hitting rock, the hiss and rush of water pulling back across stone, low wind across an open coastline, and sea spray on a microphone.
Text-to-video · no reference images
Prompt
The camera tracks alongside runners in Bangkok as all four sprint in perfect lockstep, breath visible in the cool morning air. Shopfront shutters, parked motorbikes, and pedestrians streak past in heavy horizontal motion blur. Sound: running shoes on pavement, synchronized breathing, a distant scooter, and an early street-market ambience.
Text-to-video · no reference images
Prompt
The figure slowly lowers the phone from their ear, exhales, and turns almost imperceptibly toward the room. Dust motes drift through golden light while a cat lifts its head and curtains move in a slow breeze. Sound: distant city traffic, a kitchen tap dripping, the soft hum of an old TV, and a creaking wood floor.
Capabilities
What you can build with grok-imagine-video (Official)
Prompt driven generation
Submit a concise prompt and get production-ready video 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-imagine-video (Official) 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.
Input / outputPriceUnit
Input image0.12 quota/ image
480P output3 quota/ second
720P output4.2 quota/ second
API request
grok-imagine-video (Official) operations and request fields
Use the endpoint below with your TTAPI key and the request fields shown.
/grok/v1/videos/generationsSubmit an official-channel Grok task with duration, image, reference_images, and resolution.
Official reference/grok/v1/videos/{request_id}Retrieve an official-channel Grok video result by request_id.
Official reference/grok/v1/videos/extensionsExtend an official Grok video with prompt, source video, duration, and model.
Official referenceHeaders
TT-API-KEYstringrequiredYour TTAPI API key.
Content-TypestringrequiredUse application/json.
Body
promptstringconditionalRequired for grok-imagine-video text-to-video; optional for grok-imagine-video-1.5 image-to-video.
modelenumoptionalDefaults to grok-imagine-video-1.5. Supported: grok-imagine-video and grok-imagine-video-1.5.
aspect_ratioenumoptional1:1, 16:9, 9:16, 4:3, 3:4, 3:2, or 2:3.
durationinteger | stringoptionalDefaults to 8 seconds. Accepts 1–15 as either a number or a numeric string.
imageobjectconditionalImage input object for image-to-video. Required by grok-imagine-video-1.5 and optional for the base model.
reference_imagesobject[]optionalReference-image objects for the reference-to-video workflow.
resolutionenumoptional480p, 720p, or 1080p.
voice_idenumoptionalVoice role ID for the generated video audio. Options include carina, zagan, helix, orion, luna, iris, altair, and zenith.
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/v1/videos/generations \
--header 'TT-API-KEY: $TTAPI_KEY' \
--header 'Content-Type: application/json' \
--data '{"prompt":"static telephoto shot of a coastal apartment building at dusk","model":"grok-imagine-video","aspect_ratio":"2:3","duration":6,"resolution":"720p","voice_id":"luna"}'