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

Parameter Type Required Default Min Max Allowed Values Description
prompt string Yes - - - - Instructions for how to edit the video (style, objects, environment, motion)
video file Yes - - - - 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

Parameter Type Required Default Min Max Allowed Values Description
prompt string Yes - - - - Describe how the video should continue after the input clip
video file Yes - - - - Source video to extend.
duration number No 6 2 10 - 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

Parameter Type Required Default Min Max Allowed Values Description
prompt string Yes - - - - Text description of the video to generate
image file No - - - - Source image for image-to-video generation. The model will animate the provided image based on the text prompt.
numOutputs number No 1 1 4 - Number of videos to generate concurrently
duration number No 5 1 15 - Output video duration in seconds (1–15)
aspectRatio string No auto - - auto, 16:9, 3:2, 4:3, 1:1, 3:4, 2:3, 9:16 Aspect 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.
resolution string No 480p - - 480p, 720p Output 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

Parameter Type Required Default Min Max Allowed Values Description
prompt string Yes - - - - Text description of the video to generate. For image-to-video, describe how to animate the source image.
image file No - - - - Optional source image for image-to-video. When set, the model animates this frame from the prompt. Omit for text-to-video.
numOutputs number No 1 1 4 - Number of videos to generate concurrently
duration number No 5 1 15 - Output video duration in seconds (1-15)
aspectRatio string No auto - - auto, 16:9, 3:2, 4:3, 1:1, 3:4, 2:3, 9:16 Aspect ratio for the generated video. Auto uses the source image ratio for image-to-video, or 16:9 for text-to-video.
resolution string No 720p - - 480p, 720p, 1080p Output 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

Parameter Type Required Default Min Max Allowed Values Description
prompt string Yes - - - - 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.
referenceImages file_array Yes - - - - 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>.
numOutputs number No 1 1 4 - Number of videos to generate concurrently
duration number No 5 1 15 - Output video duration in seconds (1-15)
aspectRatio string No auto - - auto, 16:9, 3:2, 4:3, 1:1, 3:4, 2:3, 9:16 Aspect ratio for the generated video. Auto defaults to 16:9 for reference-to-video.
resolution string No 480p - - 480p, 720p Output resolution. Reference-to-video supports 480p and 720p (1080p is not available for this mode).