查询AI处理用量数据_用量数据_数据统计_服务端API

描述

查询AI处理（智能审核、视频DNA等）的用量数据。

注意：起始结束时间间隔在7天以内时，返回小时粒度的数据；大于7天时，返回天粒度的数据；最大间隔为31天。

请求参数

名称	类型	必填项	描述
Action	String	是	操作接口名。系统规定参数，取值：DescribeVodAIData
StartTime	String	是	获取数据起始时间点。日期格式按照ISO8601表示法，并使用UTC时间。格式为：YYYY-MM-DDThh:mm:ssZ
EndTime	String	是	获取数据结束时间点，需大于起始时间。日期格式按照ISO8601表示法，并使用UTC时间。格式为：YYYY-MM-DDThh:mm:ssZ
Region	String	否	存储区域，默认返回所有区域。支持批量查询，多个区域用逗号（半角）分隔。取值范围：cn-shanghai(上海)、cn-beijing(北京)、eu-central-1(德国)、ap-southeast-1(新加坡)
AIType	String	否	AI类型，默认返回类型。支持批量查询，多个区域用逗号（半角）分隔。取值范围：AIVideoCensor（智能审核）、AIVideoFPShot（视频DNA）、AIVideoTag（多模态标签）

返回参数

名称	类型	必填项	描述
RequestId	String	是	请求ID。
DataInterval	String	是	返回数据的时间颗粒度。取值范围：hour（小时数据），day（天数据）
AIData	AIDataItem	是	转码用量数据。

AIDataItem

字段名	类型	必填项	取值
TimeStamp	String	是	时间片起始时刻。
Data	DataItem	是	转码用量详细数据。

DataItem

字段名	类型	必填项	取值
Name	String	是	AI类型。取值范围：AIVideoCensor（智能审核）、AIVideoFPShot（视频DNA）、AIVideoTag（多模态标签）
Value	Long	是	处理时长，单位：秒

API示例

请求示例

http://vod.cn-shanghai.aliyuncs.com/?Action=DescribeVodAIData&StartTime=xxx&EndTime=xxx&Format=JSON&<公共参数>

注意：示例中的“公共参数”参见公共参数说明文档。

返回示例

{
  "RequestId": "C370DAF1-C838-4288-A1A0-9A87633D248E",
  "DataInterval": "day",
  "AIData": {
    "AIDataItem": [
      {
        "TimeStamp": "2019-02-01T16:00:00Z",
        "Data": {
          "DataItem": [
            {
              "Name": "AIVideoCensor",
              "Value": 111
            }
          ]
        }
      },
      {
        "TimeStamp": "2019-02-02T16:00:00Z",
        "Data": {
          "DataItem": [
            {
              "Name": "AIVideoCensor",
              "Value": 111
            },
            {
              "Name": "AIVideoFPShot",
              "Value": 222
            }
          ]
        }
      },
    ]
  }
}

错误码

错误代码	描述	Http状态码	语义
Throttling	Request was denied due to request throttling.	503	请求被流量控制限制
OperationDenied	Your account does not open VOD service yet.	403	未开通VOD服务
OperationDenied	Your VOD service is suspended.	403	VOD服务已被停止
InvalidParameter	Invalid Parameter.	400	参数错误
InvalidParameterAliUid	Invalid Parameter AliUid.	400	AliUid参数错误
InvalidParameterStartTime	Invalid Parameter StartTime.	400	StartTime参数错误
InvalidParameterEndTime	Invalid Parameter EndTime.	400	EndTime参数错误
InvalidTimeRange	StartTime and EndTime range should less than 1 month.	400	SndTime和StartTime差值不能超过31天
InvalidParameterRegion	Invalid Parameter Region.	400	Region参数错误