解说视频生成完成事件--视频点播-火山引擎

文档中心

立即注册

导航

视频点播

解说视频生成完成事件

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

本文为您介绍短剧解说视频生成任务完成的回调事件。

事件类型

DramaRecapComplete

事件说明

当您提交的短剧解说视频生成任务执行完成时，视频点播服务会向您配置的回调地址发送此事件通知。配置方法详见事件通知概览。关联接口：CreateDramaRecapTask。

事件内容

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

Data

参数	类型	是否必传	说明
TaskId	String	是	解说视频生成任务的 ID，与 `CreateDramaRecapTask` 接口返回的 `TaskId` 一致。
DramaScriptTaskId	String	否	本次任务关联的剧本还原任务 ID。
Status	String	是	任务执行状态，取值如下： `success`：成功。 `failed`：失败。 `timeout`：超时。
BizCode	Int	是	业务状态码。`0` 表示成功，非 `0` 表示失败。可能的取值如下： `4`：表示任务超时（目前默认 24 小时） `500xxx`：表示内部服务错误 `400xxx`：表示输入参数非法
Vid	String	否	任务成功时返回，表示新生成的解说视频的 Vid。任务失败时，该字段不存在。

回调示例

{
  "Data": {
    "BizCode": 0,
    "DramaScriptTaskId": "v02cd3g10001***6panbj659kvikqsg",
    "Status": "success",
    "TaskId": "v02cd3g10001***6g2nbj659kvikr00",
    "Vid": "v02cd3g10001d3k***iljht5l6ndr9n0"
  },
  "EventTime": "2025-10-10T06:58:08Z",
  "EventType": "DramaRecapComplete",
  "RequestId": "20251010141007***C6A121E396EB99E17",
  "Version": "1.0"
}