[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [Vidu Q4 Reference to Video](https://spiral.ai/integrations/cursor/vidu-q4-reference-to-video)

# How to Use Vidu Q4 Reference to Video in Cursor

Build short scenes around supplied characters, products, settings, and voices. Unlike Image to Video, this version uses references to guide subject consistency across camera positions rather than fixing one image as the opening frame.

|  |  |
| --- | --- |
| Model | Vidu Q4 Reference to Video |
| Available through | fal |
| Category | Video |
| Price | $0.43225 per run at the default inputs. `resolution`: 540p $0.20475, 720p (default) $0.43225, 1080p $0.546, 2K $0.8645, 4K $1.7745. $0.08645 per unit of `duration`. |
| Returns | video, image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Vidu Q4 Reference to Video in Cursor

- Use Vidu Q4 Reference to Video with the mascot and workshop images in assets/references. Make an 8-second 1080p scene: the mascot sets a small box on the workbench, looks up, and smiles. Identify each image's role in the generation prompt.
- Use Vidu Q4 Reference to Video with assets/characters/guide.png and assets/voices/guide.mp3. Create an 8-second 1080p scene with generated sound: the guide turns toward the camera and says, 'Your next chapter starts here.' Bind the voice reference to that speaker.
- Estimate, then generate a 5-second 9:16 clip with Vidu Q4 Reference to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
- Make a 10-second product teaser with Vidu Q4 Reference to Video for a smartwatch, slow orbit shot, studio lighting.
- Generate three 5-second b-roll clips of a busy coffee shop with Vidu Q4 Reference to Video and list what each cost.

## How to set up Vidu Q4 Reference to Video in Cursor

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Vidu Q4 Reference to Video**: One request; the result comes back by polling or a webhook.

```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": "fal-ai/vidu/q4/reference-to-video",
    "input": {
      "prompt": "[@reference_image_1] walks along the beach at sunset holding [@reference_image_2], then turns to the camera and speaks in the voice of [reference_audio_1]."
    }
  }'
```

Then paste one of the prompts above: Cursor finds Vidu Q4 Reference to Video on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/cursor

## Vidu Q4 Reference to Video tools and prices

- [Vidu Q4 · Reference to Video](https://spiral.ai/tools/fal/fal-ai/vidu/q4/reference-to-video) (fal): $0.43225 per run at the default inputs. `resolution`: 540p $0.20475, 720p (default) $0.43225, 1080p $0.546, 2K $0.8645, 4K $1.7745. Per unit of `duration`: 540p $0.04095, 720p (default) $0.08645, 1080p $0.1092, 2K $0.1729, 4K $0.3549.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| reference_image_urls |  | — | URLs or base64 data URIs of up to 12 reference images (png, jpeg, jpg, webp) used to keep subjects consistent. |
| reference_audio_urls |  | — | URLs or base64 data URIs of up to 3 mp3 reference audio clips (3-12 seconds each, max 50 MB) used to keep voices consistent. |
| duration | 3 to 16 | 5 | Duration of the video in seconds (3-16) |
| seed |  | — | Random seed for reproducibility. If None, a random seed is chosen. |
| aspect_ratio | 16:9, 9:16, 4:3, 3:4, 1:1 | 16:9 | The aspect ratio of the output video |
| resolution | 540p, 720p, 1080p, 2K, 4K | 720p | Output video resolution |

## What can you do with Vidu Q4 Reference to Video in Cursor?

Turn project artwork into short product shots, character scenes, and video assets for a site or app. Use an existing frame when composition is settled, or combine references when a scene needs several visual elements.

### Product reveal

Start with a product photograph or product references. Direct a short camera move and a lighting change that reveal the material, then check the product's appearance before using the shot.

### Recurring character scenes

Reuse character and setting references to develop separate short scenes. Review identity and appearance across the selected clips before assembling a sequence.

### Dialogue with a reference voice

Pair a character reference with a voice sample and a brief line of dialogue. Specify the speaker's action and emotional delivery.

### Film shot planning

Explore how a planned scene plays with a camera move or a change of shot. Use a storyboard frame for a fixed opening, or character and environment references for a newly composed scene.

### Short social scenes

Build a self-contained visual moment within 16 seconds: a character notices something, reacts, and delivers a short line. Keep each clip focused on a clear sequence.

### Camera direction comparisons

Try the same subject and action with a slow push-in, a lateral track, and a static camera. Compare the selected shots before committing to the sequence.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Cursor guides](https://spiral.ai/integrations/cursor)

## Vidu Q4 Reference to Video in other agents

- [Amp](https://spiral.ai/integrations/amp/vidu-q4-reference-to-video)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/vidu-q4-reference-to-video)
- [Claude](https://spiral.ai/integrations/claude-desktop/vidu-q4-reference-to-video)
- [Claude Code](https://spiral.ai/integrations/claude-code/vidu-q4-reference-to-video)
- [Cline](https://spiral.ai/integrations/cline/vidu-q4-reference-to-video)
- [Codex](https://spiral.ai/integrations/codex/vidu-q4-reference-to-video)
- [Devin](https://spiral.ai/integrations/devin/vidu-q4-reference-to-video)
- [dots](https://spiral.ai/integrations/dots/vidu-q4-reference-to-video)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/vidu-q4-reference-to-video)
- [Gemini](https://spiral.ai/integrations/gemini/vidu-q4-reference-to-video)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/vidu-q4-reference-to-video)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/vidu-q4-reference-to-video)
- [goose](https://spiral.ai/integrations/goose/vidu-q4-reference-to-video)
- [Grok](https://spiral.ai/integrations/grok/vidu-q4-reference-to-video)
- [Grok Build](https://spiral.ai/integrations/grok-build/vidu-q4-reference-to-video)
- [Hermes](https://spiral.ai/integrations/hermes/vidu-q4-reference-to-video)
- [Instinct](https://spiral.ai/integrations/instinct/vidu-q4-reference-to-video)
- [Manus](https://spiral.ai/integrations/manus/vidu-q4-reference-to-video)
- [Muse](https://spiral.ai/integrations/muse/vidu-q4-reference-to-video)
- [Muse Code](https://spiral.ai/integrations/muse-code/vidu-q4-reference-to-video)
- [n8n](https://spiral.ai/integrations/n8n/vidu-q4-reference-to-video)
- [Notion](https://spiral.ai/integrations/notion/vidu-q4-reference-to-video)
- [OpenClaw](https://spiral.ai/integrations/openclaw/vidu-q4-reference-to-video)
- [opencode](https://spiral.ai/integrations/opencode/vidu-q4-reference-to-video)
- [Perplexity](https://spiral.ai/integrations/perplexity/vidu-q4-reference-to-video)
- [Raycast](https://spiral.ai/integrations/raycast/vidu-q4-reference-to-video)
- [VS Code](https://spiral.ai/integrations/vscode/vidu-q4-reference-to-video)
- [Windsurf](https://spiral.ai/integrations/windsurf/vidu-q4-reference-to-video)
- [Zapier](https://spiral.ai/integrations/zapier/vidu-q4-reference-to-video)

## More Cursor guides

- [Vidu Q4 Image to Video](https://spiral.ai/integrations/cursor/vidu-q4-image-to-video)
- [Vidu Reference to Video](https://spiral.ai/integrations/cursor/vidu-reference-to-video)
- [Vidu Q3 Turbo Text to Video](https://spiral.ai/integrations/cursor/vidu-q3-turbo-text-to-video)
- [Vidu Start-End to Video](https://spiral.ai/integrations/cursor/vidu-start-end-to-video)
- [Vidu Q3 Turbo Image to Video](https://spiral.ai/integrations/cursor/vidu-q3-turbo-image-to-video)
- [Vidu Template to Video](https://spiral.ai/integrations/cursor/vidu-template-to-video)

## Questions about Vidu Q4 Reference to Video in Cursor

**Can Cursor use Vidu Q4 Reference to Video?**

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run Vidu Q4 Reference to Video like any built-in tool.

**How much does Vidu Q4 Reference to Video cost in Cursor?**

$0.43225 per run at the default inputs. `resolution`: 540p $0.20475, 720p (default) $0.43225, 1080p $0.546, 2K $0.8645, 4K $1.7745. $0.08645 per unit of `duration`. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Cursor plan is separate.

**Do I need a fal account to use Vidu Q4 Reference to Video in Cursor?**

No. Spiral runs Vidu Q4 Reference to Video on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Vidu Q4 Reference to Video in Cursor?**

About two minutes: add the hosted server, then sign in.

**Does Cursor wait while Vidu Q4 Reference to Video runs?**

Vidu Q4 Reference to Video runs in the background. Cursor starts the run, checks on it and gives you the video, image when it's ready.

**When should I choose Image to Video over Reference to Video?**

Choose Image to Video when you already have the exact opening frame. Choose Reference to Video when you want to build a scene around supplied characters, objects, settings, or voices.

**How long can a Vidu Q4 clip be, and how large can it be?**

Plan for a maximum of 16 seconds per generated clip, with output reaching 4K. For a longer piece, write separate shots and assemble the selected clips afterward.

**Does Image to Video keep my picture's shape?**

Yes. Vidu says the output keeps the original image's aspect ratio, so prepare the opening image in the framing you want.

**Can I guide a character's voice?**

Reference to Video supports reference sound alongside the visuals. Identify the intended speaker and voice reference in the prompt, then give the exact dialogue and delivery you want.

**What should I put in a Q4 prompt?**

Describe what happens, in what order, how the camera moves, and how the scene is lit. For references, state what each image or voice contributes instead of leaving the model to infer those relationships.

