调用 StartExecution 接口提交媒体处理任务，对指定文件进行媒体处理。

使用说明 #

• 调用本接口可实现以下媒体处理任务：

  • 高光分析：详细功能介绍和使用流程请见短剧高光智剪。
  • 巨量广告预审：详细功能介绍和使用流程请见巨量广告预审。
  • 大模型理解：详细功能介绍和使用流程请见大模型视频理解。
  • 音频分离：可从用户输入的音频或视频中分离人声和背景音乐。
  • 语音转写：可将用户输入的音频或视频中的语音转写为文本。输入文件时长不得超过 3 个小时。
  • 故事线分析：可对用户输入的单个或多个长视频（包括电影、电视剧、综艺、短剧、微电影等）进行分析理解，并输出故事线信息。单个输入文件时长不得超过 2.5 个小时。
  • 场景切分：可依据转场情况对用户输入的视频进行切分，并输出切片。输入文件时长不得超过 2 个小时。
  • 视频分段摘要：依托 ASR 识别结果，借助大模型自动提取并概括分段视频的摘要，帮助用户快速定位感兴趣的视频片段，适用于教学课程、新闻、演讲等视频场景。

• 成功提交后，系统将生成异步执行的媒体处理任务。您可通过以下方式获取媒体处理结果：

  • 配置媒体处理任务执行完成事件通知。
  • 调用 GetExecution 获取媒体处理任务执行结果。

注意事项 #

• 高光分析、巨量广告审核、音频分离、语音转写、故事线分析、场景切分为白名单功能。使用前请提交工单联系火山引擎技术支持团队申请开通。
• 若您已按照添加对象存储 Bucket中的说明挂载 TOS，则不支持进行故事线分析任务。
• 提交媒体处理任务会产生视频 AI 费用，具体参见视频 AI 应用计费。
• 本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

请求说明 #

• 请求方式：POST
• 请求地址：https://vod.volcengineapi.com?Action=StartExecution&Version=2023-07-01

请求参数 #

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

Query #

Body #

返回参数 #

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

请求示例 #

高光分析 #

通过 Vid 提交高光分析任务：

POST https://vod.volcengineapi.com?Action=StartExecution&Version=2023-07-01
{
  "MultiInputs": [
    {
      "Type": "Vid",
      "Vid": "v0d399g10001d0vavaaljht2b2ut25hg"
    },
    {
      "Type": "Vid",
      "Vid": "v0d399g10001d0vavaaljhtdla347kr0"
    },
    {
      "Type": "Vid",
      "Vid": "v03399g10001d0vavaaljht5539pchbg"
    }
  ],
  "Operation": {
    "Type": "Task",
    "Task": {
      "Type": "Highlight",
      "Highlight": {
        "Mode": "StorylineCuts",
        "StorylineCuts": {
          "MinDuration": 60,
          "MaxDuration": 180,
          "MaxNumber": 2
        }
      }
    }
  }
}

巨量广告预审 #

POST https://vod.volcengineapi.com?Action=StartExecution&Version=2023-07-01
{
  "Input": {
    "Type": "Vid",
    "Vid": "v0d25cg10001cu7jcvqljht8dj05mde0"
  },
  "Operation": {
    "Type": "Task",
    "Task": {
      "Type": "AdAudit",
      "AdAudit": {
        "AdvertiserId": "1812496***000731",
        "BusinessType": "ad"
      }
    }
  }
}

大模型视频理解 #

POST https://vod.volcengineapi.com?Action=StartExecution&Version=2023-07-01
{
  "Input": {
    "Type": "Vid",
    "Vid": "v0d25cg10001cu7jcvqljht8dj05mde0"
  },
  "Operation": {
    "Type": "Task",
    "Task": {
      "Type": "Vision",
      "Vision": {
        "Prompt": "基于输入的视频抽帧图片信息和音频转译文本，深度理解视频内容。首先，撰写一段视频总结，需涵盖视频的核心主题、主要情节、关键人物及其关系及核心观点或情感；其次，抽取能精准概括视频内容、突出视频特色的主要标签。",
        "Model": {
          "DoubaoVisionEndpoint": "ep-202412***175335-cg2p7",
          "AsrAppId": "3500***054",
          "AsrAppType": "volc.bigasr.sauc.duration"
        }
      }
    }
  }
}

音频分离 #

通过 Vid 提交音频分离任务

POST https://vod.volcengineapi.com?Action=StartExecution&Version=2023-07-01
{
  "Input": {
    "Type": "Vid",
    "Vid": "v0d25cg10001cu7jcvqljht8dj05mde0"
  },
  "Operation": {
    "Type": "Task",
    "Task": {
      "Type": "AudioExtract",
      "AudioExtract": {
        "Voice": true
      }
    }
  }
}

语音转写 #

通过 Vid 提交语音转写任务：

POST https://vod.volcengineapi.com?Action=StartExecution&Version=2023-07-01
{
  "Input": {
    "Type": "Vid",
    "Vid": "v0325cg10001cuvvh4qljht4om9gitmg"
  },
  "Operation": {
    "Type": "Task",
    "Task": {
      "Type": "Asr",
      "Asr": {
        "Type": "speech",
        "WithSpeakerInfo": true,
        "WithConfidence": true
      }
    }
  }
}

故事线分析 #

基于多个 Vid 类型输入文件提交故事线分析任务：

POST https://vod.volcengineapi.com?Action=StartExecution&Version=2023-07-01
{
  "MultiInputs": [
    {
      "Type": "Vid",
      "Vid": "v0ccfeg7007acu3qlm7og65tu3orai10"
    },
    {
      "Type": "Vid",
      "Vid": "v0ccfeg7007acu3qlm7og65tu3orai11"
    },
    {
      "Type": "Vid",
      "Vid": "v0ccfeg7007acu3qlm7og65tu3orai12"
    }
  ],
  "Operation": {
    "Type": "Task",
    "Task": {
      "Type": "Storyline",
      "Storyline": {
        "WithSnapshot": true
      }
    }
  },
  "Control": {
    "ClientToken": "12345654321"
  }
}

视频分段摘要 #

POST https://vod.volcengineapi.com?Action=StartExecution&Version=2023-07-01

场景切分 #

通过 Vid 提交场景切分任务：

POST https://vod.volcengineapi.com?Action=StartExecution&Version=2023-07-01
{
  "Input": {
    "Type": "Vid",
    "Vid": "v028adg10003d04b0j2ljhtfnjj11q80"
  },
  "Operation": {
    "Type": "Task",
    "Task": {
      "Type": "Segment",
      "Segment": {}
    }
  },
  "Control": {
    "ClientToken": "1235"
  }
}

返回示例 #

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "StartExecution",
    "Version": "2023-07-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "RunId": "hb:c5cacd4946bd***a5fd9f74159b03ae8"
  }
}

错误码 #

本接口无特有的错误码。更多信息请见公共错误码。

服务端 SDK #

视频点播为 OpenAPI 提供了配套的服务端 SDK，支持多种编程语言，帮助您实现快速开发。建议使用服务端 SDK 来调用 API。本接口仅 VOD SDK 2.0 支持，详见 V2.0 SDK 介绍与迁移说明。