Grok Imagine 1.5 Image to Video Preview
- Grok Imagine 1.5 (grok-imagine-video-1.5-preview) model supports image-to-video mode, a reference image is required
- 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.5-preview "grok-imagine-video-1.5-preview"
Video description prompt (required, cannot be empty)
Length limit: Up to 4096 characters
"The person starts dancing"
Reference image URL (this model is image-to-video, required)
Requirements:
- Supports only
1image - Image size: max
10MB - Supported formats: JPEG, PNG, WebP
1 elementVideo duration (seconds), any integer between 1 and 15 seconds
1 <= x <= 156
Aspect ratio
Options:
16:9: Landscape (default)9:16: Portrait1:1: Square4:3: Landscape 4:33:4: Portrait 3:43:2: Landscape 3:22:3: Portrait 2:3
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 "16:9"
Video resolution, default is 480p
Description:
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.5-preview"
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