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

企业直播

复制全文
下载 pdf
视频质检 API
EndVideoTask - 结束视频质检任务
复制全文
下载 pdf
EndVideoTask - 结束视频质检任务

调用 EndVideoTask 接口,结束待机审中的任务。

注意事项

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

请求说明

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

请求参数

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

Query

参数类型是否必选示例值描述
ActionStringEndVideoTask接口名称。当前 API 的名称为 EndVideoTask
VersionString2024-08-01接口版本。当前 API 的版本为 2024-08-01

Body

参数类型是否必选示例值描述

TaskId

Long

397**671

视频质检任务 ID。您可通过调用 CreateVideoTaskListVideoTasks 获取。

说明

目前仅支持状态为“待机审”的任务。

ProjectNameString1827*****8608457视频质检项目名称。您可通过调用 ListProjects 接口获取项目名称。

返回参数

参数类型示例值描述
StatusBooleantrue是否成功结束任务。成功返回 true

请求示例

POST https://livesaas.volcengineapi.com/?Action=EndVideoTask&Version=2024-08-01
{
    "TaskId": 397**671,
    "ProjectName": "1827*****8608457"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "EndVideoTask",
        "Version": "2024-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1"
    },
    "Result": {
        "Status": true
    }
}

错误码

下表提供了该接口特有的错误码,公共错误码请参见公共错误码错误码文档。

状态码错误码错误信息说明
400TaskIdInvalidErrorinvalid task id视频质检任务不存在。请检查 TaskId 参数。您可通过调用 CreateVideoTaskListVideoTasks 获取。
400TaskTypeInvalidErrorinvalid task type当前任务不是视频质检任务。请调用 ListProjects 接口,通过 ProjectType 判断当前项目类型。

400

TaskStatusInvalidError

invalid task status

仅支持结束待机审的视频质检任务。请调用 [GetVideoTask](https://www.volcengine.com/docs/3019/2519542
?lang=zh) 接口查询任务状态。

409

ConcurrentUpdateConflictError

concurrent update conflict

任务状态发生变化。请调用 [GetVideoTask](https://www.volcengine.com/docs/3019/2519542
?lang=zh) 接口重新查询任务状态。

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