本文介绍视频拆条SplitVideoParts的语法及示例。

功能描述

视频拆条能力可以多维度对视频进行片段拆分,并对片段进行摘要描述,拆分维度包含镜头、人物、主题、场景等。

应用场景

影视传媒素材生产:支持影视传媒视频的智能信息分析和片段拆分,可用于长视频完整片段拆分分发、快编素材生成和视频剪辑等场景。

特色优势

  • 支持多维度信息提取:支持对多种信息维度进行信息提取,并基于该信息进行片段拆分。
  • 拆分粒度细:可对素材进行秒级或帧级拆分。
  • 支持素材摘要信息透出:可对拆分片段进行信息摘要描述。

前提条件

请确保您已开通视频理解服务,若未开通服务请立即开通

输入限制

  • 视频格式:AVI、FLV、MKV、MPG、MP4、TS、MOV、MXF。
  • 视频大小:小于4 GB。
  • 视频时长限制:时长不超过3小时。
  • 视频分辨率:大于等于240P,小于等于1440P。
  • URL地址中不能包含中文字符。

计费说明

关于视频拆条的计费方式及报价,请参见计费介绍

说明 下方调试接口为付费接口。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String SplitVideoParts

系统规定参数。取值:SplitVideoParts

VideoUrl String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ocr/xxxx.mp4

视频URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见生成URL

返回数据

名称 类型 示例值 描述
RequestId String A00A3C17-61D5-1489-860D-B709F83A7C40

请求ID。

Data Object

返回的结果数据内容。

Elements Array of elements
BeginTime Float 10.06

该片段的起始时刻,单位:秒。

EndTime Float 17.3

该片段的结束时刻,单位:秒。

Index Long 1

片段序号。

示例

请求示例

http(s)://[Endpoint]/?Action=SplitVideoParts
&VideoUrl=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ocr/xxxx.mp4
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SplitVideoPartsResponse>
    <RequestId>A00A3C17-61D5-1489-860D-B709F83A7C40</RequestId>
    <Data>
        <Elements>
            <BeginTime>10.06</BeginTime>
            <EndTime>17.3</EndTime>
            <Index>1</Index>
        </Elements>
    </Data>
</SplitVideoPartsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A00A3C17-61D5-1489-860D-B709F83A7C40",
  "Data" : {
    "Elements" : [ {
      "BeginTime" : 10.06,
      "EndTime" : 17.3,
      "Index" : 1
    } ]
  }
}

查询任务结果

该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见GetAsyncJobResult

错误码

关于视频拆条的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。