falImage to videoAvailable now
falbytedance/seedance-2.0/fast/reference-to-video
bytedance/seedance-2.0/fast/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.00001456 per token, with one API key.
Try itfrom $0.00001456 / token
Pricing
resolution: 480p about $0.146241, 720p about $0.314496 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
| 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."
}
}'