Sign in

v12

latestOpenAPI 3.1.02026-08-031000506.8 KB
Video

Grok Imagine 1.5

Text and image-to-video with native audio by xAI.

post/generate/video/xai/grok-video-1.5

Headers

X-Webhook-URLstring uri

URL to receive a POST request when the job completes. The webhook will receive the job data including results.

Request body

promptstring required
start_imagestring uri nullable

Can be an external URL, base64 data URI, or uploaded asset URL.

start_videostring uri nullable

Can be an external URL, base64 data URI, or uploaded asset URL.

durationnumber
resolution'480p' | '720p' | '1080p'
aspect_ratio'16:9' | '9:16' | '1:1'

Aspect ratio of the generated video. Only used when no start image is provided, to size the auto-generated start frame; with a start image, the output matches its aspect ratio.

Response

The resulting job data. This will be returned in a pending state until the job is completed. See /jobs/{id} for retrieving the results.

job_idstring uuid required
status'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled' required
created_atstring date-time required
{"stackTrail":"paths:/generate/video/xai/grok-video-1.5:post:responses:200:content:application/json:schema:properties:completed_at","oasType":"schema","type":"unknown"}
{"stackTrail":"paths:/generate/video/xai/grok-video-1.5:post:responses:200:content:application/json:schema:properties:result","oasType":"schema","type":"unknown"}