grok-imagine-video-1.5-fast
Grok Imagine Video 1.5 Fast API by xAI on TTAPI supports text-to-video generation. Generate non-official 6 to 30 second clips with prompt, aspect-ratio, and resolution controls.
InputPrompttext
Models1available
FlowAsyncresult URL
Price9 quota6-second price not listed
Examples
Prompt to video, in context
Text-to-video · no reference image
Prompt
This is a scene from a movie, she is having a conversation on the phone with a man, she speaks and pauses to listen then talks again. Her tone is hesitant then determined. She’s walking around slowly and talking on the phone. They are talking about a meetup on Thursday to discuss details.
Text-to-video · no reference image
Prompt
The guy in the middle starts skateboarding slowly, then goes faster, then is going very fast. The camera follows his face from the side in a documentary coming-of-age style. He laughs and says, “I told you bro, this will be the best summer!” Sound: cars passing by, skateboard wheels on pavement, and two other teenagers laughing.
Text-to-video · no reference image
Prompt
The character is showing off her fighting moves, no music.
Capabilities
What you can build with grok-imagine-video-1.5-fast
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-fast 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.
DurationPriceUnit
10 seconds9 quota/ clip
>10 to 20 seconds20 quota/ clip
>20 to 30 seconds30 quota/ clip
API request
grok-imagine-video-1.5-fast 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 reference/grok/generationsAnchor the opening image on 1.5 Fast or 1.5 with first_frame.
Official reference/grok/generationsAnchor the ending image on 1.5 Fast or 1.5 with last_frame.
Official reference/grok/generationsSpecify the opening and ending images on 1.5 Fast or 1.5.
Official reference/grok/generationsPin up to 4 images at interior timestamps on 1.5 Fast or 1.5.
Official referenceHeaders
TT-API-KEYstringrequiredYour TTAPI API key.
Content-TypestringrequiredUse application/json.
Body
promptstringrequiredGeneration prompt. Base, 1.5, and Lite 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, grok-imagine-video-1.5, and grok-imagine-video-1.5-lite.
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, 1.5, and Lite 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 by 1.5 and Lite. Lite 1080P is upscaled from 720P.
refer_imagesstring[]conditionalReference-image URLs. Fast accepts up to 7; base accepts multiple. The 1.5 reference workflow uses one image; other 1.5 workflows use text or explicit frame controls.
first_framestringoptionalFirst-frame image URL. Supported by 1.5 Fast, 1.5, and Lite in the first-frame workflow.
last_framestringoptionalLast-frame image URL. Supported by 1.5 Fast and 1.5. Use the same image for first_frame and last_frame to create a loop effect.
reference_audiosobject[]optionalVoice-character objects for narration or dubbing, each containing voice_id. Accepts up to 3 entries.
hook_urlstringoptionalCallback URL notified when the job completes or fails; otherwise retrieve the result through Fetch.
keyframesobject[]conditionalRequired for keyframe-to-video on 1.5 Fast or 1.5. Up to 4 entries with image: { url } and timestamp_s. Timestamps must be inside the clip and at least 1/3 second apart; can be combined with first_frame and last_frame.
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/generations \
--header 'TT-API-KEY: $TTAPI_KEY' \
--header 'Content-Type: application/json' \
--data '{"model":"grok-imagine-video-1.5-fast","prompt":"two anime friends laughing together on a sunlit snowy city street","aspect_ratio":"2:3","video_length":"6","resolution_name":"720p","first_frame":"https://example.com/first-frame.jpg","last_frame":"https://example.com/last-frame.jpg","reference_audios":[{"voice_id":"luna"}]}'