# 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.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Grok Imagine Video 1.5 Reference-to-Video (tool ID: xai.grok-imagine-video-1-5-reference-to-video). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Generate videos](https://scrollport.com/tools/ai-video-generation-api)

**Current price:** $0.1960/video second

**Availability:** Ready to run

## Tool details

**About this tool**

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.

**Inputs and outputs**

### Input

`aspect_ratio` string · optional

Value supplied for aspect ratio.

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

`duration` integer · optional

Value supplied for duration.

minimum: 1 · maximum: 15

`prompt` string · required

Instruction describing the requested generated output.

minLength: 1 · maxLength: 4096

`reference_image_urls` array · required

Value supplied for reference image urls.

minItems: 1 · maxItems: 7

`resolution` string · optional

Value supplied for resolution.

enum: 480p, 720p

### Output

`note` string

Returned note value.

`video` object

Returned video value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### 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
  }
}
```

**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"}

---

Canonical page: https://scrollport.com/tools/providers/xai/grok-imagine-video-1-5-reference-to-video