XAI | Grok Imagine | Reference to Video.

XAI Grok Imagine Reference to Video Overview

The Reference to Video Model generates video guided by one or more reference images using them as style and content references.

One or more image references guide the generated video's style and content.

XAI Grok Imagine Reference to Video from xAI is available through each::labs in the grok-imagine family. Required fields are prompt, image_urls.

duration: Duration of the generated video in seconds (1-15). aspect_ratio: Aspect ratio of the generated video.

Use the XAI Grok Imagine Reference to Video API when you need this transformation or analysis as a repeatable step in an application or creative pipeline. The sections below distinguish the required material, adjustable controls and checks that matter before delivery.

Capabilities

• One or more image references guide the generated video's style and content.
• duration: Duration of the generated video in seconds (1-15).
• aspect_ratio: Aspect ratio of the generated video.
• resolution: Output video resolution.
• image_urls: URLs of reference images to guide video generation (1-7).

Use Cases for XAI Grok Imagine Reference to Video

XAI Grok Imagine Reference to Video is useful when this specific operation fits between source preparation and delivery. These scenarios show how it can support different parts of a working pipeline.

Creators

Create a reference-led story beat. Use a representative source or a concise brief, then inspect the result before preparing a larger set of assets.

Design and marketing teams

Draft a branded scene. Compare the result with the intended message, composition and destination. Keep reviewable versions of the source and output.

Developers

Explore character motion from approved stills. Inspect the actual returned value before connecting it to another step, and keep the chosen request settings with the result.

Start with a clear definition of the desired result and use the exposed controls to reach it. Keep any additional generation, editing or application logic in separate steps so that the effect of this operation remains easy to review.

Tips and Tricks

Describe one coherent shot before adding complex action. State the subject, movement, camera behavior and setting separately. For reference-guided requests, choose source images with clear subjects and compatible framing.

• aspect_ratio: Aspect ratio of the generated video.
• resolution: Output video resolution.

• Example direction: “A slow camera push toward the subject; one gentle movement, consistent lighting, no scene cut.”
• Example direction: “The subject turns slightly toward the camera while the background remains still.”

Compare one deliberate adjustment at a time. Inspect the part of the result affected by that change, then check the rest of the asset or response for unwanted side effects before reusing the settings.

Technical Specifications

• Result type: video.
• Required fields: prompt, image_urls.
• duration: integer or null; options 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, None; default 8; minimum 1; maximum 15.
• aspect_ratio: string; options 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16; default "16:9".
• resolution: string; options 480p, 720p; default "480p".
• prompt: string.

image_urls: URLs of reference images to guide video generation (1-7).

Values must use the types and accepted options listed in the parameter reference. A displayed default does not remove a required-field requirement. Choose a supported output setting for this entry rather than borrowing a preset from a related model.

Things to Be Aware Of

Watch the entire clip rather than reviewing only a thumbnail. Check subject identity, object boundaries, motion continuity, camera changes and the ending; review the audio as well when the entry includes it.

Optional settings are not necessarily interchangeable with those on another entry in the same family. Use the accepted names, types and values shown for this operation.

For media-based inputs, supply a directly retrievable file URL rather than a page containing the asset. Keep the source available while processing. Check the final content in the destination player, editor or application, not only the request status.

Key Considerations

State the intended role of the references and inspect subject consistency throughout the result.

Public estimate: $0.05–$0.07 per second.

Prepare prompt, image_urls before starting. Optional settings include duration, aspect_ratio, resolution. Keep these settings aligned with the intended delivery, especially when a later step expects a particular type or format.

Run a representative request before scaling to a larger collection. Judge the result against the source and the brief, and account for all generated outputs or usage-sensitive options when estimating a batch.

Limitations

• prompt: maximum characters: 4096.
• image_urls: minimum items: 1; maximum items: 7; item string; item format: uri.

Unsupported parameters do not establish additional capabilities. A generated result can differ from the intended brief, so review detail and consistency before publication.