剧本还原任务完成事件--视频点播-火山引擎

文档中心

立即注册

导航

视频点播

剧本还原任务完成事件

最近更新时间：2025.10.11 14:24:05首次发布时间：2025.10.11 14:24:05

本文为您介绍剧本还原任务完成的回调事件。

事件类型

DramaScriptComplete

事件说明

当您提交的剧本还原任务执行完成（无论成功或失败）时，视频点播服务会向您配置的回调地址发送此事件通知。配置方法详见事件通知概览。关联接口：CreateDramaScriptTask。

事件内容

参数	类型	是否必传	说明
RequestId	String	是	请求的唯一 ID。
Version	String	是	回调版本，当前为 `1.0`。
EventType	String	是	事件类型，固定为 `DramaScriptComplete`。
EventTime	String	是	事件产生的 UTC 时间，格式为 `YYYY-MM-DDTHH:mm:ssZ`。
Data	Object	是	回调内容，详情见下文 `Data` 结构。

Data

参数	类型	是否必传	说明
TaskId	String	是	剧本还原任务的 ID，与 `CreateDramaScriptTask` 接口返回的 `TaskId` 一致。
Status	String	是	任务执行状态，取值如下： `success`：成功。 `failed`：失败。 `timeout`：超时。
BizCode	Int	是	业务状态码。`0` 表示成功，非 `0` 表示失败。可能的取值如下： `4`：表示任务超时（目前默认 24 小时） `500xxx`：表示内部服务错误 `400xxx`：表示输入参数非法
FileName	String	否	任务成功时返回，表示剧本还原结果文件的存储路径。您需要根据点播空间配置拼接完整的下载 URL，详见自行拼接。任务失败时，该字段不存在。

回调示例

{
  "Data": {
    "BizCode": 0,
    "FileName": "video_analyze_results/20251010103931.v02cd3g10001d3k6rbinbj63aeuds710.json.gz",
    "Status": "success",
    "TaskId": "v02cd3g10001***rbinbj63aeuds710"
  },
  "EventTime": "2025-10-10T02:39:31Z",
  "EventType": "DramaScriptComplete",
  "RequestId": "20251010102134***B01183CAE56000D",
  "Version": "1.0"
}