Seedance 1.5 Pro

seedance-1-5-pro

Spark Dance 1.5 Pro video generation, supports three modes: text-to-video, image-to-video (first frame), image-to-video (first and last frame).

API Notes

Image-to-Video (First and Last Frame): Generate target video based on your input: first frame image + last frame image + text prompt (optional) + parameters (optional)

Image-to-Video (First Frame): Generate target video based on your input: first frame image + text prompt (optional) + parameters (optional)

Text-to-Video: Generate target video based on your input: text prompt + parameters (optional)

Endpoints

POST /v1/queue/seedance-1-5-pro # Create task

GET /v1/queue/seedance-1-5-pro/requests/{request_id}/status # Check status

GET /v1/queue/seedance-1-5-pro/requests/{request_id}/response # Get result

PUT /v1/queue/seedance-1-5-pro/requests/{request_id}/cancel # Cancel task

Request parameters

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/seedance-1-5-pro' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "content": [
    {
      "type": "text",
      "text": "A clean studio shot of a red apple on a white table, soft natural light."
    }
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 5,
  "generate_audio": true
}'

content array required

Input information for generating videos, supports text, image and video (draft, Draft video) formats. Supports the following combinations: Text, Text + Image (first frame), Text + Image + Image (first and last frames), Video (draft)

Text Content Object object

type string required

Content type

Value: text

text string required

Text content input to the model, describing the expected video, including:

Text prompt (required): Supports Chinese and English. Recommended not exceeding 500 characters. Too many characters can cause information dispersion, and the model may ignore details and only focus on key points, resulting in missing elements in the video

Image Content Object object

type string required

Content type

Value: image_url

image_url object required

Image URL object

url string required

Image information, can be image URL or Base64 encoded image

Image URL: Ensure the image URL is accessible

Base64 encoding: Follow this format data:image/<image_format>;base64,<base64_encoded>, note that <image_format> must be lowercase, e.g. data:image/png;base64,{base64_image}

Image requirements:

Image formats: jpeg, png, webp, bmp, tiff, gif, heic, heif

Aspect ratio (width/height): (0.4, 2.5)

Width and height (px): (300, 6000)

Size: less than 30 MB

role string conditional required

Image position or purpose

First Frame to Video:

role value: Need to pass 1 image_url object, and role field can be empty, or role is: first_frame

First and Last Frame to Video:

role value: Need to pass 2 image_url objects, and role field is required

First frame image corresponds to role: first_frame

Last frame image corresponds to role: last_frame

Draft Information object

type string required

Input content type, should be draft_task

draft_task object required

Draft task input to the model

id string required

Draft task ID. The platform will automatically reuse the user input used by the Draft video (model, content.text, content.image_url, generate_audio, seed, ratio, duration, camera_fixed) to generate the final video. Other parameters can be specified, and if not specified, the default values of this model will be used

callback_url string

Callback notification address for task results

return_last_frame boolean

Whether to return the last frame image of the generated video

true: Returns the last frame image of the generated video. After setting to true, you can get the video's last frame image through the query video generation task API. The last frame image format is png, with the same width and height pixels as the generated video, without watermark. This parameter can be used to generate multiple consecutive videos by using the end frame of one video as the first frame of the next video task

false: Does not return the last frame image

Default: false

service_tier string

Service tier type for processing this request

default: Online inference mode

flex: Offline inference mode

Default: default

Options: default, flex

execution_expires_after integer

Task timeout threshold. Specifies the expiration time (in seconds) after task submission, calculated from the created_at timestamp

Default: 172800 (48 hours)

Range: [3600, 259200]

generate_audio boolean

Only Seedance 1.5 Pro supports controlling whether the generated video contains synchronized sound

true: Model outputs video with synchronized audio. Seedance 1.5 Pro can automatically generate matching voice, sound effects, and background music based on text prompts and visual content. It is recommended to place dialogue within double quotes to optimize audio generation effects. For example: The man calls out to the woman and says: "Remember, you cannot point your finger at the moon in the future."

false: Model outputs silent video

Default: true

draft boolean

Only Seedance 1.5 Pro supports controlling whether to enable draft mode

true: Enable draft mode, generate a preview video to quickly verify scene structure, camera scheduling, subject actions, and whether the prompt intent meets expectations. Consumes fewer tokens than normal video, with lower usage cost

false: Disable draft mode, generate a normal video

Note: After enabling draft mode, 480p resolution will be used to generate the Draft video (using other resolutions will cause an error), does not support return last frame function, does not support offline inference function

Default: false

resolution string

Video resolution

Default: 720p

Options: 480p, 720p, 1080p

ratio string

Aspect ratio of the generated video

Default: adaptive

Options: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

Note: adaptive automatically selects the most suitable aspect ratio based on the input prompt or uploaded first frame image

duration integer

Video duration in seconds

Seedance 1.5 Pro supports two configuration methods: Specify specific duration (any integer in range), or set to -1 to let the model autonomously choose an appropriate video length (integer seconds) within the range. The actual generated video duration can be obtained through the query video generation task API return duration field. Note: Video duration is related to billing, please set carefully

Default: 5

Range: 4 - 12, or -1 (auto)

seed integer

Seed integer for controlling randomness of generated content

Default: -1

Range: [-1, 2^32-1]

camera_fixed boolean

Whether to fix the camera

Default: false

Options: true, false

watermark boolean

Whether the generated video contains watermark

Default: false

Options: true, false

Response parameters

{
  "request_id": "task_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/seedance-1-5-pro/requests/task_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/seedance-1-5-pro/requests/task_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/seedance-1-5-pro/requests/task_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
`request_id`	string	Task ID used for all follow-up operations.
`response_url`	string	URL to fetch the final result.
`status_url`	string	URL to query task status.
`cancel_url`	string	URL to cancel the task.
`queue_position`	int	Current queue position.

Follow-up operations

Check status

Get result

Cancel task

Error handling