6s preview
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
6s previewExamples
Prompt to video, in context
Prompt
static telephoto shot of a coastal apartment building at dusk, sea in the background, subtle wind and warm window light
- Workflow
- Text to video
- Channel
- Official
- Duration
- 6s
- Frame size
- 1152 × 1744
- Aspect ratio
- 2:3 portrait
- Frame rate
- 24 fps
Coastal dusk
A restrained coastal observation balances cool sea haze with a single warm apartment window.
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 video task.
Official reference/grok/v1/videos/{request_id}Retrieve an official-channel Grok video result.
Official reference/grok/v1/videos/extensionsExtend an official-channel Grok video.
Official referenceHeaders
TT-API-KEYstringrequiredYour TTAPI API key.
Content-TypestringrequiredUse application/json.
Body
promptstringconditionalRequired for base text-to-video; optional for grok-imagine-video-1.5 image-to-video.
modelenumoptionalgrok-imagine-video or grok-imagine-video-1.5.
aspect_ratioenumoptional1:1, 16:9, 9:16, 4:3, 3:4, 3:2, or 2:3.
durationintegeroptional1–15 seconds; defaults to 8 when omitted.
imageobjectconditionalRequired first-frame image for grok-imagine-video-1.5; optional for the base model.
reference_imagesobject[]optionalReference images for supported workflows.
resolutionenumoptional480p, 720p, or 1080p.
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"}'