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

使用任务 ID 查询状态和结果。默认返回平台任务对象；raw=true 直接返回火山方舟原生任务结构，show_raw=true 在平台包装中附带同一原生结构，show_usage=true 返回平台整理后的用量信息。视频和尾帧地址可能存在有效期，请及时下载或转存。

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

原生任务数据支持标准 Seedance 2.0 的 4k 分辨率及任务 priority；Fast 仅支持 480p/720p。

GET/v1/video/generations/{task_id}

使用创建接口返回的任务 ID 查询 Seedance 2.0 视频任务。任务进入 completed 或 failed 后应停止轮询。

建议每隔 30 到 60 秒查询一次。完成后的视频 URL 可能存在有效期，请及时下载并转存。

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Path Parameters

task_id*string

创建视频任务时返回的任务 ID。

Length1 <= length

Query Parameters

raw?boolean

传 true 时直接返回上游原始任务数据，便于排查问题。

show_raw?boolean

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

show_usage?boolean

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

Response Body

`application/json`

curl -X GET "https://example.com/v1/video/generations/cgt-20260330164007-wnc8k"

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "MODEL_ID",
  "status": "completed",
  "progress": 100,
  "created_at": 1774860007,
  "completed_at": 1774860088,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

Seedance 2.0 原生任务结构参考查看 raw 与 show_raw 所使用的火山方舟任务查询结构。

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

Authorization

Path Parameters

Query Parameters

Response Body

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`