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

使用任務 ID 查詢狀態和結果。預設回傳平台任務物件；raw=true 直接回傳火山方舟原生任務結構，show_raw=true 在平台包裝中附帶相同的原生結構，show_usage=true 回傳平台整理後的用量資訊。影片和結束影格網址可能有有效期限，請及時下載或轉存。

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

原生任務資料支援標準 Seedance 2.0 的 4k 解析度及任務 priority；Fast 僅支援 480p/720p。

GET/v1/video/generations/{task_id}

使用建立 API 回傳的任務 ID 查詢 Seedance 2.0 影片任務。任務進入 completed 或 failed 後應停止輪詢。

建議每隔 30 到 60 秒查詢一次。完成後的影片 URL 可能存在有效期，請儘快下載並轉存。

授權

bearerAuth

授權Bearer <token>

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

傳遞位置: header

路徑參數

task_id*string

建立影片任務時回傳的任務 ID。

長度1 <= length

查詢參數

raw?boolean

傳 true 時直接回傳上游原始任務資料，便於排查問題。

show_raw?boolean

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

show_usage?boolean

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

回應主體

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

授權

路徑參數

查詢參數

回應主體

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`