Seedance 2.0 Fast · Reference to Video
bytedance/seedance-2.0/fast/reference-to-videoGenerate video from text and reference media with Seedance 2.0 Fast · Reference to Video from fal through one Spiral API key. Makes a 4 to 15 second video from a prompt guided by reference images, videos and audio, using the faster tier at 480p or 720p. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
$0.314 per second at 720p ($0.146 at 480p). With reference videos: $0.189 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 required | text | — | The text prompt used to generate the video. |
image_urls | URLs or files | — | Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 9 images. Total files across all modalities must not exceed 12. |
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 3 videos, combined duration must be between 2 and 15 seconds, total size under 50 MB. Each video must be between ~480p (640x640) and ~720p (834x1112) in resolution. |
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 3 files, combined duration must not exceed 15 seconds. Max 15 MB per file. At least one reference image or video is required. |
resolution | one of 480p, 720p | 720p | Video resolution - 480p for faster generation, 720p for balance. |
duration | one of auto, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 | auto | Duration of the video in seconds. Supports 4 to 15 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. |
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.0/fast/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.0 Fast · Reference to Video cost?
$0.314 per second at 720p ($0.146 at 480p). With reference videos: $0.189 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.0 Fast · Reference to Video through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "bytedance/seedance-2.0/fast/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.0 Fast · Reference to Video?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Seedance 2.0 Fast · Reference to Video?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.