查询 Seedance 视频任务

GET

/v1/videos/{task_id}

接口说明

按任务 ID 查询 Seedance 视频生成状态。

状态说明

queued：已入队

in_progress：生成中

completed：生成完成

failed：生成失败，查看 error.message

unknown：未知状态，建议稍后重试或联系平台排查

轮询建议

建议每 5-10 秒查询一次，避免高频轮询。任务完成后使用 /v1/videos/{task_id}/content 下载文件。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/videos/task_KNg2gz1vWF0jKhPOBbvCdkGEMzMG804I' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "id": "task_KNg2gz1vWF0jKhPOBbvCdkGEMzMG804I",
  "task_id": "task_KNg2gz1vWF0jKhPOBbvCdkGEMzMG804I",
  "object": "video",
  "model": "seedance2.0_fast_vision",
  "status": "completed",
  "progress": 100,
  "created_at": 1783060800,
  "completed_at": 1783060920,
  "metadata": {
    "url": "https://nevoapi.com/v1/videos/task_KNg2gz1vWF0jKhPOBbvCdkGEMzMG804I/content"
  }
}

修改于 2026-07-03 13:57:20

创建 Seedance 视频任务

下载 Seedance 视频内容