查询视频生成任务列表

分页查询当前账号的视频生成任务，支持按任务状态、任务 ID 筛选。

请求

GET https://platform.shuyanai.com/seedance/api/v3/contents/generations/tasks

请求参数

查询参数（Query）

所有参数均通过 URL Query String 传入，无需请求体。

参数	类型	必填	默认值	说明
`page_num`	integer	否	`1`	页码，从 1 开始，取值范围：[1, 500]
`page_size`	integer	否	`20`	每页返回数量，取值范围：[1, 500]
`filter.status`	string	否	—	按任务状态筛选，枚举值：`queued`、`running`、`succeeded`、`failed`、`cancelled`、`expired`
`filter.task_ids`	string[]	否	—	按任务 ID 精确筛选。传多个 ID 时重复参数名，如 `filter.task_ids=id1&filter.task_ids=id2`

请求头

头部	必填	说明
`Authorization`	是	`Bearer sk-xxx`

请求示例

基础分页查询

按状态筛选

按任务 ID 筛选

响应参数

items object[]

任务列表。每个元素的结构与查询视频生成任务接口的响应一致，包含 id、model、status、content、created_at、updated_at、service_tier、duration、seed、usage 等字段。content 仅在任务成功后返回。

total integer

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

响应示例

{
  "items": [
    {
      "id": "cgt-20250611100000-xxxxx",
      "model": "doubao-seedance-2-0-260128",
      "content": {
        "video_url": "https://example.com/generated_video_1.mp4"
      },
      "status": "succeeded",
      "created_at": 1749619200,
      "updated_at": 1749619320,
      "service_tier": "default",
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "framespersecond": 24,
      "seed": 11,
      "generate_audio": true,
      "draft": false,
      "priority": 0,
      "execution_expires_after": 172800,
      "usage": {
        "completion_tokens": 108900,
        "total_tokens": 108900
      }
    }
  ],
  "total": 42
}

注意事项

任务 ID 保留 7 天（从 created_at 开始计算），超时后自动清除，不可再查询。

已取消的任务（cancelled）在取消后 24 小时自动删除。

列表中每个任务的 content.video_url 有效期为 24 小时，如需长期保存请及时下载或转存。

多个筛选条件同时传入时为交集（AND）关系。

03-查询视频生成任务列表

查询视频生成任务列表#

请求#

请求参数#

查询参数（Query）#

请求头#

请求示例#

基础分页查询#

按状态筛选#

按任务 ID 筛选#

响应参数#

响应示例#

注意事项#