[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [Seedance 2.5 US Reference to Video](https://spiral.ai/integrations/muse-code/seedance-2-5-us-reference-to-video)

# How to Use Seedance 2.5 US Reference to Video in Muse Code

Seedance 2.5 Reference to Video uses images, video, and audio to guide a new clip, edit footage, or continue a scene. Unlike Seedance 2.5 Image to Video, it can draw on several assets for appearance, movement, and sound.

|  |  |
| --- | --- |
| Model | Seedance 2.5 US Reference to Video |
| Available through | fal |
| Category | Video |
| Price | Up to $18.44466 per run at the default inputs. `resolution`: 480p $8.59638, 720p (default) $18.44466, 1080p $45.392724. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Seedance 2.5 US Reference to Video in Muse Code

- Use Seedance 2.5 Reference to Video with the project's approved character and setting images to create a 12-second scene. The character enters the workshop, finds a broken stool, and begins repairing it; assign each reference its role.
- Estimate, then generate a 5-second 9:16 clip with Seedance 2.5 US 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 US 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 US 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 US Reference to Video.

## How to set up Seedance 2.5 US Reference to Video in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## Seedance 2.5 US Reference to Video tools and prices

- [Seedance 2.5 US Reference to Video](https://spiral.ai/tools/fal/bytedance/seedance-2.5/us/reference-to-video) (fal): Up to $18.44466 per run at the default inputs. `resolution`: 480p $8.59638, 720p (default) $18.44466, 1080p $45.392724.

## 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 US Reference to Video in Muse Code?

Create short video assets alongside the project that will use them. Your coding agent can turn a creative brief into scene directions covering action, camera movement, and sound.

### Short narrative ads

Build a 20-second scene around a problem, a useful action, and a clear result. Develop the scene from writing, an opening still, or supplied references with the corresponding Seedance 2.5 model.

### Atmospheric footage

Create short location shots for an introduction or transition, with deliberate camera movement and matching ambience. Describe a setting or supply visual material to establish its appearance.

### Dialogue scene drafts

Test a brief exchange with spoken lines, pauses, gestures, and camera direction. Review the delivery and synchronization before using the clip.

### Camera treatment comparisons

Explore how a scene feels with a slow push, a tracking shot, or a locked camera. Keep the action and sound description consistent while changing the camera direction.

### Product stills with motion

Turn a supplied product image into a short presentation with a camera move, environmental motion, and sound. Check labels and fine details against the original image.

### Illustrated scene animation

Give an existing illustration a small sequence of actions, such as a character opening a door while the camera follows. Use the supplied art to establish the scene's appearance.

### Targeted footage edits

Ask Seedance 2.5 Reference to Video to change a specified visual element in supplied footage. Describe both the change and the details that should stay consistent.

### Scene continuations

Continue a supplied clip with the next action in the story. Specify how the subject, environment, camera, and sound should carry into the new footage.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## Seedance 2.5 US Reference to Video in other agents

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

## More Muse Code guides

- [Seedance 2.5 US Image to Video](https://spiral.ai/integrations/muse-code/seedance-2-5-us-image-to-video)
- [Seedance 2.5 US Text to Video](https://spiral.ai/integrations/muse-code/seedance-2-5-us-text-to-video)
- [Seedance 2.5 Text to Video](https://spiral.ai/integrations/muse-code/seedance-2-5-text-to-video)
- [Sonilo v1.1 Video to Video Music](https://spiral.ai/integrations/muse-code/sonilo-v1-1-video-to-video-music)
- [Seedance 2.5 Reference to Video](https://spiral.ai/integrations/muse-code/seedance-2-5-reference-to-video)
- [Sonilo v1.1 Video to Video Sound Effects](https://spiral.ai/integrations/muse-code/sonilo-v1-1-video-to-video-sound-effects)

## Questions about Seedance 2.5 US Reference to Video in Muse Code

**Can Muse Code use Seedance 2.5 US Reference to Video?**

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

**How much does Seedance 2.5 US Reference to Video cost in Muse Code?**

Up to $18.44466 per run at the default inputs. `resolution`: 480p $8.59638, 720p (default) $18.44466, 1080p $45.392724. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Muse Code plan is separate.

**Do I need a fal account to use Seedance 2.5 US Reference to Video in Muse Code?**

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

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while Seedance 2.5 US Reference to Video runs?**

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

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

A single generation can last 4 to 30 seconds. That gives a short story room for a setup, an action, and a resolution.

**Does Seedance 2.5 generate sound with the video?**

Yes. It can generate sound effects, ambience, and spoken dialogue alongside the picture. Describe the sounds you want as part of the scene.

**Which languages does Seedance 2.5 support?**

BytePlus documents prompt input and generated speech in Chinese, English, Spanish, Indonesian, Malay, Thai, Arabic, Portuguese, Vietnamese, Japanese, and Korean. State the spoken language explicitly when writing dialogue.

**What resolution can Seedance 2.5 produce?**

The models listed here support 480p, 720p, and 1080p. Specify the intended resolution when requesting a clip.

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

Describe the subject, what happens, the setting, the visual style, the camera movement, and the sound. For a short narrative, give the action a clear beginning and ending.

