Skip to content
Get started
GENERATION API CALLS
Video Generation

xAI

This page is auto-generated from model configurations. Last updated: 2026-08-18.

This reference lists all available xAI video generation models and their parameters. Use these parameter names when calling the Generation API.


Edit an existing video with natural-language instructions using xAI Grok Imagine.

Model ID: model_xai-grok-edit-video

Capabilities: video2video

LLM Markdown: https://app.scenario.com/api/models/model_xai-grok-edit-video/markdown

ParameterTypeRequiredDefaultMinMaxAllowed ValuesDescription
promptstringYes----Instructions for how to edit the video (style, objects, environment, motion)
videofileYes----Video to edit. Auto-preprocessed to max 8.7s at 720p.

Extend an existing video with new footage using xAI Grok: up to 15s of source video is preprocessed at 720p, then 2–10s of continuation is generated from your prompt.

Model ID: model_xai-grok-extend-video

Capabilities: video2video

LLM Markdown: https://app.scenario.com/api/models/model_xai-grok-extend-video/markdown

ParameterTypeRequiredDefaultMinMaxAllowed ValuesDescription
promptstringYes----Describe how the video should continue after the input clip
videofileYes----Source video to extend.
durationnumberNo6210-Seconds of new footage to generate (2-10)

Generate videos using xAI’s Grok model — text-to-video and image-to-video (up to 15s) at 480p or 720p with flexible aspect ratios

Model ID: model_xai-grok-imagine-video

Capabilities: txt2video, img2video

LLM Markdown: https://app.scenario.com/api/models/model_xai-grok-imagine-video/markdown

ParameterTypeRequiredDefaultMinMaxAllowed ValuesDescription
promptstringYes----Text description of the video to generate
imagefileNo----Source image for image-to-video generation. The model will animate the provided image based on the text prompt.
numOutputsnumberNo114-Number of videos to generate concurrently
durationnumberNo5115-Output video duration in seconds (1–15)
aspectRatiostringNoauto--auto, 16:9, 3:2, 4:3, 1:1, 3:4, 2:3, 9:16Aspect ratio for the generated video. Auto will use the aspect ratio of the source image or 16:9 by default in Text to Video mode.
resolutionstringNo480p--480p, 720pOutput resolution for the generated video

Generate videos with xAI’s Grok Imagine Video 1.5 — text-to-video and image-to-video up to 15s at 480p, 720p, or 1080p with flexible aspect ratios and native audio

Model ID: model_xai-grok-imagine-video-1-5

Capabilities: txt2video, img2video

LLM Markdown: https://app.scenario.com/api/models/model_xai-grok-imagine-video-1-5/markdown

ParameterTypeRequiredDefaultMinMaxAllowed ValuesDescription
promptstringYes----Text description of the video to generate. For image-to-video, describe how to animate the source image.
imagefileNo----Optional source image for image-to-video. When set, the model animates this frame from the prompt. Omit for text-to-video.
numOutputsnumberNo114-Number of videos to generate concurrently
durationnumberNo5115-Output video duration in seconds (1-15)
aspectRatiostringNoauto--auto, 16:9, 3:2, 4:3, 1:1, 3:4, 2:3, 9:16Aspect ratio for the generated video. Auto uses the source image ratio for image-to-video, or 16:9 for text-to-video.
resolutionstringNo720p--480p, 720p, 1080pOutput resolution for the generated video. 1080p is available on Grok Imagine Video 1.5 for text-to-video and image-to-video.

Generate subject-consistent video with xAI Grok Imagine Video 1.5 from a prompt plus 1–3 reference images (tag as @image1 / <IMAGE_1> in the prompt). Up to 15s at 480p or 720p with native audio.

Model ID: model_xai-grok-imagine-video-1-5-reference-to-video

Capabilities: img2video

LLM Markdown: https://app.scenario.com/api/models/model_xai-grok-imagine-video-1-5-reference-to-video/markdown

ParameterTypeRequiredDefaultMinMaxAllowed ValuesDescription
promptstringYes----Describe the video. Refer to reference images as @image1, @image2, @image3 (or <IMAGE_1>, <IMAGE_2>, <IMAGE_3>) — order matches your uploaded images. Unlike a first-frame image, references guide people, objects, and clothing without locking the opening frame.
referenceImagesfile_arrayYes----1 to 7 reference images of people, objects, or clothing to feature. Refer to them in the prompt as @image1 / <IMAGE_1> (first image), @image2 / <IMAGE_2>… @image7 / <IMAGE_7>.
numOutputsnumberNo114-Number of videos to generate concurrently
durationnumberNo5115-Output video duration in seconds (1-15)
aspectRatiostringNoauto--auto, 16:9, 3:2, 4:3, 1:1, 3:4, 2:3, 9:16Aspect ratio for the generated video. Auto defaults to 16:9 for reference-to-video.
resolutionstringNo480p--480p, 720pOutput resolution. Reference-to-video supports 480p and 720p (1080p is not available for this mode).