[Integrations](https://spiral.ai/integrations) › [Devin](https://spiral.ai/integrations/devin) › [Seedance 2.5 Reference to Video](https://spiral.ai/integrations/devin/seedance-2-5-reference-to-video)

# How to Use Seedance 2.5 Reference to Video in Devin

Combine character, scene, motion, and sound references to direct a short video. Unlike Seedance 2.5 Image to Video, it can work from multiple images, videos, and audio clips, and edit or extend existing footage.

|  |  |
| --- | --- |
| Model | Seedance 2.5 Reference to Video |
| Available through | fal |
| Category | Video |
| Price | $0.601 per second at 720p ($0.267 at 480p, $1.48 at 1080p) for 16:9 or 9:16. Other shapes: $1.94 at 1080p. With reference videos: $0.361 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.5 Reference to Video in Devin

- Use Seedance 2.5 Reference to Video with our character image and camera blockout. Make a 12-second, 720p preview: the image defines appearance, and the video defines camera motion and staging.
- Estimate, then generate a 5-second 9:16 clip with Seedance 2.5 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.5 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.5 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.5 Reference to Video.

## How to set up Seedance 2.5 Reference to Video in Devin

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

### Use Spiral's MCP server

1. **Add a custom MCP**: Open Customize › MCPs. Click + and choose New MCP. Fill in:

2. **Sign in to Spiral and approve**: In Customize › MCPs, open Spiral and choose Connect. Spiral opens: sign in, pick the organization and click Authorize. No API key.

3. **Check it**: On Spiral's configuration page, click Test tools. Devin lists Spiral's tools.

### Use the Spiral skill

1. **Send Devin 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.5 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.5/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: Devin finds Seedance 2.5 Reference to Video on Spiral, shows the price and runs it.

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

## Seedance 2.5 Reference to Video tools and prices

- [Seedance 2.5 · Reference to Video](https://spiral.ai/tools/fal/bytedance/seedance-2.5/reference-to-video) (fal): $0.601 per second at 720p ($0.267 at 480p, $1.48 at 1080p) for 16:9 or 9:16. Other shapes: $1.94 at 1080p. With reference videos: $0.361 per second at 720p, reference seconds included.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| prompt |  | — | The text prompt used to generate the video. |
| task | auto, reference, editing, extension | reference | The type of video generation task. Reference uses the supplied media as guidance. Editing modifies a reference video and automatically coerces aspect_ratio and duration to auto. Extension continues a reference video and automatically coerces aspect_ratio to auto. Auto leaves the task type unset so the model decides it from the prompt and references. |
| image_urls |  | — | Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 30 images. Total files across all modalities must not exceed 50. |
| video_urls |  | — | Reference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 10 videos. Each video must be 1.8 to 30.2 seconds and no larger than 200 MB; combined duration must not exceed 30.2 seconds. Dimensions must be 300 to 6,000 pixels per side, aspect ratio 0.4 to 2.5, and frame rate 24 to 60 FPS. |
| audio_urls |  | — | Reference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 10 files. Each file must be 1.8 to 30.2 seconds and no larger than 15 MB; combined duration must not exceed 30.2 seconds. |
| resolution | 480p, 720p, 1080p | 720p | Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality. |

## What can you do with Seedance 2.5 Reference to Video in Devin?

Turn a project's creative brief or artwork into short video assets with Seedance 2.5. A coding agent can read project files, draft scene directions, and organize takes for review.

### Short ad concepts

Test a simple commercial scene: introduce the subject, show one action, and finish on a clear closing composition.

### Film scene previews

Try camera movement and performance blocking before committing to a shoot. Keep each preview focused on one scene.

### Atmospheric website footage

Create a short shot of rain, moving fabric, or a quiet landscape for a website background. Request restrained motion and review the final framing.

### Dialogue scene studies

Explore a brief spoken exchange with visible reactions. Specify the speaker, language, line, and delivery.

### Short narrative videos

Build a story lasting up to 30 seconds around a setup, change, and resolution. Give each stage enough time to be visible.

### Animated product photography

Start from a product image and add a slow camera move or a small physical action. State which product features should stay consistent.

### Illustration animation

Bring an illustration into motion with blinking, wind, or a gentle push toward the subject. Use the artwork to establish the visual style.

### 3D blockout previews

Use a rough 3D scene video to guide camera movement and staging, then describe the intended characters, materials, and lighting.

## Overview

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

## Seedance 2.5 Reference to Video in other agents

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

## More Devin guides

- [Seedance 2.5 Image to Video](https://spiral.ai/integrations/devin/seedance-2-5-image-to-video)
- [Seedance 2.5 Text to Video](https://spiral.ai/integrations/devin/seedance-2-5-text-to-video)
- [Seedance 2.0 Text to Video](https://spiral.ai/integrations/devin/seedance-2-0-text-to-video)
- [Seedance 2.5 US Image to Video](https://spiral.ai/integrations/devin/seedance-2-5-us-image-to-video)
- [Seedance 2.0 Reference to Video](https://spiral.ai/integrations/devin/seedance-2-0-reference-to-video)
- [Seedance 2.5 US Reference to Video](https://spiral.ai/integrations/devin/seedance-2-5-us-reference-to-video)

## Questions about Seedance 2.5 Reference to Video in Devin

**Can Devin use Seedance 2.5 Reference to Video?**

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

**How much does Seedance 2.5 Reference to Video cost in Devin?**

$0.601 per second at 720p ($0.267 at 480p, $1.48 at 1080p) for 16:9 or 9:16. Other shapes: $1.94 at 1080p. With reference videos: $0.361 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 Devin plan is separate.

**Do I need a fal account to use Seedance 2.5 Reference to Video in Devin?**

No. Spiral runs Seedance 2.5 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.5 Reference to Video in Devin?**

About two minutes: add a custom MCP, then sign in to Spiral and approve, then check it.

**Does Devin wait while Seedance 2.5 Reference to Video runs?**

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

**What is Seedance 2.5 good at?**

Seedance 2.5 suits short scenes with a clear progression: an action, a reaction, and a finish. It can combine connected shots and generated sound within one clip.

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

A single generation can run from 4 to 30 seconds. Plan a longer story as separate scenes.

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

Start with who or what is doing what, then add the setting, camera treatment, and sound you need. For several story beats, describe them in order and give each a visible endpoint.

**Can Seedance 2.5 generate dialogue in English?**

Yes. Specify American English before the spoken line and describe the delivery, especially if a take uses the wrong language.

**Can I time an action to an exact frame?**

Timestamps help allocate time to events, but they do not guarantee frame-accurate edits. Use an editor when a cut or action must land on an exact frame.

