本文介绍视频内容理解UnderstandVideoContent的语法及示例。

功能描述

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

应用场景

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

特色优势

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

前提条件

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

输入限制

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
VideoURL String https://public-vigen-video.oss-cn-shanghai.aliyuncs.com/VideoIn/data/Labeling/reyun-test-online/x_v_0086320f42d2e7f1186248b237f93813.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]/?VideoURL=https://public-vigen-video.oss-cn-shanghai.aliyuncs.com/VideoIn/data/Labeling/reyun-test-online/x_v_0086320f42d2e7f1186248b237f93813.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小时后会被系统自动清理删除。