Retrieve a Seedance 2.5 video (platform format)

Use the task ID to retrieve its status and result. By default, the response uses a platform-compatible wrapper containing code, message, and data. Set raw=true to return the native Volcengine Ark task structure directly, show_raw=true to include the same native structure in data.data, or show_usage=true to include platform-normalized usage data in data.usage. Video URLs may expire, so save the files promptly.

To retrieve the Volcengine Ark task structure directly, see the native-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/v1/video/generations/{task_id}

Use the task ID returned by the create API to retrieve a Seedance 2.5 video task. By default, the response is a platform-compatible wrapper containing code, message, and data. Stop polling after the task enters succeeded, completed, or failed.

Set raw=true to read the native Volcengine Ark task structure directly. Set show_raw=true to include the same native structure in data.data of the compatible wrapper. Set show_usage=true to include platform-normalized usage information in data.usage for a successful task.

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 Seedance 2.5 task is created.

Length1 <= length

Query Parameters

raw?boolean

When true, returns the saved raw upstream task data directly.

show_raw?boolean

When true, includes raw upstream task data in the compatible wrapper response.

show_usage?boolean

When true and the task succeeds, includes usage information in the compatible wrapper response.

Response Body

`application/json`

curl -X GET "https://example.com/v1/video/generations/task_xxxxx"

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_xxxxx",
    "status": "succeeded",
    "url": "https://example.com/generated-video.mov",
    "format": "mov",
    "metadata": null,
    "error": null
  }
}

Seedance 2.5 native task structure referenceReview the Volcengine Ark task retrieval structure used by raw and show_raw.

Retrieve a Seedance 2.5 video (platform format)

Authorization

Path Parameters

Query Parameters

Response Body

200application/json

400application/json

401application/json

402application/json

404

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`