调用GetAIVideoTagResult获取智能标签结果。

使用说明

通过视频ID获取智能标签结果。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

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

系统规定参数。取值:GetAIVideoTagResult

MediaId String 595d020bad37421f37433451720****

媒资ID,即视频ID。可通过以下方式获取:

  • 通过控制台上传的视频,可登录点播控制台,选择媒资库 > 音/视频查看视频ID。
  • 通过获取视频上传地址和凭证接口获取上传地址和凭证时,视频ID为返回参数VideoId的值。
  • 视频上传后,可通过搜索媒体信息接口查询视频ID,为请求后返回参数VideoId的值。

返回数据

名称 类型 示例值 描述
RequestId String 8829B4DB-AFD9-4FF6-12965DBFFA14****

请求ID。

VideoTagResult Object

结果数据。

Category Array of Category

视频分类的集合。

Tag String 美容

标签。

Person Array of Person

人物标签的集合。

FaceUrl String http://example.com/aivideotag/8829B4DB-AFD9-4F*****F6-12965DBFFA14/Index_****.jpg

人脸URL。

说明 只有人物标签结果会返回该字段。
Tag String 小王

标签。

Times Array of String ["10760"]

时间点的集合。单位:毫秒。

Time Array of Time

时间标签的集合。

Tag String 毫秒

标签。

Times Array of String ["3260","4000","5000","8410","12000","13000","14000"]

时间点的集合。单位:毫秒。

Location Array of Location

地点标签的集合。

Tag String 亚洲

标签。

Times Array of String ["8410"]

时间点的集合。单位:毫秒。

Keyword Array of Keyword

关键词标签的集合。

Tag String 气垫

标签。

Times Array of String ["3260","4000","5000","8410","12000","13000","14000"]

时间点的集合。单位:毫秒。

示例

请求示例

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=GetAIVideoTagResult
&MediaId=595d020bad37421f37433451720****
&<公共请求参数>

正常返回示例

XML格式

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

<GetAIVideoTagResultResponse>
    <RequestId>8829B4DB-AFD9-4FF6-12965DBFFA14****</RequestId>
    <VideoTagResult>
        <Category>
            <Tag>美容</Tag>
        </Category>
        <Person>
            <FaceUrl>http://example.com/aivideotag/8829B4DB-AFD9-4F*****F6-12965DBFFA14/Index_****.jpg</FaceUrl>
            <Tag>小王</Tag>
            <Times>["10760"]</Times>
        </Person>
        <Time>
            <Tag>毫秒</Tag>
            <Times>["3260","4000","5000","8410","12000","13000","14000"]</Times>
        </Time>
        <Location>
            <Tag>亚洲</Tag>
            <Times>["8410"]</Times>
        </Location>
        <Keyword>
            <Tag>气垫</Tag>
            <Times>["3260","4000","5000","8410","12000","13000","14000"]</Times>
        </Keyword>
    </VideoTagResult>
</GetAIVideoTagResultResponse>

JSON格式

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

{
  "RequestId" : "8829B4DB-AFD9-4FF6-12965DBFFA14****",
  "VideoTagResult" : {
    "Category" : [ {
      "Tag" : "美容"
    } ],
    "Person" : [ {
      "FaceUrl" : "http://example.com/aivideotag/8829B4DB-AFD9-4F*****F6-12965DBFFA14/Index_****.jpg",
      "Tag" : "小王",
      "Times" : [ "[\"10760\"]" ]
    } ],
    "Time" : [ {
      "Tag" : "毫秒",
      "Times" : [ "[\"3260\",\"4000\",\"5000\",\"8410\",\"12000\",\"13000\",\"14000\"]" ]
    } ],
    "Location" : [ {
      "Tag" : "亚洲",
      "Times" : [ "[\"8410\"]" ]
    } ],
    "Keyword" : [ {
      "Tag" : "气垫",
      "Times" : [ "[\"3260\",\"4000\",\"5000\",\"8410\",\"12000\",\"13000\",\"14000\"]" ]
    } ]
  }
}

错误码

访问错误中心查看更多错误码。

SDK示例

建议使用服务端SDK来调用API,此API各语言调用的示例代码,请参见: