Sign inGet started
falImage to videoAvailable now

bytedance/seedance-2.5/reference-to-video

bytedance/seedance-2.5/reference-to-video is an image to video tool from fal that runs in the background and returns video. Pay as you go from $0.00002782 per token, with one API key.

Try itfrom $0.00002782 / token

Pricing

resolution: 480p about $0.267294, 720p about $0.600912, 1080p about $1.479145 per second, at aspect_ratio 16:9. Billed on duration, default 5. With reference videos, a lower rate applies and their input seconds count too, with a minimum. The final charge comes from usage.

Limits

Runs
In the background
Returns
video
Longest queue wait
3600s
Run deadline
3600s
Largest inline input
1024 KB
Largest input file
500 MB
Largest output
4768 MB
Outputs per run
16

Input

FieldKindDefaultDescription
prompttext—The text prompt used to generate the video.
taskone of
auto, reference, editing, extension
referenceThe 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_urlsURLs 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_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 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_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 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.
resolutionone of
480p, 720p, 1080p
720pVideo resolution - 480p for faster generation, 720p for balance, 1080p for high quality.
drafttrue or falsefalseGenerate a draft preview at 480p, overriding resolution. Returns a draft_id for completing the draft at 1080p within seven days.
durationone 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
autoDuration of the video in seconds. Supports 4 to 30 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
autoThe 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 falsetrueWhether 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
standardOutput 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.
seednumber (whole)—Random seed for reproducibility. Note that results may still vary slightly even with the same seed.
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.5/reference-to-video",
    "input": {}
  }'