v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Retrieve a Seedance video task

Read the latest state of a video task that was created through POST /v1/videos. Works for every Seedance model family. Poll every 10 to 20 seconds until status reaches a terminal value (completed, failed, or error). video_url is returned on completed responses.

get/v1/videos/{id}

Path parameters

idstring required

Task id returned by POST /v1/videos.

Response

Current Seedance video task state.

idstring required

Task id.

objectstring required

Object type, always video.

modelstring required

Model id that generated the task.

status'queued' | 'in_progress' | 'completed' | 'failed' | 'error' required

Task status. queued and in_progress are non-terminal. completed, failed, and error are terminal.

progressinteger required

Completion percentage.

video_urlstring nullable

Signed download URL for the finished video. Present on completed responses. Seedance downloads use this URL directly instead of a separate /v1/videos/{id}/content route. The signature is time-limited, so download or re-upload the file to your own storage soon after you receive it.

created_atinteger required

Task creation time as a Unix timestamp in seconds.

completed_atinteger nullable

Optional Unix timestamp returned by the platform. Use status, not this field, to decide when polling can stop.