视频内容理解 - 阿里云视觉智能开放平台

功能描述

视频内容理解能力可以分析出视频中的明星、素人、游戏画面等各种元素。

应用场景

互联网广告分析：可分析互联网广告的内容和效果之间的关系，帮助客户更高的提升广告效果。

特色优势

支持分析各种复杂场景。如夹杂明星、素人等场景。

前提条件

视频内容理解支持上海和呼和浩特地域（Region），默认不显示呼和浩特地域，如果您想使用呼和浩特地域，请添加钉钉群（23109592）联系技术支持开通呼和浩特白名单。
请确保您已开通视频理解服务，若未开通服务请立即开通。

输入限制

视频格式：MP4、AVI、FLV、MOV。
视频大小：不超过1 GB。
视频时长限制：时长不超过5分钟，超过时只返回前5分钟的分析结果。
URL地址中不能包含中文字符。

计费说明

关于视频内容理解的计费方式及报价，请参见计费介绍。

说明下方调试接口为付费接口，如需免费体验调试请前往体验中心。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	UnderstandVideoContent	要执行的操作。取值：UnderstandVideoContent。
VideoURL	String	是	http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videorecog/UnderstandVideoContent/UnderstandVideoContent1.mp4	视频URL地址。当前仅支持上海和呼和浩特地域的OSS链接，如何生成URL请参见生成URL。

返回数据


名称	类型	示例值	描述
RequestId	String	71EC3F13-F0CA-4558-AC7F-A351106F59F2	请求ID。
Data	Object		返回的结果数据内容。
TagInfo	Map		标签。目前仅输出`scene`（场景）和`human`（人）。
VideoInfo	Object		视频信息。
Width	Long	720	视频的宽度。单位：像素。
Height	Long	1280	视频的高。单位：像素。
Duration	Long	43380	视频的时长。单位：秒。
Fps	Float	25.0	视频的帧率。单位：帧。

TagInfo字段参数说明


字段	类型	是否必须	示例值	描述
TimeRange	list	是	[[0,0.1],[0.3,1.0]]	表示视频中的元素出现的时间相对位置。例如整段视频时长为20秒，[[0,0.1],[0.3,1.0]]则表示该元素在整段视频中出现了2次，第一次出现的时间段为0~2秒，第二次出现的时间段为6~20秒。
TimeProportion	float	是	80	表示视频中的元素出现的时长占比，输出80则表示该元素在整段视频出现的时间占总时长的80%。取值范围 [0,100.0]
Number	int	是	1	如果为HumanInfo字段时，当识别为非明星时表示出现的人物数量，被识别为明星时显示为1。如果为非HumanInfo字段时，可忽略此字段。
Category	string	是	human-real-celebrity-古天乐	标签名称。具体分类如下图所示。

Category标签取值

示例

请求示例

http(s)://[Endpoint]/?Action=UnderstandVideoContent
&VideoURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videorecog/UnderstandVideoContent/UnderstandVideoContent1.mp4
&公共请求参数

正常返回示例

XML格式

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

