Retrieve a Seedance 2.5 video (native format)

Use the task ID returned by the native create API to retrieve status, video results, and usage. On success, the video URL is in content.video_url; timestamps, seed, duration, aspect ratio, and resolution are returned at the root as available. Native video and last-frame URLs are valid for 24 hours, with up to 100 downloads; save the files promptly. The returned duration is an approximate integer number of seconds and may differ from the exact media duration.

To use the platform response wrapper, raw data, or usage query parameters, see the platform-format retrieve API.

Use draft and draft_task_id in the native data to distinguish Draft previews from final videos. See the Draft video generation guide for the complete workflow.

GET/api/v3/contents/generations/tasks/{task_id}

Retrieve a Seedance 2.5 task through the native Volcengine Ark path and return the native task status, output video information, and usage information directly.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization Header.

In: header

Path Parameters

task_id*string

Task ID returned when a native Seedance 2.5 task is created.

Length1 <= length

Response Body

`application/json`

curl -X GET "https://example.com/api/v3/contents/generations/tasks/task_xxxxx"

{
  "id": "task_xxxxx",
  "model": "MODEL_ID",
  "status": "running",
  "created_at": 1786082400,
  "updated_at": 1786082430
}

Official Volcengine Ark documentation for retrieving video generation tasksReview the upstream protocol definition and the latest field changes for the Seedance video task retrieval API.

Retrieve a Seedance 2.5 video (native format)

Authorization

Path Parameters

Response Body

200application/json

400application/json

401application/json

402

404

429

500

502

`application/json`

`application/json`

`application/json`