Seedance · 火山方舟格式

查询视频生成任务列表

按状态、任务 ID 或模型筛选任务，分页返回。请求参数和返回结果与火山方舟「查询视频生成任务列表」接口一致。

GEThttps://your-domain/ark/api/v3/contents/generations/tasks

请求示例

curl "https://your-domain/ark/api/v3/contents/generations/tasks?page_num=1&page_size=10&filter.status=succeeded" \
  -H "Authorization: Bearer $ARK_API_KEY"

返回结果

{
  "items": [
    {
      "id": "video_8f3k2m9x4q1w7e5r0t6y2u4p",
      "model": "doubao-seedance-2-0-260128",
      "status": "succeeded",
      "content": {
        "video_url": "https://your-domain/uploads/videos/2026/10/k3Zq8mVt2LxR9pWa.mp4"
      },
      "usage": {"completion_tokens": 108900, "total_tokens": 108900},
      "created_at": 1791691200,
      "updated_at": 1791691318,
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "framespersecond": 24,
      "service_tier": "default",
      "execution_expires_after": 43200,
      "generate_audio": true,
      "draft": false,
      "priority": 0,
      "output_format": "mp4"
    }
  ],
  "total": 1
}

请求参数

参数都放在查询字符串里，都可以不传。

查询参数

page_numinteger默认值 1

页码，1 到 500。

page_sizeinteger默认值 20

每页的任务数，1 到 500。

filter.statusstring

按任务状态筛选：queued、running、cancelled、succeeded、failed 或 expired，含义见任务状态。

filter.task_idsstring[]

按任务 ID 精确查询。查询多个任务时重复这个参数，例如 filter.task_ids=id1&filter.task_ids=id2，也可以在一个参数里用英文逗号分隔多个 ID。

filter.modelstring

按模型 ID 筛选，例如 doubao-seedance-2-0-260128。

filter.service_tierstring

按服务等级筛选。所有任务的服务等级都是 default，传其他值时返回空列表。

返回参数

itemsobject[]

当前页的任务，按创建时间从新到旧排列。每个任务的字段和查询视频生成任务的返回结果相同。

totalinteger

符合筛选条件的任务总数。

列表只包含 Seedance 系列模型的任务，用 OpenAI 格式创建的 Seedance 任务也在其中。
创建时返回错误的请求不会生成任务，也不在列表里。
可以查询全部历史任务，没有火山方舟只保留 7 天的限制。

请求示例

按任务 ID 批量查询

重复传 filter.task_ids，一次查询多个任务。官方 SDK 传入 ID 列表即可：

按任务 ID 批量查询

curl "https://your-domain/ark/api/v3/contents/generations/tasks?filter.task_ids=video_8f3k2m9x4q1w7e5r0t6y2u4p&filter.task_ids=video_2b7n5c1v9z3x6m8q4w0e1r7t" \
  -H "Authorization: Bearer $ARK_API_KEY"