Grok Imagine 1.0 Text to Video
- Grok Imagine 1.0 (grok-imagine-video-1.0-t2v) model supports text-to-video mode
- This model accepts text input only; passing
image_urlsreturns an error. For image-to-video, use grok-imagine-video-1.0-i2v - Asynchronous processing mode, use the returned task ID to query
- Generated video links are valid for 24 hours, please save them promptly
Authorizations
##All APIs require Bearer Token authentication##
Get API Key:
Visit API Key Management Page to get your API Key
Add to request header:
Body
Model name
grok-imagine-video-1.0-t2v "grok-imagine-video-1.0-t2v"
Video description prompt (required, cannot be empty)
"A cat playing piano in a jazz club"
Video duration (seconds), any integer between 1 and 15 seconds
1 <= x <= 156
Aspect ratio
Options:
16:9: Landscape (default)9:16: Portrait1:1: Square3:2: Landscape 3:22:3: Portrait 2:34:3: Landscape 4:33:4: Portrait 3:4
16:9, 9:16, 1:1, 3:2, 2:3, 4:3, 3:4 "16:9"
Video resolution, default is 480p
Options:
480p: Standard definition (default)720p: High definition
480p, 720p "480p"
HTTPS callback URL after task completion
Callback Timing:
- Triggered when task is completed, failed, or cancelled
- Sent after billing confirmation
Security Restrictions:
- Only HTTPS protocol supported
- Callback to internal IPs prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- URL length must not exceed
2048characters
Callback Mechanism:
- Timeout:
10seconds - Max
3retries on failure (after1/2/4seconds) - Response format matches task query API
- 2xx status code = success, others trigger retry
"https://your-domain.com/webhooks/video-task-completed"
Response
Video task created successfully
Task creation timestamp
1757169743
Task ID
"task-unified-1757169743-7cvnl5zw"
Actual model name used
"grok-imagine-video-1.0-t2v"
Specific task type
video.generation.task Task progress percentage (0-100)
0 <= x <= 1000
Task status
pending, processing, completed, failed "pending"
Video task detailed information
Task output type
text, image, audio, video "video"
Usage and billing information