scrollport
Back to Reference to video

Grok Imagine Video 1.5 Reference-to-Video

xAI

Generate video from one to seven reference images and a tagged text prompt with duration and aspect-ratio controls.

Capability
Video generation
Current price
$0.1960/video second
Availability
Ready to run
Last accepted verification

What this API does

Create a 480p or 720p Grok Imagine Video 1.5 clip guided by one to seven public reference images tagged in the prompt. Duration, resolution, aspect ratio and reference count are known before the run, and Scrollport preserves the generated MP4 as a private artifact.

Agents select this operation with tool ID xai.grok-imagine-video-1-5-reference-to-video, then inspect its current executable contract before a run.

Public input and output shape

Input

aspect_ratiostring · optional

Value supplied for aspect ratio.

enum: 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16

durationinteger · optional

Value supplied for duration.

minimum: 1 · maximum: 15

promptstring · required

Instruction describing the requested generated output.

minLength: 1 · maxLength: 4096

reference_image_urlsarray · required

Value supplied for reference image urls.

minItems: 1 · maxItems: 7

resolutionstring · optional

Value supplied for resolution.

enum: 480p, 720p

Output

notestring

Returned note value.

videoobject

Returned video value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "xai.grok-imagine-video-1-5-reference-to-video",
  "input": {
    "prompt": "the person from <IMAGE_0> walks through a rain-lit street while the camera follows at eye level",
    "duration": 3,
    "resolution": "480p",
    "aspect_ratio": "16:9",
    "reference_image_urls": [
      "https://v3b.fal.media/files/b/0a8b90e0/BFLE9VDlZqsryU-UA3BoD_image_004.png"
    ]
  }
}

Output

{
  "note": "video returned as an artifact",
  "video": {
    "audio": true,
    "resolution": "480p",
    "content_type": "video/mp4",
    "duration_seconds": 3
  }
}
Teaching errors and limitations
  • invalid_input: reference_image_urls must contain 1–7 public image URLs and duration must be 1–15 secondsexample: {"prompt":"the person from <IMAGE_0> walks through a rain-lit street while the camera follows at eye level","reference_image_urls":["https://v3b.fal.media/files/b/0a8b90e0/BFLE9VDlZqsryU-UA3BoD_image_004.png"],"duration":3,"resolution":"480p","aspect_ratio":"16:9"}
Updated
18 August 2026

Use Grok Imagine Video 1.5 Reference-to-Video with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.