Seedance 2.5 查詢影片（平台格式）

使用任務 ID 查詢狀態和結果。預設回應使用由 code、message 和 data 組成的 Platform 相容包裝；raw=true 直接回傳火山方舟原生任務結構，show_raw=true 在 data.data 中附帶相同的原生結構，show_usage=true 在 data.usage 中附帶平台整理的用量資訊。影片 URL 可能有有效期限，請及時轉存。

如需直接取得火山方舟任務結構，請參閱原生格式查詢 API。

查詢 Draft 樣片與正式影片時，可透過原生資料中的 draft、draft_task_id 區分任務。完整流程請參閱 Draft 樣片生成指南。

GET/v1/video/generations/{task_id}

使用建立 API 回傳的任務 ID 查詢 Seedance 2.5 影片任務。預設回傳 code、message 和 data 組成的平台相容包裝；任務進入 succeeded、completed 或 failed 後應停止輪詢。

傳入 raw=true 可以直接讀取火山方舟原生任務結構；show_raw=true 會在相容包裝的 data.data 中附帶同一原生結構；show_usage=true 會在成功任務的 data.usage 中附帶平台整理的用量資訊。

授權

bearerAuth

授權Bearer <token>

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

傳遞位置: header

路徑參數

task_id*string

建立 Seedance 2.5 任務時回傳的任務 ID。

長度1 <= length

查詢參數

raw?boolean

傳 true 時直接回傳儲存的上游原始任務資料。

show_raw?boolean

傳 true 時在相容包裝回應中附帶上游原始任務資料。

show_usage?boolean

傳 true 且任務成功時，在相容包裝回應中附帶用量資訊。

回應主體

`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 查詢影片（平台格式）

授權

路徑參數

查詢參數

回應主體

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`