Seedance 2 Reference to Video (Image to Video) API on fal
Reference to Video
ByteDance's most advanced reference-to-video model. Generate video from up to 9 images, 3 videos, and 3 audio clips with native audio and cinematic camera control.
Input
Form
Prompt*
Style: Hybrid visual style — photorealistic, documentary-level environment combined with stylized 3D animated characters. The subject and the fan are fully 3D animated characters seamlessly composited into a live-action realistic world. Single continuous unbroken shot from a handheld camera within a dense crowd. Natural micro-shake, eye-level perspective.
Character Style: The subject from @Image1 is rendered as a polished 3D animated character with stylized proportions, soft subsurface skin shading, expressive features, and clean rim lighting — while maintaining a perfectly consistent face and the exact outfit from the reference image. The fan they interact with is also a 3D animated character in the same rendering style. Both characters retain cinematic CG quality with realistic interaction with the surrounding light (flash bounces, streetlight highlights, shadow casting on real ground).
Lighting & Environment: Fully photorealistic. Nighttime at an upscale event in New York City. Illuminated by real streetlights and camera flashes. Mixed reflections on polished surfaces (phones, cars), soft realistic shadows, and a slight atmospheric haze for depth. The crowd, barricades, hotel facade, SUVs, and street are all live-action realistic — only the two main characters are stylized 3D.
Subject: The 3D animated subject maintains a calm, controlled presence with a subtle, confident smile, perfectly matching the face and outfit from @Image1.
Action Sequence: The shot begins completely immersed in a restless, chaotic realistic crowd behind barricades. The view is partially obscured by real people raising smartphones to record. As the camera lifts slightly above shoulder level, the 3D animated subject exits a luxury hotel in the background. Bright media flashes erupt, illuminating the CG character against the realistic environment. Real security personnel step into frame, pushing the crowd back, causing the camera to shake naturally. Through shifting gaps in the crowd, the animated subject walks forward clearly into center frame. The subject pauses to interact with a 3D animated fan, leaning in briefly for a selfie while giving a calm, controlled wave. The camera pans to follow as a luxury convoy of three premium black SUVs (photorealistic) pulls up. A real security guard opens the back door of the middle SUV. The animated subject steps inside, rolls down the window to wave one last time, and the vehicles begin to pull away as the realistic crowd jumps to capture the moment.
Audio: Loud, chaotic crowd cheering and whistling. Overlapping voices shouting the subject's name. A barrage of rapid camera shutter clicks. Distant New York City sirens and traffic. The rustling of heavy fabric and footsteps. The deep, heavy bass of an SUV engine idling and pulling away.
Image Urls
Add Image
Add URL
Image 1
Video Urls
Add Video
Add URL
Audio Urls
Add Audio
Add URL
Resolution 720p
Duration auto
Generate Audio
End User Id
Additional Settings
Result
{
"seed": 1007268844,
"video": {
"url": "https://v3b.fal.media/files/b/0a9971d4/VMcsqDpXJqPIkvX2gVN4__video.mp4",
"file_name": "video.mp4",
"file_size": 7052934,
"content_type": "video/mp4"
}
}
For every second of 720p video you generated, you will be charged $0.3034/second and for 1080p you will be charged $0.682/second. Your request will cost $0.014 per 1000 tokens for 480p, 720p and 1080p. Your request will cost $0.008 per 1000 tokens for 4k. The number of tokens is given by (height of output video * width of output video * (input video duration + output video duration) * 24) / 1024. If video inputs are provided the price is multiplied by 0.6. With video inputs and 720p resolution the price is $0.1814 per second.
Outputs
Outputs JSON:
{
"video": {
"url": "https://...",
"content_type": "video/mp4",
"file_name": "output.mp4",
"file_size": 4823041
},
"seed": 42
}
Parameters
| Parameter | Type | Default | Options |
|---|---|---|---|
prompt |
string | — | Text description; reference assets as @Image1, @Video1, @Audio1, etc. |
image_urls |
list |
— | Reference image URLs |
video_urls |
list |
— | Reference video URLs |
audio_urls |
list |
— | Reference audio URLs |
resolution |
enum | 720p |
480p, 720p, 1080p |
duration |
enum | auto |
auto or any integer from 4 to 15 seconds |
aspect_ratio |
enum | auto |
auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
generate_audio |
boolean | true |
Synchronized audio: SFX, ambient sound, lip-synced speech. Same price either way. |
seed |
integer | — | Fix for reproducibility (minor variation may still occur) |
end_user_id |
string | — | Optional identifier for the end user |