grok-imagine-video-1.5 (Official)
Official-channel Grok 1.5 image-to-video generation with first-frame input and 480P, 720P, or 1080P output.
InputPrompttext
Models1available
FlowAsyncresult URL
Price4.8 quota480P official output
Examples
Prompt to video, in context
Prompt
The woman slowly turns her head toward the camera and gives a soft smile, wind gently moving her hair, slow camera push-in, warm golden-hour glow. Audio: soft wind, quiet ambient warmth, a gentle breath, faint cinematic strings rising.
Prompt
Gentle micro-motion only: her hair lifts and drifts in a soft evening breeze, the silk scarf ripples lightly, she blinks naturally and takes one calm slow breath, city bokeh lights flicker softly behind her, camera locked off on a tripod, facial features stay perfectly stable, no warping, subtle photoreal motion
Capabilities
What you can build with grok-imagine-video-1.5 (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-1.5 (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.6 quota/ image
480P output4.8 quota/ second
720P output8.4 quota/ second
1080P output15 quota/ second
API request
grok-imagine-video-1.5 (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":"a contemporary dancer in a sculptural gray costume under a narrow spotlight","model":"grok-imagine-video-1.5","aspect_ratio":"9:16","duration":6,"image":{"url":"https://example.com/first-frame.jpg"},"resolution":"1080p","voice_id":"luna"}'