调用 GetVideoTask 接口,获取指定视频质检项目下的质检任务详情,包含任务状态、任务 ID、视频数据来源等详情。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | GetVideoTask | 接口名称。当前 API 的名称为 GetVideoTask。 |
| Version | String | 是 | 2024-08-01 | 接口版本。当前 API 的版本为 2024-08-01。 |
| ProjectName | String | 是 | 1827*****8608457 | 视频质检项目名称。您可通过调用 ListProjects 接口获取项目名称。 |
| TaskId | Long | 是 | 397**671 | 视频质检任务 ID。您可通过调用 CreateVideoTask 或 ListVideoTasks 获取。 |
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| TaskId | Long | 397**671 | 视频质检任务 ID。 |
| TaskName | String | 任务 A | 任务名称。 |
| ProjectName | String | 182701****608457 | 项目名称。 |
| TaskType | Integer | 1 | 任务类型。固定取值为 1,表示对视频进行质检。 |
| TaskTypeDesc | String | 审核任务 1 | 任务类型描述。 |
Status | Integer |
| 任务状态。取值如下:
|
| ScenarioId | Long | 1 | 审核场景 ID。 |
| CreatedTime | Long | 1744012851 | 任务创建时间。Unix 时间戳,单位为秒。 |
| UpdatedTime | Long | 1744012851 | 任务更新时间(任务更新指任务状态变化等情况)。Unix 时间戳,单位为秒。 |
| CallbackURL | String | https://www.example.com | CreateVideoTask 接口传入的视频质检消息的回调地址。详见视频质检消息回调。 |
| Extra | String | extra | CreateVideoTask 接口传入的业务相关信息。 |
| Tags | Array of Tags | - | 质检任务绑定的标签。 |
| VideoInfo | Object of VideoInfo | - | 视频质检任务关联的视频信息。 |
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| TagName | String | 标签 B | 标签名称。 |
| ParentTagId | Long | 26 | 父标签 ID。 |
| ParentTagName | String | 标签 A | 父标签名称。 |
| TagId | Long | 121 | 标签 ID。 |
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
Vid | String |
| 视频的唯一标识。 说明 仅当 |
VideoURL | String |
| 视频的地址。 说明 仅当 |
| VideoName | String | video.mp4 | 视频的名称。 |
SourceType | Integer |
| 视频数据源类型。取值如下:
|
SourceTaskId | Long |
| 当视频来源于质检回放时,该回放视频关联的直播质检任务 ID。 说明 仅当 |
GET https://livesaas.volcengineapi.com/?Action=GetVideoTask&Version=2024-08-01&ProjectName=1827*****8608457&TaskId=397**671
{ "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "GetVideoTask", "Version": "2024-08-01", "Service": "livesaas", "Region": "cn-north-1" }, "Result": { "TaskId": 397**671, "TaskName": "任务 A", "ProjectName": "182701****608457", "TaskType": 1, "TaskTypeDesc": "审核任务 1", "Status": 4, "ScenarioId": 1, "CreatedTime": 1744012851, "UpdatedTime": 1744012851, "CallbackURL": "https://www.example.com", "Extra": "extra", "Tags": [ { "TagName": "标签 B", "ParentTagId": 26, "ParentTagName": "标签 A", "TagId": 121 } ], "VideoInfo": { "SourceType": 3, "SourceTaskId": 397**671 } } }