[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Seedance 2.0 Fast Reference to Video](https://spiral.ai/integrations/codex/seedance-2-0-fast-reference-to-video)

# How to Use Seedance 2.0 Fast Reference to Video in Codex

Use Seedance 2.0 Fast Reference to Video to test scenes guided by visual and audio references at 720p. Unlike Seedance 2.0 Fast Image to Video, it can borrow camera movement from a video reference.

|  |  |
| --- | --- |
| Model | Seedance 2.0 Fast Reference to Video |
| Available through | fal |
| Category | Video |
| Price | $0.314 per second at 720p ($0.146 at 480p). With reference videos: $0.189 per second at 720p, reference seconds included. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Seedance 2.0 Fast Reference to Video in Codex

- Use Seedance 2.0 Fast Reference to Video with the project's character image and location image. Create a 10-second, 720p scene: the character crosses the location while the camera tracks sideways, with footsteps and wind.
- Estimate, then generate a 5-second 9:16 clip with Seedance 2.0 Fast Reference to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
- Make a 10-second product teaser with Seedance 2.0 Fast Reference to Video for a smartwatch, slow orbit shot, studio lighting.
- Generate three 5-second b-roll clips of a busy coffee shop with Seedance 2.0 Fast Reference to Video and list what each cost.
- Make a 6-second 16:9 drone shot over a misty pine forest at sunrise with Seedance 2.0 Fast Reference to Video.

## How to set up Seedance 2.0 Fast 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 Seedance 2.0 Fast 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": "bytedance/seedance-2.0/fast/reference-to-video",
    "input": {
      "prompt": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea."
    }
  }'
```

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

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

## Seedance 2.0 Fast Reference to Video tools and prices

- [Seedance 2.0 Fast · Reference to Video](https://spiral.ai/tools/fal/bytedance/seedance-2.0/fast/reference-to-video) (fal): $0.314 per second at 720p ($0.146 at 480p). With reference videos: $0.189 per second at 720p, reference seconds included.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_urls |  | — | Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 9 images. Total files across all modalities must not exceed 12. |
| video_urls |  | — | Reference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 3 videos, combined duration must be between 2 and 15 seconds, total size under 50 MB. Each video must be between ~480p (640x640) and ~720p (834x1112) in resolution. |
| audio_urls |  | — | Reference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 3 files, combined duration must not exceed 15 seconds. Max 15 MB per file. At least one reference image or video is required. |
| resolution | 480p, 720p | 720p | Video resolution - 480p for faster generation, 720p for balance. |
| duration | auto, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 | auto | Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. |
| aspect_ratio | auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | auto | The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide. |

## What can you do with Seedance 2.0 Fast Reference to Video in Codex?

Turn a project's creative brief into short video assets with planned motion, cuts, and sound. A coding agent can prepare shot directions from project materials and keep the resulting clips organized for review.

### Product motion studies

Plan a short product scene around one movement, such as a bottle turning or fabric unfolding, with a camera move that reveals its shape.

### Short social ads

Build a 10-second scene around a single visual idea, then try a different camera move or opening action for the next draft.

### Storyboard previews

Preview a compact sequence with labeled shots before filming. Keep each shot focused on one action so the staging and camera plan are easy to judge.

### Atmospheric cutaways

Create brief inserts such as rain on a window, wind through curtains, or steam rising from a cup. Pair the visible movement with matching ambient sound.

### Sound-led close-ups

Plan a short close-up around an audible action, such as a zipper closing or paper crumpling. Describe the sound and motion together.

### Animate an existing illustration

Use an illustration to guide a short scene with a head turn, drifting fabric, or a slow camera push. Review the result for changes to the original design.

### Match a camera reference

Use a supplied video to guide camera movement while separate images establish the subject and setting. State which part of each reference the model should follow.

## Overview

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

## Seedance 2.0 Fast Reference to Video in other agents

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

## More Codex guides

- [Seedance 2.0 Fast Image to Video](https://spiral.ai/integrations/codex/seedance-2-0-fast-image-to-video)
- [Seedance 2.0 Fast Text to Video](https://spiral.ai/integrations/codex/seedance-2-0-fast-text-to-video)
- [Seedance 1.0 Pro Text to Video](https://spiral.ai/integrations/codex/seedance-1-0-pro-text-to-video)
- [Seedance 2.0 Image to Video](https://spiral.ai/integrations/codex/seedance-2-0-image-to-video)
- [Seedance 1.0 Pro Image to Video](https://spiral.ai/integrations/codex/seedance-1-0-pro-image-to-video)
- [Seedance 2.0 Image to Video (US)](https://spiral.ai/integrations/codex/seedance-2-0-image-to-video-us)

## Questions about Seedance 2.0 Fast Reference to Video in Codex

**Can Codex use Seedance 2.0 Fast Reference to Video?**

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

**How much does Seedance 2.0 Fast Reference to Video cost in Codex?**

$0.314 per second at 720p ($0.146 at 480p). With reference videos: $0.189 per second at 720p, reference seconds included. 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 Seedance 2.0 Fast Reference to Video in Codex?**

No. Spiral runs Seedance 2.0 Fast 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 Seedance 2.0 Fast Reference to Video in Codex?**

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

**Does Codex wait while Seedance 2.0 Fast Reference to Video runs?**

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

**What is Seedance 2.0 useful for?**

Short scenes where movement, camera direction, and sound need to work together. Product motion studies, atmospheric footage, and compact story sequences are practical starting points.

**How long can a Seedance 2.0 video be?**

A single generation lasts 4 to 15 seconds. Plan longer pieces as separate clips, with a clear action for each.

**Can Seedance 2.0 make several shots in one clip?**

Yes. Label the shots and keep each focused on one action and one camera move; use a longer clip when the sequence needs room for cuts.

**Can Seedance 2.0 generate sound with the picture?**

Yes. It generates synchronized audio with the video, including music, dialogue, and sound effects; describe the sounds that matter to the scene.

**How should I write a Seedance 2.0 prompt?**

Describe a visible action and how the camera follows it. For several shots, label each cut and give every shot one clear action and camera movement.

