Seedance 2.5 · Reference to Video
bytedance/seedance-2.5/reference-to-videoGenerate 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.
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
- Runs
- In the background
- Returns
- video
- 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 | 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. |
Same request in code
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."
}
}'Frequently asked questions
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.