<RequestId>71EC3F13-F0CA-4558-AC7F-A351106F59F2</RequestId>
<Data>
    <TagInfo>
        <HumanInfo>
            <TimeRange>
                <0>0</0>
                <1>0.045454545454545456</1>
            </TimeRange>
            <TimeRange>
                <0>0.06818181818181818</0>
                <1>0.11363636363636363</1>
            </TimeRange>
            <TimeRange>
                <0>0.13636363636363635</0>
                <1>0.5</1>
            </TimeRange>
            <TimeRange>
                <0>0.5681818181818182</0>
                <1>0.6590909090909091</1>
            </TimeRange>
            <TimeProportion>54.54545454545455</TimeProportion>
            <Number>2</Number>
            <Category>human-real-normal</Category>
        </HumanInfo>
        <HumanInfo>
            <TimeRange>
                <0>0.045454545454545456</0>
                <1>0.06818181818181818</1>
            </TimeRange>
            <TimeRange>
                <0>0.5</0>
                <1>0.5227272727272727</1>
            </TimeRange>
            <TimeRange>
                <0>0.7045454545454546</0>
                <1>0.75</1>
            </TimeRange>
            <TimeRange>
                <0>0.8409090909090909</0>
                <1>0.9545454545454546</1>
            </TimeRange>
            <TimeProportion>20.454545454545453</TimeProportion>
            <Number>1</Number>
            <Category>human-cartoon</Category>
        </HumanInfo>
        <SceneInfo>
            <TimeRange>
                <0>0.045454545454545456</0>
                <1>0.06818181818181818</1>
            </TimeRange>
            <TimeRange>
                <0>0.5</0>
                <1>0.5227272727272727</1>
            </TimeRange>
            <TimeRange>
                <0>0.6590909090909091</0>
                <1>0.75</1>
            </TimeRange>
            <TimeRange>
                <0>0.8636363636363636</0>
                <1>0.9545454545454546</1>
            </TimeRange>
            <TimeProportion>22.727272727272727</TimeProportion>
            <Number>1</Number>
            <Category>gamescreen-attribute</Category>
        </SceneInfo>
        <SceneInfo>
            <TimeRange>
                <0>0</0>
                <1>0.045454545454545456</1>
            </TimeRange>
            <TimeRange>
                <0>0.09090909090909091</0>
                <1>0.11363636363636363</1>
            </TimeRange>
            <TimeRange>
                <0>0.13636363636363635</0>
                <1>0.1590909090909091</1>
            </TimeRange>
            <TimeRange>
                <0>0.18181818181818182</0>
                <1>0.5</1>
            </TimeRange>
            <TimeRange>
                <0>0.5681818181818182</0>
                <1>0.6590909090909091</1>
            </TimeRange>
            <TimeProportion>50</TimeProportion>
            <Number>1</Number>
            <Category>liveaction</Category>
        </SceneInfo>
    </TagInfo>
    <VideoInfo>
        <Width>720</Width>
        <Height>1280</Height>
        <Duration>43380</Duration>
        <Fps>25</Fps>
    </VideoInfo>
</Data>

JSON格式

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

{
  "RequestId" : "71EC3F13-F0CA-4558-AC7F-A351106F59F2",
  "Data" : {
    "TagInfo" : {
      "HumanInfo" : [ {
        "TimeRange" : [ [ 0, 0.045454545454545456 ], [ 0.06818181818181818, 0.11363636363636363 ], [ 0.13636363636363635, 0.5 ], [ 0.5681818181818182, 0.6590909090909091 ] ],
        "TimeProportion" : 54.54545454545455,
        "Number" : 2,
        "Category" : "human-real-normal"
      }, {
        "TimeRange" : [ [ 0.045454545454545456, 0.06818181818181818 ], [ 0.5, 0.5227272727272727 ], [ 0.7045454545454546, 0.75 ], [ 0.8409090909090909, 0.9545454545454546 ] ],
        "TimeProportion" : 20.454545454545453,
        "Number" : 1,
        "Category" : "human-cartoon"
      } ],
      "SceneInfo" : [ {
        "TimeRange" : [ [ 0.045454545454545456, 0.06818181818181818 ], [ 0.5, 0.5227272727272727 ], [ 0.6590909090909091, 0.75 ], [ 0.8636363636363636, 0.9545454545454546 ] ],
        "TimeProportion" : 22.727272727272727,
        "Number" : 1,
        "Category" : "gamescreen-attribute"
      }, {
        "TimeRange" : [ [ 0, 0.045454545454545456 ], [ 0.09090909090909091, 0.11363636363636363 ], [ 0.13636363636363635, 0.1590909090909091 ], [ 0.18181818181818182, 0.5 ], [ 0.5681818181818182, 0.6590909090909091 ] ],
        "TimeProportion" : 50.0,
        "Number" : 1,
        "Category" : "liveaction"
      } ]
    },
    "VideoInfo" : {
      "Width" : 720,
      "Height" : 1280,
      "Duration" : 43380,
      "Fps" : 25.0
    }
  }
}

查询任务结果

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

错误码

关于视频内容理解的错误码，详情请参见常见错误码。

SDK参考

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

安全声明

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