grok-imagine-video-1.5
Non-official Grok 1.5 image-to-video generation requiring exactly one source image, with 1–15 second duration and up to 1080P output.
Prompt to video, in context
What you can build with grok-imagine-video-1.5
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-1.5 results that can be displayed, stored, or passed into downstream workflows.
Per-action, in quota
Usage is metered in quota by model, action, and output settings.
grok-imagine-video-1.5 operations and request fields
Use the endpoint below with your TTAPI key and the request fields shown.
/grok/generationsSubmit a non-official Grok video task with video_length, resolution_name, reference images, and an optional callback.
Official reference/grok/fetchRetrieve a non-official Grok video result.
Official reference/grok/extensionsExtend a non-official Grok video.
Official referenceHeaders
TT-API-KEYstringrequiredYour TTAPI API key.
Content-TypestringrequiredUse application/json.
Body
promptstringrequiredGeneration prompt. Base and 1.5 accept up to 4,096 characters; 1.5 Fast supports longer prompts.
modelenumoptionalDefaults to grok-imagine-video-1.5-fast. Also supports grok-imagine-video and grok-imagine-video-1.5.
aspect_ratioenumoptionalDefaults to 16:9. Supported: 2:3, 3:2, 1:1, 9:16, and 16:9.
video_lengthstringoptionalDefaults to 10. Fast supports 6–30 seconds; base and 1.5 support 1–15 seconds. Base supports up to 15 seconds with one image and up to 10 with multiple images.
resolution_nameenumoptionalDefaults to 720p. 480p and 720p work across all models; 1080p is supported only by grok-imagine-video-1.5.
refer_imagesstring[]conditionalReference-image URLs. Fast accepts up to 7; base accepts multiple; 1.5 requires exactly one image.
voice_idenumoptionalVoice role ID for the generated video audio. Options include carina, zagan, helix, orion, luna, iris, altair, and zenith.
hook_urlstringoptionalCallback URL notified when the job completes or fails; otherwise retrieve the result through Fetch.
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/generations \
--header 'TT-API-KEY: $TTAPI_KEY' \
--header 'Content-Type: application/json' \
--data '{"model":"grok-imagine-video-1.5","prompt":"a young man closes his eyes on a crowded nightclub dance floor","aspect_ratio":"2:3","video_length":"6","resolution_name":"1080p","refer_images":["https://example.com/first-frame.jpg"],"voice_id":"luna"}'