Sign in

v1

latestOpenAPI 3.1.02026-07-2611077199.5 KB

Submit a Gemini video generation job and receive a jobId asynchronously. Supports omni-flash, veo-3.1-fast, veo-3.1-quality, and veo-3.1-lite models.

post/gemini/video/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

Submitted successfully

statusstring required

Task status

messagestring required

Task message

Example response

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "0ccf0606-3f32-4090-85bd-1786e4593be5"
  }
}