Seedance 2.5

POSThttps://api.newportai.com/api/async/seedance_2.5

The Seedance 2.5 Reference To Video API generates videos from reference images, videos and audio, preserving the motion, style and audio characteristics of the reference materials, supporting configurable aspect ratio and durations up to 30 seconds.

This API offers enhanced features including reference video support, audio integration, and customizable duration, making it suitable for complex video production workflows.

Submit a POST request to the Seedance 2.5 API to obtain a taskId.
Submit a POST request to the Polling API to retrieve the generated video results.
Configure a Callback URL to receive results automatically on completion.

Request Headers

Content-Type string Required

Enum: application/json

Authorization string Required

Bearer authentication token. Example: Bearer {{APIKey}}.

Request Body

model string Required

Model version. Available options: seedance-2.5.

prompt string Required

Text prompt describing the video content to generate.

images array

List of reference image URLs. Maximum 9 images. Supported formats: JPEG, PNG, WebP.

videos array

List of reference video URLs. Maximum 3 videos, total duration cannot exceed 15 seconds.

audios array

List of audio URLs. Maximum 3 audio files. Only effective when videos are provided.

resolution string Required

Video resolution. Available options: 480p, 720p.

ratio string

Aspect ratio. Default: adaptive (automatically adjusts based on content). Available options: adaptive, 16:9, 9:16, 1:1, 3:4, 4:3.

duration integer Required

Video duration in seconds. Range: [4-30] seconds.

seed integer

Random seed for reproducible results. Default: -1 (random seed).

generateAudio boolean

Whether to generate audio for the video. Default: false.

Response

code integer

Returns 0 for success, or a specific error code.

message string

Returns "success" or a descriptive error message.

data object

taskId string

The unique identifier for the task. Use this ID with the Polling API to retrieve the generated output.

Errors

10192Illegal param

Polling

Use the Polling API to retrieve the processing results.

Callback

Alternatively, you can enable Callback to receive task results automatically upon completion.

0Task Completed

1234567891011121314151617181920{
    "code": 0,
    "message": "success",
    "data": {
        "task": {
            "taskId": "API-f000979c6b6e4562b2945be0ea50f0bd",
            "status": 3,
            "executionTime": 84467,
            "expire": 1786096513313,
            "taskType": "seedance_2.5",
            "creditsConsumed": 640
        },
        "videos": [
            {
                "videoType": "mp4",
                "videoUrl": "https://dreamapi-rs-aigc.newportai.com/dreamapi/o/2026-08-07/4bc7af00701b47cc958085b8e33af478.mp4"
            }
        ]
    }
}

Request

cURL

12345678910111213141516171819curl -X POST 'https://api.newportai.com/api/async/seedance_2.5' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {{key}}' \
  -d '{
  "model": "seedance-2.5",
  "prompt": "A girl dancing in a park on a sunny day with trees and benches in the background",
  "images": [
    "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/INj5UrnnrKIzCR1uYBWv0.png",
    "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/VE-i9SzS3ZRdVTSzJWTcA.jpeg"
  ],
  "videos": [
    "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/mq0MSmKgPGQQsxS9UovqH.mp4"
  ],
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 8,
  "seed": -1,
  "generateAudio": false
}'

0Successful

1234567{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "API-f000979c6b6e4562b2945be0ea50f0bd"
    }
}