[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Vidu Q1 Reference to Video](https://spiral.ai/integrations/codex/vidu-q1-reference-to-video)

# How to Use Vidu Q1 Reference to Video in Codex

Combine characters, props, or locations from up to seven reference images in a five-second, 1080p scene. Choose this mode for subject consistency when your references do not need to become the opening frame.

|  |  |
| --- | --- |
| Model | Vidu Q1 Reference to Video |
| Available through | fal |
| Category | Video |
| Price | $0.52 per run. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Vidu Q1 Reference to Video in Codex

- Use Vidu Q1 Reference to Video with the project's mascot, prop, and background images. Create a five-second shot of the mascot standing beside the prop in that location, with a slight head turn.
- Estimate, then generate a 5-second 9:16 clip with Vidu Q1 Reference to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
- Make a 10-second product teaser with Vidu Q1 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 Q1 Reference to Video and list what each cost.
- Make a 6-second 16:9 drone shot over a misty pine forest at sunrise with Vidu Q1 Reference to Video.

## How to set up Vidu Q1 Reference to Video in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 Q1 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/q1/reference-to-video",
    "input": {
      "prompt": "A young woman and a monkey inside a colorful house",
      "reference_image_urls": [
        "<reference_image_urls>"
      ]
    }
  }'
```

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

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

## Vidu Q1 Reference to Video tools and prices

- [Vidu · Reference to Video](https://spiral.ai/tools/fal/fal-ai/vidu/q1/reference-to-video) (fal): $0.52 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — | Random seed for generation |
| aspect_ratio | 16:9, 9:16, 1:1 | 16:9 | The aspect ratio of the output video |
| movement_amplitude | auto, small, medium, large | auto | The movement amplitude of objects in the frame |
| bgm |  | false | Whether to add background music to the generated video |

## What can you do with Vidu Q1 Reference to Video in Codex?

Turn project artwork into short motion assets and test scenes against an existing storyboard. A coding agent can use the repository's images and creative brief to prepare individual five-second shots.

### Animate a finished illustration

Use image-to-video for a five-second character reaction: a glance, a smile, or a small change in posture.

### Keep a mascot across several shots

Reuse a mascot reference in separate scenes, then review its face, clothing, and proportions before editing the clips together.

### Connect two storyboard panels

Supply opening and closing artwork to start-end generation and describe the movement that should connect them.

### Explore a scene before making assets

Use text-to-video to test a setting, lighting idea, and camera direction as a short visual concept.

### Create short anime reactions

Build individual shots around facial expressions or upper-body movement, leaving demanding hand choreography for manual work.

### Combine existing visual assets

Use reference-to-video to place a character, a prop, and a location from separate images into one short scene.

## Overview

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

## Vidu Q1 Reference to Video in other agents

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

## More Codex guides

- [Vidu Q1 Image to Video](https://spiral.ai/integrations/codex/vidu-q1-image-to-video)
- [Vidu Q1 Start-End to Video](https://spiral.ai/integrations/codex/vidu-q1-start-end-to-video)
- [Vidu Image to Video](https://spiral.ai/integrations/codex/vidu-image-to-video)
- [Vidu Q1 Text to Video](https://spiral.ai/integrations/codex/vidu-q1-text-to-video)
- [Video Upscaler Pro](https://spiral.ai/integrations/codex/video-upscaler-pro)
- [Vidu Q2 Pro Image to Video](https://spiral.ai/integrations/codex/vidu-q2-pro-image-to-video)

## Questions about Vidu Q1 Reference to Video in Codex

**Can Codex use Vidu Q1 Reference to Video?**

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

**How much does Vidu Q1 Reference to Video cost in Codex?**

$0.52 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need a fal account to use Vidu Q1 Reference to Video in Codex?**

No. Spiral runs Vidu Q1 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 Q1 Reference to Video in Codex?**

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

**Does Codex wait while Vidu Q1 Reference to Video runs?**

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

**How long are Vidu Q1 videos, and what resolution do they use?**

The Q1 modes covered here make five-second clips at 1080p. Plan longer sequences as separate shots that you edit together.

**Which Q1 mode should I choose?**

Use image-to-video when you have a finished opening image, start-end when you have both endpoint images, and reference-to-video when you want to combine recognizable subjects. Text-to-video is useful when you want to start from a written scene description.

**Can Q1 keep a character recognizable across scenes?**

Reference-to-video is designed to preserve subject appearance from supplied images. Reuse the same references across shots, and review each result before treating the sequence as finished.

**What kinds of movement suit Q1?**

Vidu's published Q1 creator guide recommends facial expressions and upper-body motion. It reports failures with fine hand gestures, full-body action, and complex camera moves, so start with a restrained shot.

**How should I write a Q1 prompt?**

Describe the subject, its action, the setting, and the camera behavior. For these routes, keep the prompt under 1,500 characters and build the shot around one clear action.

