# Seedance 2.5 · Reference to Video

Generate video from text and reference media with Seedance 2.5 · Reference to Video from fal through one Spiral API key. Creates, edits or extends a video of up to 30 seconds from a prompt and reference images, videos and audio clips, at up to 1080p. It runs in the background and returns video. Pay as you go, with no subscription.

- Provider: fal
- Category: Video
- Runs: In the background
- Returns: video
- Released: 2026-07-20
- Tool id: `fal` / `bytedance/seedance-2.5/reference-to-video`
- Page: https://spiral.ai/tools/fal/bytedance/seedance-2.5/reference-to-video

## Pricing

$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.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 1 hour
- Longest run, end to end: 930 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` | text |  | — | The text prompt used to generate the video. |
| `task` | one of | 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` | URLs or files |  | — | 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` | URLs or files |  | — | 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` | URLs or files |  | — | 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` | one of | 480p, 720p, 1080p | 720p | Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality. |
| `draft` | true or false |  | false | Generate a draft preview at 480p, overriding resolution. Returns a draft_id for completing the draft at 1080p within seven days. |
| `duration` | one of | auto, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 | auto | Duration of the video in seconds. Supports 4 to 30 seconds, or auto to let the model decide based on the prompt. |
| `aspect_ratio` | one of | 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. |
| `generate_audio` | true or false |  | true | Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not. |
| `bitrate_mode` | one of | standard, high | standard | Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate. |
| `codec` | one of | auto, H264, H265 | auto | 'auto' retains default video codec behaviour; 'H264' uses H.264; 'H265' uses H.265. |
| `seed` | number (whole) |  | — | Random seed for reproducibility. Note that results may still vary slightly even with the same seed. |
| `end_user_id` | text |  | — | The unique user ID of the end user. |

## Example

```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."
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=bytedance%2Fseedance-2.5%2Freference-to-video

## Common questions

### Seedance 2.5 · Reference to Video

**How much does Seedance 2.5 · Reference to Video cost?**

$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 as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Seedance 2.5 · Reference to Video through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "bytedance/seedance-2.5/reference-to-video"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Seedance 2.5 · Reference to Video?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Seedance 2.5 · Reference to Video?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

