AI 智剪任务完成事件--视频点播-火山引擎

文档中心

立即注册

导航

视频点播

AI 智剪任务完成事件

最近更新时间：2025.11.03 19:38:00首次发布时间：2025.11.03 19:38:00

本文为您介绍 AI 智剪任务完成事件。

事件类型

VCreativeComplete

事件说明

当您提交的异步 AI 智剪任务执行完成时，视频点播服务会向您配置的地址发送此事件通知。配置方法详见事件通知概览。

事件内容

参数	类型	示例值	必填	说明
RequestId	`String`	`202405060***CF1866`	是	请求的唯一 ID。
Version	`String`	`1.0`	是	回调版本。
EventType	`String`	`VCreativeComplete`	是	事件名称。
EventTime	`String`	`2024-05-06T09:49:33Z`	是	事件产生时间，UTC 时间。
Data	`Object`	`-`	是	回调的核心内容，JSON 格式。

Data

参数	类型	描述
VcreativeId	`String`	AI 智剪任务 ID。
Code	`Integer`	任务的执行结果码。 `0`: 任务成功。其他值: 任务失败。
Message	`String`	任务信息。当 `Code` 不为 `0` 时，此字段会返回详细的错误信息，用于问题排查。
OutputJson	`String`	任务的输出结果，是一个 JSON 格式的字符串。任务成功时：此字段包含产物视频的 `Vid`、封面图 `PostUrl` 等媒资信息。您需要对其进行 JSON 解析以获取。任务失败时：此字段通常为空。
CallbackArgs	`String`	回调透传信息。仅当您在提交任务时设置了 `CallbackArgs` 参数时，才会返回此字段。
User	`String`	提交任务的用户标识。
TangramId	`String`	内部任务流 ID，可用于问题排查。
StartTime	`Integer`	任务开始执行的时间戳，单位为毫秒。
EndTime	`Integer`	任务结束执行的时间戳，单位为毫秒。

回调示例

任务成功

{
  "RequestId": "20241030***",
  "Version": "1.0",
  "EventType": "VCreativeComplete",
  "EventTime": "2024-10-30T12:26:36Z",
  "Data": {
    "User": "****",
    "Code": 0,
    "Message": "",
    "VcreativeId": "20251030v201859c01037acdd3f4373a794ae6ddf****",
    "TangramId": "t01030023d8e1636d41lfcs8svdbn****",
    "OutputJson": "{\"out_video\":{\"Vid\":\"v0d2d2g10065d41liuil***0p4hig290\", ...}}",
    "CallbackArgs": "{\"Func\":\"\",\"Space\":\"test\",...}",
    "StartTime": 1761826740084,
    "EndTime": 1761827196546
  }
}

任务失败

{
  "RequestId": "20241030...",
  "Version": "1.0",
  "EventType": "VCreativeComplete",
  "EventTime": "2024-10-30T12:17:08Z",
  "Data": {
    "User": "****",
    "Code": 1,
    "Message": "internal error: node Batch::26::GenShot error [code]=1, [message]=internal error...",
    "VcreativeId": "20251030v201044c0103699a3b04318a49f03068c****",
    "TangramId": "t01030027de17f68d41lbh48svd09pe****",
    "OutputJson": "",
    "CallbackArgs": "{\"Func\":\"\",\"Space\":\"test\",...}",
    "StartTime": 1761826244655,
    "EndTime": 1761826628516
  }
}