Seedance 2.5 Multimodal Reference-to-Video
For the dreamina-seedance-2-5-260628 model. After submitting, query status via GET /v1/videos/{task_id}.
Authorizations
Pass Authorization: Bearer <token> in the request header.
Body
The ID of the model you need to call (Model ID)
dreamina-seedance-2-5-260628 Multimodal input array. Seedance 2.5 supports text, first_frame, last_frame, reference_image, reference_video, and reference_audio. Supports passing audio only.
1Video duration, integer only, in seconds.
- Seedance 2.5 series: [4, 30] s, or set to -1
Note
Seedance 2.5 series supports two configuration methods:
- Specify exact duration: Any integer within the valid range.
- Smart mode: Set to -1 to let the model choose the appropriate video length (in whole seconds) within the valid range. The actual generated video duration can be obtained from the duration field returned by the query video generation task API. Note that video duration is related to billing, so set it carefully.
4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, -1 "5"
Video resolution. Enum values:
- 480p
- 720p
- 1080p
Default: 720p
480p, 720p, 1080p Seedance 2.5 series default:
adaptive
The aspect ratio of the generated video. See the table below for pixel dimensions for different aspect ratios.
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- 21:9
- adaptive: Automatically selects the most suitable aspect ratio based on input (see details below)
adaptive Rules
When ratio is set to adaptive, the model automatically adjusts the aspect ratio based on the generation scenario. The actual video aspect ratio can be obtained from the ratio field returned by the query video generation task API.
Supported models:
- Seedance 2.5 series supported
Rules:
- Text-to-Video: Based on the input prompt, intelligently selects the most suitable aspect ratio.
Pixel dimensions corresponding to different aspect ratios
Note: For Image-to-Video, if the selected aspect ratio does not match the uploaded image ratio, the platform will crop your image from the center.
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Output video format.
- mp4: Universal format with the best compatibility, using standard color precision. Can be played directly on web pages, mobile devices, various players, and distribution platforms.
- mov: Professional high color precision format, better preserving color and brightness consistency. Suitable for professional post-processing such as color grading, compositing, and synthesis. Recommended for video editing and video extension scenarios.
mov format playback compatibility
mov format uses professional encoding (H.264 video encoding + yuv444p chroma subsampling + PCM audio encoding), which may not be compatible with some players. The following are common players that support mov format playback:
Model support: Seedance 2.5
mp4, mov Whether the generated video contains a watermark.
- false: The generated video does not contain a watermark.
- true: The generated video displays an "AI Generated" watermark in the bottom-right corner.
Only supported by Seedance 2.5 series
Controls whether the generated video contains synchronized audio.
- true: The model outputs video with synchronized audio. The model automatically generates matching voice, sound effects, and background music based on the text prompt and visual content. It is recommended to place dialogue in double quotes for better audio generation. For example: The man stops the woman and says, "Remember, never point your finger at the moon."
- false: The model outputs video without audio.
Note: Generated audio videos are all mono, regardless of the input audio channel count.
true: Return the last frame image of the generated video. When set to true, you can obtain the last frame image through the query video generation task API. The last frame image is in PNG format with the same pixel dimensions as the generated video, without watermarks.
Use this parameter to generate multiple consecutive videos: use the last frame of one video as the first frame of the next video task to quickly generate a sequence of consecutive videos.
false: Do not return the last frame image of the generated video.
Unique identifier of end users, used to help the platform detect users in your application who may violate the ModelArk usage policy. This identifier is an English string, which must be fixed and unique for a single user, and the length cannot exceed 64 characters. It is recommended to pass in a string generated by hashing the username, user ID or email address to avoid leaking user privacy information.
Only supported by Seedance 2.5 series
Task Type Guidance
Seedance 2.5 multimodal reference-to-video tasks include 3 sub-task types: reference video generation, video editing, and video extension. Different task types have specific parameter constraints. To reduce asynchronous errors after task creation, you can specify the sub-task type via this parameter to validate constraints in advance.
-
By default, i.e.
omni_reference_task_type=auto: The model automatically determines the task type based on input materials and prompt, then validates parameter values. If parameters are incompatible with the actual task type, the task will trigger an asynchronous error (error code:InvalidParameter.TaskTypeMismatch). -
Explicitly specifying the task type, i.e.
omni_reference_task_typeset toreference,edit, orextend: The API validates the special parameter constraints for the corresponding task at submission time. If requirements are not met, the API returns an error immediately and the task is not created.
Note
When actually processing the task, the model will further determine the task type based on the prompt. If the actual determined task type differs from the specified one, an asynchronous error will still be triggered (error code: InvalidParameter.TaskTypeMismatch). It is recommended to follow the prompt writing guidelines for each task type to reduce the probability of errors.
Valid values:
auto: The model automatically determines the task type based on input materials and prompt.reference: Reference video generation task, i.e. generating a new video based on reference images, reference videos, or reference audio. When set toreference,ratioordurationhave no special restrictions.edit: Video editing task, i.e. editing the video or audio of the original video. When set toedit,contentmust contain at least onereference_video, and the video duration must be 4–30 seconds;ratiomust beadaptive;durationmust be-1.extend: Video extension task, i.e. extending the original video forward or backward. When set toextend,contentmust contain at least onereference_video;ratiomust beadaptive.
Model support:
Seedance 2.5
auto, reference, edit, extend Response
Submission successful, returns video task object.
Video generation task ID. Only stored for 7 days (from the created_at timestamp), then automatically deleted.
- When draft: true, this is the Draft video task ID.
- When draft: false, this is the normal video task ID.
Video generation is asynchronous. After obtaining the ID, use the query video generation task API to check the status. When successful, the API returns the generated video URL.