You need to enable JavaScript to run this app.
导航
视频点播
  • 文档首页
    • /视频点播/服务端 API 参考/视频剪辑/剪辑任务管理/GetTaskList - 获取工程化剪辑任务列表
GetTaskList - 获取工程化剪辑任务列表
最近更新时间：2025.10.24 21:15:23首次发布时间：2025.10.24 19:49:14
复制全文
我的收藏
有用
有用
无用
无用

调用 GetTaskList 分页查询工程化剪辑任务列表。

使用说明

本接口仅用于查询通过 SubmitEditTaskAsync 提交的工程化剪辑任务。您可以获取每个任务的 TaskId、执行状态、产物信息（如 VideoId）、费用等详细信息。

请求说明

  • 请求方式：GET
  • 请求地址：https://vod.volcengineapi.com?Action=GetTaskList&Version=2018-01-01

调试

API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

Query

参数
类型
是否必选
示例值
描述
Action
String
是
GetTaskList
接口名称。当前 API 的名称为 GetTaskList。
Version
String
是
2018-01-01
接口版本。当前 API 的版本为 2018-01-01。
Limit
String
是
10
分页查询时每页返回的任务数量。
Offset
String
是
0
分页查询时的起始记录位置，表示从第几条记录开始返回。
Space
String
是
vod-v2-test
剪辑任务所属的点播空间名称。
Type
String
是
1
剪辑任务类型，当前仅支持取值为 1。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数
类型
示例值
描述
Total
Integer
9702
查询结果的总数量。
Detail
Object[]
-
包含符合搜索条件的项目详细信息列表。
Id
String
p0c1c00xxxxxxxxx44n0
剪辑工程 ID。
Name
String
sxp_video-1019-11:31
剪辑任务的名称。
TaskId
String
e070c74xxxxxxxxa5903efa7
剪辑任务 ID。
VideoId
String
v0225cg***1d3m9t42ljht3ugnu38f0
视频 ID。
Definition
String
1920*1080
剪辑任务的视频分辨率，表示视频的宽度和高度，单位为像素。
PosterUri
String
tos-cn-v-febf3a/9******783b00c8beb40724dee
剪辑任务生成的封面图 URI。视频上传时，自动生成的封面图存储地址为 PosterUri 字段。
Space
String
vod-v2-test
剪辑任务所属的空间名称。
Status
Integer
1

剪辑任务的当前处理状态。支持以下取值。

  • 1 ：正在处理；
  • 2 ：处理成功；
  • 3 ：处理失败。
Cost
Integer
0
剪辑任务所产生的费用，单位为元。
CreateAt
String
2025-10-19T11:31:07+08:00
剪辑任务的创建时间，采用 ISO 8601 格式，包含时区信息。

请求示例

GET https://vod.volcengineapi.com?Action=GetTaskList&Version=2018-01-01

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "GetTaskList",
    "Version": "2018-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "Total": 9702,
    "Detail": [
      {
        "Id": "p0c1c00xxxxxxxxx44n0",
        "Name": "sxp_video-1019-11:31",
        "TaskId": "e070c74xxxxxxxxa5903efa7",
        "VideoId": "",
        "Definition": "1920*1080",
        "PosterUri": "",
        "Space": "vod-v2-test",
        "Status": 1,
        "Cost": 0,
        "CreateAt": "2025-10-19T11:31:07+08:00"
      }
    ]
  }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。