跳到主要内容

查询 Seedance 视频生成任务列表

列表接口只读取当前用户在 PinduCloud 提交的 Seedance 任务，不会把其他 用户的任务返回给调用方。过滤条件放在 Query 参数中，不能发送 JSON 请求体。

请求​

GET https://video.pinducloud.com.cn/doubao/api/v3/contents/generations/tasks

基础分页请求：

curl --get "$BASE_URL/doubao/api/v3/contents/generations/tasks" \
  --header "Authorization: Bearer $API_KEY" \
  --data-urlencode "page_num=1" \
  --data-urlencode "page_size=20"

按状态和模型过滤：

curl --get "$BASE_URL/doubao/api/v3/contents/generations/tasks" \
  --header "Authorization: Bearer $API_KEY" \
  --data-urlencode "page_num=1" \
  --data-urlencode "page_size=20" \
  --data-urlencode "filter.model=doubao-seedance-2-0-fast-260128" \
  --data-urlencode "filter.status=succeeded" \
  --data-urlencode "filter.service_tier=default"

查询参数​

参数类型和限制默认值说明
page_num整数，1~5001页码
page_size整数，1~50020每页条数
filter.model单个字符串，最长 191 字符空按模型 ID过滤
filter.statusqueued、running、succeeded、failed、cancelled空按状态过滤
filter.service_tierdefault、flexdefault按服务等级过滤
filter.task_ids可重复，最多 100 个，每个非空且最长 191 字符空按 PinduCloud 任务 ID过滤

过滤条件之间按 AND 关系处理。未传 filter.model 时表示所有当前用户可见的 Seedance 任务。列表仅覆盖最近 7 天的创建记录，超出窗口的任务不在列表中返回； 这不是视频下载链接的有效期。 filter.service_tier 只是对已保存任务的字段进行筛选，不代表当前 Seedance 2.0 创建入口可以传入 service_tier。

重复任务 ID的写法：

curl --get "$BASE_URL/doubao/api/v3/contents/generations/tasks" \
  --header "Authorization: Bearer $API_KEY" \
  --data-urlencode "filter.task_ids=task_gateway_doubao_01" \
  --data-urlencode "filter.task_ids=task_gateway_doubao_02"

响应​

{
  "items": [
    {
      "id": "task_gateway_doubao_01",
      "model": "doubao-seedance-2-0-fast-260128",
      "status": "succeeded",
      "resolution": "720p",
      "duration": 5,
      "content": {
        "video_url": "https://cdn.example.com/video.mp4"
      },
      "usage": {
        "completion_tokens": 108000,
        "total_tokens": 108000
      }
    },
    {
      "id": "task_gateway_doubao_02",
      "model": "doubao-seedance-2-0-fast-260128",
      "status": "running"
    }
  ],
  "total": 2
}

items 中每项的任务字段与单任务查询相同。处理中任务没有视频 地址，成功任务的 URL仍然可能随签名有效期过期。

参数错误​

以下情况会返回 400：页码或每页数量不在范围内、同一个单值参数重复出现、状态 值不受支持、任务 ID为空或超过数量限制、出现未列出的查询参数，以及向列表接口发送请求体。 当前 filter.status 不接受 expired；单任务查询可能返回该终态，两者取值范围不同。