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 or 720p.
  • 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.

Authorizations

Authorization
string
header
required

Use Authorization: Bearer VIDGO_API_KEY.

Body

application/json
model
enum<string>
required

Vidgo public model identifier.

Available options:
seedance-2.5/reference-to-video
Example:

"seedance-2.5/reference-to-video"

input
object
required
callback_url
string<uri>

Optional webhook callback URL.

Response

Task submitted successfully

code
integer
required
Example:

200

data
object
required