Spiral gives your agent every tool with one account. Browse the tools →

falVideoAvailable nowReleased 2026-04-01

Seedance 2.0 Fast · Reference to Video

bytedance/seedance-2.0/fast/reference-to-video

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

Run time p50 · last 24 hours
6m 5s
Success rate · last 24 hours
18.8%

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

FieldKindDefaultDescription
prompt requiredtext—

The text prompt used to generate the video.

image_urlsURLs 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_urlsURLs 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_urlsURLs 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.

resolutionone of
480p, 720p
720p

Video resolution - 480p for faster generation, 720p for balance.

durationone 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_ratioone 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_audiotrue or falsetrue

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_modeone of
standard, high
standard

Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate.

codecone of
auto, H264, H265
auto

'auto' retains default video codec behaviour; 'H264' uses H.264; 'H265' uses H.265.

end_user_idtext—

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.