Seedance 2.5 查询视频（平台格式）

使用任务 ID 查询状态和结果。默认响应使用 code、message 和 data 组成的平台兼容包装；raw=true 直接返回火山方舟原生任务结构，show_raw=true 在 data.data 中附带同一原生结构，show_usage=true 在 data.usage 中附带平台整理的用量信息。视频 URL 可能存在有效期，请及时转存。

如需直接获取火山方舟任务结构，请参阅原生格式查询接口。

查询 Draft 样片与正式视频时，可通过原生数据中的 draft、draft_task_id 区分任务。完整流程请参阅 Draft 样片生成指南。

GET/v1/video/generations/{task_id}

使用创建接口返回的任务 ID 查询 Seedance 2.5 视频任务。默认返回 code、message 和 data 组成的平台兼容包装；任务进入 succeeded、completed 或 failed 后应停止轮询。

传入 raw=true 可以直接读取火山方舟原生任务结构；show_raw=true 会在兼容包装的 data.data 中附带同一原生结构；show_usage=true 会在成功任务的 data.usage 中附带平台整理的用量信息。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Path Parameters

task_id*string

创建 Seedance 2.5 任务时返回的任务 ID。

Length1 <= length

Query Parameters

raw?boolean

传 true 时直接返回保存的上游原始任务数据。

show_raw?boolean

传 true 时在兼容包装响应中附带上游原始任务数据。

show_usage?boolean

传 true 且任务成功时，在兼容包装响应中附带用量信息。

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 原生任务结构参考查看 raw 与 show_raw 所使用的火山方舟任务查询结构。

Seedance 2.5 查询视频（平台格式）

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`