You need to enable JavaScript to run this app.
文档中心
企业直播

企业直播

复制全文
下载 pdf
视频质检 API
GetVideoTask - 获取视频质检任务详情
复制全文
下载 pdf
GetVideoTask - 获取视频质检任务详情

调用 GetVideoTask 接口,获取指定视频质检项目下的质检任务详情,包含任务状态、任务 ID、视频数据来源等详情。

注意事项

  • 请求频率:单用户请求频率限制为 10 次/秒
  • 前提条件:确保当前账号已开通质检服务。若当前账号为子账号,请同时确保主账号已在直播质检平台为该子账号授权,详见为子账号授权。否则账号将提示“暂无使用权限,请联系客服人员申请开通”。

请求说明

  • 请求方式:GET
  • 请求地址:https://livesaas.volcengineapi.com/?Action=GetVideoTask&Version=2024-08-01

请求参数

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

Query

参数类型是否必选示例值描述
ActionStringGetVideoTask接口名称。当前 API 的名称为 GetVideoTask
VersionString2024-08-01接口版本。当前 API 的版本为 2024-08-01
ProjectNameString1827*****8608457视频质检项目名称。您可通过调用 ListProjects 接口获取项目名称。
TaskIdLong397**671视频质检任务 ID。您可通过调用 CreateVideoTaskListVideoTasks 获取。

返回参数

参数类型示例值描述
TaskIdLong397**671视频质检任务 ID。
TaskNameString任务 A任务名称。
ProjectNameString182701****608457项目名称。
TaskTypeInteger1任务类型。固定取值为 1,表示对视频进行质检。
TaskTypeDescString审核任务 1任务类型描述。

Status

Integer

4

任务状态。取值如下:

  • 1:待机审
  • 2:机审中
  • 3:待人审
  • 4:已完成(人审已完成)
  • 5:任务执行失败
ScenarioIdLong1审核场景 ID。
CreatedTimeLong1744012851任务创建时间。Unix 时间戳,单位为秒。
UpdatedTimeLong1744012851任务更新时间(任务更新指任务状态变化等情况)。Unix 时间戳,单位为秒。
CallbackURLStringhttps://www.example.comCreateVideoTask 接口传入的视频质检消息的回调地址。详见视频质检消息回调
ExtraStringextraCreateVideoTask 接口传入的业务相关信息。
TagsArray of Tags-质检任务绑定的标签。
VideoInfoObject of VideoInfo-视频质检任务关联的视频信息。

Tags

参数类型示例值描述
TagNameString标签 B标签名称。
ParentTagIdLong26父标签 ID。
ParentTagNameString标签 A父标签名称。
TagIdLong121标签 ID。

VideoInfo

参数类型示例值描述

Vid

String

v02eag10000****ctk

视频的唯一标识。

说明

仅当 SourceType 取值为 1 时,返回该参数。

VideoURL

String

https://example.com/video.mp4

视频的地址。

说明

仅当 SourceType 取值为 4 时,返回该参数。

VideoNameStringvideo.mp4视频的名称。

SourceType

Integer

3

视频数据源类型。取值如下:

  • 1:当前项目的视频管理库
  • 3:质检回放视频,即当前账号可见的直播质检任务中的直播回放视频
  • 4:通过视频 URL 地址提供的视频

SourceTaskId

Long

397**671

当视频来源于质检回放时,该回放视频关联的直播质检任务 ID。

说明

仅当 SourceType 取值为 3 时,返回该参数。

请求示例

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
        }
    }
}

错误码

访问公共错误码错误码获取详细信息。

最近更新时间:2026.06.11 11:04:31
这个页面对您有帮助吗?
有用
有用
无用
无用