UnderstandVideoContent
视频内容理解UnderstandVideoContent的语法及示例
服务地址：
华东2（上海）
输入参数
只看必填
VideoURL视频URL地址
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

功能描述

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

说明
  • 您可以进入在线咨询获取在线人工帮助。
    •
    • 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击立即试用对该能力进行更直观试用以及在线购买。
    • 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。

    应用场景

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

    特色优势

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

    接入指引

    1. 注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。

    2. 开通能力：

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

    3. 创建 AccessKey：请确保您已创建 AccessKey，如果您使用的是子账号 AccessKey，您需要给子账号赋予 AliyunVIAPIFullAccess 权限，具体操作，请参见 RAM 授权。

    4. 在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及 SDK 依赖信息，也可以下载完整的工程。

    5. 开发接入步骤：

    • 在 SDK 总览中选择您要接入使用的 SDK 语言。
    • 在对应语言的 SDK 文档中找到 AI 类目为视频理解（videorecog）类目的 SDK 包进行安装。
    • 参考文档中提供的示例代码进行适当修改后调用。

    1. 示例代码：该能力常用语言的示例代码，请参见视频内容理解示例代码，常用语言查询异步任务结果的示例代码，请参见查询异步任务结果示例代码。

    2. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。

    输入限制

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

    计费说明

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

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

    调用步骤

    该能力为异步能力，需分两步进行调用。 第一步调用 UnderstandVideoContent 接口提交任务，请求成功后，得到一个任务 ID。 第二步调用 GetAsyncJobResult 接口查询结果，根据任务 ID 查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。

    请求参数

    字段名称字段详情
    VideoURLstring

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

    示例值:http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videorecog/UnderstandVideoContent/UnderstandVideoContent1.mp4

    返回参数

    字段名称字段详情
    RequestIdstring

    请求 ID。

    示例值:71EC3F13-F0CA-4558-AC7F-A351106F59F2
    Dataobject

    返回的结果数据内容。展开详情

    Messagestring

    提交异步任务后的提示信息。

    示例值:该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。

    返回说明

    TagInfo 字段参数说明

    TagInfo 字段参数下会输出 sceneInfo（场景）和 humanInfo（人），对应场景包含字段参数请参见下表。

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

    Category 标签取值

    查询结果

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

    SDK 参考

    阿里云视觉 AI 视频理解类目下的视频内容理解能力推荐使用 SDK 调用，支持多种编程语言，调用时请选择 AI 类目为视频理解（videorecog）的 SDK 包，文件参数通过 SDK 调用可支持本地文件及任意 URL，具体可参见 SDK 总览。

    示例代码

    该能力常用语言的示例代码，请参见视频内容理解示例代码，常用语言查询异步任务结果的示例代码，请参见查询异步任务结果示例代码。

    变更历史
    变更时间变更内容概要操作
    2022-10-17
    变更返回参数