# Seedance 2.5 US Reference to Video

Generate video from text and reference media with Seedance 2.5 US Reference to Video from fal through one Spiral API key. 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-31
- Tool id: `fal` / `bytedance/seedance-2.5/us/reference-to-video`
- Page: https://spiral.ai/tools/fal/bytedance/seedance-2.5/us/reference-to-video

## Pricing

Up to $18.44466 per run at the default inputs. `resolution`: 480p $8.59638, 720p (default) $18.44466, 1080p $45.392724.

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

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

## Common questions

### Seedance 2.5 US Reference to Video

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

Up to $18.44466 per run at the default inputs. `resolution`: 480p $8.59638, 720p (default) $18.44466, 1080p $45.392724. 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 US Reference to Video through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "bytedance/seedance-2.5/us/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 US 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 US Reference to Video?**

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

