Seedance 2.5 Flash Reference to Video API

seedance-2.5-flash/reference-to-video

Seedance 2.5 Flash Reference to Video turns up to 10 images, 5 videos, and 5 audio clips into 4–30 second videos with synchronized audio at 480p or 720p. Give each reference a role, such as identity, motion, or sound, to carry characters into new scenes.

Input

1028/20000
Total references3/20 · remaining 17

Drag and drop files, paste from clipboard, or provide a URL. JPEG, PNG, or WebP, up to 30 MB

1/10 files added

Drag and drop files, paste from clipboard, or provide a URL. MP4 or MOV, 2–30 seconds, up to 50 MB

1/5 files added

Drag and drop files, paste from clipboard, or provide a URL. MP3 or WAV, 2–30 seconds, up to 15 MB

1/5 files added

Output

Ready
(5 sec + 4 reference-video seconds) × $0.1275/sec = $1.15 (9 billing seconds; each video is floored separately)

Continue with

Seedance 2.5 Flash Reference to Video

Seedance 2.5 Flash is the lighter, lower-cost tier of ByteDance Seed's Seedance 2.5 video model and keeps its multimodal reference workflow. Reference to Video combines up to 10 images, 5 videos, and 5 audio clips in one request, letting each asset guide identity, motion, camera behavior, or sound. It outputs 4 to 30 second clips at 480p or 720p for character continuity, motion transfer, and rhythm-driven edits.

Why choose the Seedance 2.5 Flash Reference to Video API?

  • Three kinds of reference in one requestCombine up to 10 images, 5 videos, and 5 audio clips so appearance, movement, and sound each have their own source.

  • Motion and camera from videoUse a reference video to carry a performance, gesture timing, or camera move into a scene with a different subject.

  • Sound and rhythm from audioAdd reference audio alongside images or videos to guide music, ambience, or the timing of actions.

  • Lower rates for reference work720p runs at 41 credits per second, and requests with reference video use 25.5 credits per billing second.

  • Same request as Seedance 2.5The input fields match Seedance 2.5 Reference to Video, so you can move a shot to 1080p or more references by changing the model ID.

Parameters

ParameterRequirementDescription
promptRequired

String. Describes the new scene; refer to reference media in upload order as @Image1, @Video1, and @Audio1.

Default—
reference_image_urlsOptional

Up to 10 public image URLs for characters, objects, appearance, or style. Provide reference images, reference videos, or both.

Default—
reference_video_urlsOptional

Up to 5 public MP4 or MOV URLs for motion, camera behavior, or pacing; each clip runs 2–30 seconds, up to 30 seconds in total.

Default—
reference_audio_urlsOptional

Up to 5 public MP3 or WAV URLs for sound or rhythm; each clip runs 2–30 seconds, up to 30 seconds in total, used together with reference images or videos.

Default—
durationRequired

Integer from 4 through 30 seconds, inclusive; the Playground preselects 5.

Default—
resolutionOptional

Output resolution; the Playground always sends it explicitly.

Default720p480p
aspect_ratioOptional

Output framing; the Playground preselects auto.

Default—auto16:99:161:121:94:33:4
generate_audioOptional

Boolean. true generates synchronized audio and false returns a silent video at the same rate; the Playground sends true by default.

Default—truefalse

How to Use

  1. Collect referencesAdd images for look, videos for motion or camera, and audio for sound; include at least one image or video.

  2. Assign roles in the promptRefer to each asset in upload order, such as @Image1 for the face and outfit and @Video1 for the walk.

  3. Describe the new sceneWrite the setting, action, and camera for the output, separate from what each reference contributes.

  4. Check reference lengthsUse clips of 2–30 seconds, and keep reference videos and reference audios each within 30 seconds in total.

  5. Set the outputChoose duration, resolution, aspect ratio, and audio, then confirm the price on the Run button.

  6. Run and refineCompare the result with your references and adjust roles or wording where the transfer needs more precision.

Pricing

Price is set by resolution, output duration, and reference videos; reference images, reference audio, and generated audio are included at the same rate.

