Seedance 2.0 · Reference to Video
bytedance/seedance-2.0/reference-to-videoGenerate video from text and reference media with Seedance 2.0 · Reference to Video from fal through one Spiral API key. Generates a 4 to 15 second video from a prompt guided by reference images, videos and audio clips, at resolutions up to 4K. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
$0.393 per second at 720p ($0.183 at 480p, $0.885 at 1080p, $2.02 at 4K) for 16:9 or 9:16. Other shapes: $1.16 at 1080p, $2.65 at 4K. With reference videos: $0.242 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, 1080p, 4k | 720p | Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality, 4k for highest quality. |
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/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 · Reference to Video cost?
$0.393 per second at 720p ($0.183 at 480p, $0.885 at 1080p, $2.02 at 4K) for 16:9 or 9:16. Other shapes: $1.16 at 1080p, $2.65 at 4K. With reference videos: $0.242 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 · Reference to Video through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "bytedance/seedance-2.0/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 · 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 · Reference to Video?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.