Skip to main content
POST
Submit Seedance 2.5 Flash Reference to Video Task
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

Models

  • seedance-2.5-flash/reference-to-video - Seedance 2.5 Flash Reference to Video

Input modes

  • This model uses reference images, videos, and optional audio for multimodal guidance.
  • Provide at least one reference image or reference video. Reference audio is used together with them. Refer to reference media in the prompt in upload order as @Image1, @Video1, and @Audio1.

Notes

  • prompt and duration are required; resolution is optional and defaults to 720p.
  • duration accepts integer values from 4 to 30 seconds.
  • resolution accepts 480p or 720p.
  • aspect_ratio accepts auto, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16.
  • Reference inputs accept up to 10 images, 5 videos (MP4 or MOV), and 5 audio files (MP3 or WAV). Each video or audio clip runs 2–30 seconds, and reference videos and reference audios are each limited to 30 seconds in total.
  • All media URLs must be publicly accessible and directly downloadable.
  • Billing uses duration and resolution: the standard rate is 18.5 credits/s at 480p and 41 credits/s at 720p; with reference video, 11.5 credits/s at 480p and 25.5 credits/s at 720p, and each reference video’s floored duration is added to the billed seconds.

Authorizations

Authorization
string
header
required

Use Authorization: Bearer VIDGO_API_KEY.

Body

application/json
model
string
required
Example:

"seedance-2.5-flash/reference-to-video"

input
object
required

Provide at least one of reference_image_urls, reference_video_urls.

callback_url
string<uri>

Optional webhook callback URL.

Response

Task submitted successfully

code
integer
required
Example:

200

data
object
required