grok-imagine-video

by xAIVideo

Non-official Grok video generation with text-to-video, image-to-video, multiple reference images, 1–15 second duration, and 720P output.

InputPrompttext
Models1available
FlowAsyncresult URL
Price2 quotanon-official channel
Example clip2:3 portrait preview
grok-imagine-video video example poster6s preview
Example clip

a joyful panda rides a roller coaster through a green park, fast motion, wide-angle close-up

Text to video · Non-official · 6s · 1168 × 1728 · 2:3 portrait · 24 fps
Examples

Prompt to video, in context

Example inputgrok-imagine-video
Prompt

a joyful panda rides a roller coaster through a green park, fast motion, wide-angle close-up

Workflow
Text to video
Channel
Non-official
Duration
6s
Frame size
1168 × 1728
Aspect ratio
2:3 portrait
Frame rate
24 fps
Example resultExample output

Panda coaster ride

A playful panda rushes through a bright park ride with energetic forward motion and a wide-angle perspective.

Capabilities

What you can build with grok-imagine-video

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 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.

Non-official per-second pricingOfficial pricing
ModelPriceUnit
grok-imagine-video2 quota/ second
API request

grok-imagine-video operations and request fields

Use the endpoint below with your TTAPI key and the request fields shown.

POSThttps://api.ttapi.io/grok/generations

Headers

TT-API-KEYstringrequired

Your TTAPI API key.

Content-Typestringrequired

Use application/json.

Body

modelenumoptional

grok-imagine-video-1.5-fast, grok-imagine-video-1.5, or grok-imagine-video.

promptstringrequired

Scene and motion prompt.

aspect_ratioenumoptional

2:3, 3:2, 1:1, 9:16, or 16:9.

video_lengthstringoptional

6–30 seconds for 1.5 Fast; 1–15 seconds for the base and 1.5 models.

resolution_nameenumoptional

Fast: 480p/720p; base: documented as 720p-only; 1.5: 480p/720p/1080p.

refer_imagesstring[]conditional

Fast accepts up to 7 references; base accepts one or more; 1.5 requires exactly one image.

hook_urlstringoptional

Callback URL for job completion.

Open the official TTAPI documentation
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","prompt":"a joyful panda rides a roller coaster through a green park","aspect_ratio":"2:3","video_length":"6","resolution_name":"720p"}'