Sign in

v1

latestOpenAPI 3.1.02026-07-2611077199.5 KB

Grok video generation API. grok-imagine-video supports text-to-video (T2V) and image-to-video (I2V); grok-imagine-video-1.5 only supports image-to-video (I2V), image is required.<br/><br/>Note: Synced with official rules, content moderation failure will also be charged.

post/grok/v1/videos/generations

Request body

promptstring required

Video generation prompt. Required for grok-imagine-video text-to-video; optional for grok-imagine-video-1.5.

model'grok-imagine-video' | 'grok-imagine-video-1.5'

Model name to use.

aspect_ratio'1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '3:2' | '2:3'

Video aspect ratio.

durationinteger

Video duration in seconds. Range: [1, 15]. Default: 8. Accepts both number (8) and string ("8") formats.

resolution'480p' | '720p' | '1080p'

Video resolution.

Example request

{
  "model": "grok-imagine-video-1.5"
}

Response

Request successful

request_idstring required

Request ID

Example response

{
  "request_id": "41eb9a5f-cbd4-9f21-8d59-79005f1e61b7"
}