# Grok Imagine Reference to Video

Turn images into video with Grok Imagine Reference to Video from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.

- Provider: fal
- Category: Video
- Runs: In the background
- Returns: video
- Tool id: `fal` / `xai/grok-imagine-video/reference-to-video`
- Page: https://spiral.ai/tools/fal/xai/grok-imagine-video/reference-to-video

## Pricing

`resolution`: 480p (default) $0.065, 720p $0.091 per second. Billed on `duration`, default 8.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 1 hour
- Longest run, end to end: 930 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` (required) | text |  | — | Text prompt describing the video to generate. Use @Image1, @Image2, etc. to reference specific images from reference_image_urls in order. |
| `reference_image_urls` (required) | URLs or files |  | — | One or more reference image URLs to guide the video generation as style and content references. Reference in prompt as @Image1, @Image2, etc. Maximum 7 images. |
| `duration` | number (whole) | 1 to 10 | 8 | Video duration in seconds. |
| `resolution` | one of | 480p, 720p | 480p | Resolution of the output video. |
| `aspect_ratio` | one of | 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16 | 16:9 | Aspect ratio of the generated video. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "xai/grok-imagine-video/reference-to-video",
    "input": {
      "prompt": "A @Image1 running through a sunlit meadow, cinematic slow motion",
      "reference_image_urls": [
        "<reference_image_urls>"
      ]
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=xai%2Fgrok-imagine-video%2Freference-to-video

## Common questions

### Grok Imagine Reference to Video

**How much does Grok Imagine Reference to Video cost?**

`resolution`: 480p (default) $0.065, 720p $0.091 per second. Billed on `duration`, default 8. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Grok Imagine Reference to Video through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "xai/grok-imagine-video/reference-to-video"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Grok Imagine Reference to Video?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Grok Imagine Reference to Video?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

