Skip to main content
POST
Submit Seedance 2.5 Reference to Video Task
Submit the request with VIDGO_API_KEY. After submission, a task_id is returned. Retrieve the result through the unified Query Task Status endpoint or provide callback_url for a completion notification.

Available Models

  • seedance-2.5/reference-to-video - Seedance 2.5 reference to video generation

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 cannot be used alone.

Important notes

  • prompt, duration, and resolution are required.
  • duration accepts integer values from 4 to 30 seconds.
  • resolution accepts 480p, 720p, or 1080p.
  • aspect_ratio accepts auto, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16.
  • Reference input accepts up to 30 images, 10 videos, and 10 audio files, with at most 50 reference files in total. Reference audio requires at least one reference image or video.
  • All media URLs must be publicly accessible and directly downloadable.
  • Usage is billed by duration and resolution. Each reference-video duration, rounded down separately, is added to output duration for billing.
  • Whether reference videos are supplied also affects the applicable billing rate.

Authorizations

Authorization
string
header
required

Use Authorization: Bearer VIDGO_API_KEY.

Body

application/json
model
string
required
Example:

"seedance-2.5/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