UsageRateDetails
480p standard rate18.5 credits/output sec ($0.0925/sec)4 seconds costs 74 credits ($0.370), 10 seconds costs 185 credits ($0.925), and 20 seconds costs 370 credits ($1.85).
720p standard rate41 credits/output sec ($0.205/sec)4 seconds costs 164 credits ($0.820), 10 seconds costs 410 credits ($2.05), and 30 seconds costs 1,230 credits ($6.15).
480p reference-video rate11.5 credits/billing sec ($0.0575/sec)Billing seconds = output seconds + each reference video's whole seconds. A 10-second output with a 10-second reference video bills 20 seconds: 230 credits ($1.15).
720p reference-video rate25.5 credits/billing sec ($0.1275/sec)The same 10-second output with a 10-second reference video bills 20 seconds: 510 credits ($2.55).

Best Use Cases

  • Character continuityKeep a character's face and outfit from reference images while placing them in new scenes.

  • Motion transferApply a dance, gesture, or camera move from a reference video to a different subject.

  • Music-driven clipsUse reference audio to set rhythm and atmosphere for short promotional or social videos.

  • Brand and product scenesCombine product images with a motion reference to show the product in use.

Pro Tips

  • Give every reference one clear job in the prompt, such as identity, motion, camera, or sound.
  • Name the exact part of a reference video to carry over, such as the motion, and describe the new background and subject in the prompt.
  • Trim reference videos to the moment you need; each video's whole seconds are added to billing.
  • Pair reference audio with at least one reference image or video.
  • Use clean, well-lit reference images with the subject clearly visible.

Notes

  • Send reference images, reference videos, or both; reference audio is used together with them.
  • Reference videos and audios accept MP4 or MOV and MP3 or WAV clips of 2–30 seconds each, with up to 30 seconds in total for each type.
  • Tasks run asynchronously: a successful submission returns a task_id for polling or callback delivery.

Related Models

Seedance 2.5 Flash Reference to Video API frequently asked questions

What is the Seedance 2.5 Flash Reference to Video API?

Seedance 2.5 Flash Reference to Video is a ByteDance Seed model for generating video from reference images, videos, and audio. It combines up to 10 images, 5 videos, and 5 audio clips into 4–30 second clips at 480p or 720p with optional synchronized audio. Built on the Seedance 2.5 multimodal reference workflow, it carries identity, motion, camera behavior, and sound from the references you assign into a new scene. You can call it programmatically or try it from the playground above.

How many references does Seedance 2.5 Flash Reference to Video accept?

Each request accepts up to 10 reference images, 5 reference videos, and 5 reference audio clips. Include at least one image or video; reference audio is used together with them. For more references, Seedance 2.5 Reference to Video accepts up to 50 files.

How are reference videos billed in Seedance 2.5 Flash Reference to Video?

When a request includes reference videos, billing seconds equal the output duration plus each reference video's whole seconds, at 11.5 credits per second for 480p or 25.5 for 720p. A 10-second 720p output with a 10-second reference video bills 20 seconds: 510 credits ($2.55). Requests guided by images or audio use the standard 18.5 and 41 credits per output second.

How long can reference videos be in Seedance 2.5 Flash Reference to Video?

Each reference video or audio clip runs 2–30 seconds, and reference videos can add up to 30 seconds in total, as can reference audios. Trim each clip to the motion or sound you need; shorter reference videos also lower the billed seconds.

Can Seedance 2.5 Flash Reference to Video use audio as a reference?

Yes. Add up to 5 reference audio clips together with at least one reference image or video. Describe in the prompt what the audio should guide, such as the music, ambience, or the timing of an action.

How do I assign roles to references in Seedance 2.5 Flash Reference to Video?

Refer to each asset in upload order with @Image1, @Video1, and @Audio1, numbered separately for each type. State what each one contributes, for example take the walking motion from Reference Video 1 and describe the new background in the prompt.

When should I choose Seedance 2.5 Reference to Video over the Flash version?

Choose Seedance 2.5 Reference to Video when a shot needs 1080p output or more than 10 images, 5 videos, or 5 audio clips; it accepts up to 30, 10, and 10. Flash uses the same fields at lower rates for 480p and 720p work.

Which aspect ratios does Seedance 2.5 Flash Reference to Video support?

Choose auto or one of six fixed ratios: 21:9, 16:9, 4:3, 1:1, 3:4, and 9:16. Set a fixed ratio when the output format differs from your references, such as a 9:16 social cut built from landscape footage.