删除高光剪辑任务--视频直播-火山引擎

文档中心

立即注册

导航

视频直播

删除高光剪辑任务

最近更新时间：2025.03.04 13:55:24首次发布时间：2025.03.04 13:55:24

调用 DeleteTaskByAccountID 接口，立即删除高光剪辑任务。如果任务正在执行，已经保存的高光剪辑素材会被保留，而尚未生成或返回的素材将不再生成或返回。

注意事项

请求频率：单用户请求频率限制为 10 次/秒。

请求说明

请求方式：POST
请求地址：https://live.volcengineapi.com?Action=DeleteTaskByAccountID&Version=2023-01-01

调试

API Explorer

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

去调试

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`DeleteTaskByAccountID`	接口名称。当前 API 的名称为 `DeleteTaskByAccountID`。
Version	String	是	`2023-01-01`	接口版本。当前 API 的版本为 `2023-01-01`。

Body

参数	类型	是否必选	示例值	描述
TaskID	String	是	`83d734****d0c077`	任务 ID。调用 `CreateHighLightTask` 接口时返回。

返回参数

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

参数	类型	示例值	描述
Data	String	`kill task [65cc32**19a7cc] success,mesos id is [live_effect_boe_6e**0b_000000000003893],rowsAffect [0]`	任务删除操作的详细信息。

请求示例

POST https://live.volcengineapi.com?Action=DeleteTaskByAccountID&Version=2023-01-01
{
    "TaskID": "6daea6****afb715"
}

返回示例

{
    "ResponseMetadata": {
        "RequestID": "2025030315394954****877762782D59B9"
    },
    "Result": {
        "Code": 0,
        "Message": "success",
        "Data": "kill task [6daea6****afb715] success,mesos id is [live_effect_boe_6e****0b_000000000004107],rowsAffect [0]"
    }
}

错误码

下表仅列出本接口特有的错误码。更多信息请参见公共错误码获取详细信息。

状态码	错误码	错误信息	说明
500	InternalError	an internal error occurred, please contact the administrator.	出现内部错误，请联系技术支持。