progrok video

Generate, edit, or extend Grok Imagine videos through the same OAuth session used by the proxy. The command hides async polling and accepts local files, URLs, data URIs, or file_id:<id> media references.

progrok video "A cat walking on the moon"
progrok video "Animate this scene" --image ./photo.png
progrok video "Use these references" --ref ./person.png --ref ./outfit.png --duration 6
progrok video "animate this scene" --model grok-imagine-video-1.5-preview --image ./photo.png
progrok video edit "make the light warmer" --video ./clip.mp4
progrok video extend "camera pulls back" --video file_id:file-abc123 --duration 5

Options

Flag	Description
`--image`	Source image for image-to-video. File, URL, data URI, or `file_id:<id>`.
`--ref`	Reference image for reference-to-video. Repeatable up to 7 times; cannot be combined with `--image`.
`--video`	Source video for edit/extend. File, URL, data URI, or `file_id:<id>`.
`--model`	`grok-imagine-video` by default; `grok-imagine-video-1.5-preview` is live-smoked as I2V only.
`--output`	Output file path for downloaded MP4.
`--duration`	Generation duration 1-15s; reference-to-video max 10s; extension duration 2-10s.
`--seconds`	Send the OpenAI-compatible `seconds` alias instead of `duration`.
`--upload-url`	Send `output.upload_url` when you have a signed destination URL.
`--json`	Print the final xAI response instead of downloading the MP4.

REST vs SDK Names

REST does not use a mode field. Vercel AI SDK mode strings such as edit-video, extend-video, and reference-to-video map to different endpoints or fields in REST. progrok exposes the REST-native shape.