数据结构

最近更新时间:2021-01-22 08:00:42

我的收藏

Age

人体年龄信息。 AttributesType 不含 Age 或检测超过 5 个人体时,此参数仍返回,但不具备参考意义。

被如下接口引用:DetectBody。

名称 类型 描述
Type String 人体年龄信息,返回值为以下集合中的一个{小孩,青年,中年,老年}。
Probability Float Type识别概率值,[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。

AttributesOptions

返回人体属性选项,此值不填则为不需要返回,可以选择的值为以下六个。 Age、Bag、Gender、Orientation、UpperBodyCloth、LowerBodyCloth,详细的解释请看对象描述 需注意本接口最多返回面积最大的 5 个人体属性信息,超过 5 个人体(第 6 个及以后的人体)的人体属性不具备参考意义。

被如下接口引用:DetectBody。

名称 类型 必选 描述
Age Boolean 返回年龄信息
Bag Boolean 返回随身挎包信息
Gender Boolean 返回性别信息
Orientation Boolean 返回朝向信息
UpperBodyCloth Boolean 返回上装信息
LowerBodyCloth Boolean 返回下装信息

Bag

人体是否挎包。 AttributesType 不含 Bag 或检测超过 5 个人体时,此参数仍返回,但不具备参考意义。

被如下接口引用:DetectBody。

名称 类型 描述
Type String 挎包信息,返回值为以下集合中的一个{双肩包, 斜挎包, 手拎包, 无包}。
Probability Float Type识别概率值,[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。

BodyAttributeInfo

图中检测出的人体属性信息。

被如下接口引用:DetectBody。

名称 类型 描述
Age Age 人体年龄信息。
AttributesType 不含 Age 或检测超过 5 个人体时,此参数仍返回,但不具备参考意义。
注意:此字段可能返回 null,表示取不到有效值。
Bag Bag 人体是否挎包。
AttributesType 不含 Bag 或检测超过 5 个人体时,此参数仍返回,但不具备参考意义。
注意:此字段可能返回 null,表示取不到有效值。
Gender Gender 人体性别信息。
AttributesType 不含 Gender 或检测超过 5 个人体时,此参数仍返回,但不具备参考意义。
注意:此字段可能返回 null,表示取不到有效值。
Orientation Orientation 人体朝向信息。
AttributesType 不含 UpperBodyCloth 或检测超过 5 个人体时,此参数仍返回,但不具备参考意义。
注意:此字段可能返回 null,表示取不到有效值。
UpperBodyCloth UpperBodyCloth 人体上衣属性信息。
AttributesType 不含 Orientation 或检测超过 5 个人体时,此参数仍返回,但不具备参考意义。
注意:此字段可能返回 null,表示取不到有效值。
LowerBodyCloth LowerBodyCloth 人体下衣属性信息。
AttributesType 不含 LowerBodyCloth 或检测超过 5 个人体时,此参数仍返回,但不具备参考意义。
注意:此字段可能返回 null,表示取不到有效值。

BodyDetectResult

图中检测出来的人体框。

被如下接口引用:DetectBody。

名称 类型 描述
Confidence Float 检测出的人体置信度。
误识率百分之十对应的阈值是0.14;误识率百分之五对应的阈值是0.32;误识率百分之二对应的阈值是0.62;误识率百分之一对应的阈值是0.81。
通常情况建议使用阈值0.32,可适用大多数情况。
BodyRect BodyRect 图中检测出来的人体框
BodyAttributeInfo BodyAttributeInfo 图中检测出的人体属性信息。

BodyJointsResult

人体框和人体关键点信息。

被如下接口引用:DetectBodyJoints。

名称 类型 描述
BoundBox BoundRect 图中检测出来的人体框。
BodyJoints Array of KeyPointInfo 14个人体关键点的坐标,人体关键点详见KeyPointInfo。
Confidence Float 检测出的人体置信度,0-1之间,数值越高越准确。

BodyRect

人体框

被如下接口引用:CreatePerson, CreateTrace, DetectBody, SearchTrace。

名称 类型 必选 描述
X Integer 人体框左上角横坐标。
Y Integer 人体框左上角纵坐标。
Width Integer 人体宽度。
Height Integer 人体高度。

BoundRect

人体框

被如下接口引用:DetectBodyJoints。

名称 类型 描述
X Integer 人体框左上角横坐标。
Y Integer 人体框左上角纵坐标。
Width Integer 人体宽度。
Height Integer 人体高度。

Candidate

识别出的最相似候选人。

被如下接口引用:SearchTrace。

名称 类型 描述
PersonId String 人员ID。
TraceId String 人体轨迹ID。
Score Float 候选者的匹配得分。
十万人体库下,误识率百分之五对应的分数为70分;误识率百分之二对应的分数为80分;误识率百分之一对应的分数为90分。

二十万人体库下,误识率百分之五对应的分数为80分;误识率百分之二对应的分数为90分;误识率百分之一对应的分数为95分。

通常情况建议使用分数80分(保召回)。若希望获得较高精度,建议使用分数90分(保准确)。

Gender

人体性别信息。 AttributesType 不含 Gender 或检测超过 5 个人体时,此参数仍返回,但不具备参考意义。

被如下接口引用:DetectBody。

名称 类型 描述
Type String 性别信息,返回值为以下集合中的一个 {男性, 女性}
Probability Float Type识别概率值,[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。

GroupInfo

返回的人员库信息。

被如下接口引用:GetGroupList。

名称 类型 描述
GroupName String 人体库名称。
GroupId String 人体库ID。
Tag String 人体库信息备注。
BodyModelVersion String 人体识别所用的算法模型版本。
CreationTimestamp Integer Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 。

ImageRect

图像坐标信息。

被如下接口引用:SegmentCustomizedPortraitPic。

名称 类型 描述
X Integer 左上角横坐标。
Y Integer 左上角纵坐标。
Width Integer 人体宽度。
Height Integer 人体高度。
Label String 分割选项名称。

KeyPointInfo

人体关键点信息

被如下接口引用:DetectBodyJoints。

名称 类型 描述
KeyPointType String 代表不同位置的人体关键点信息,返回值为以下集合中的一个 [头部,颈部,右肩,右肘,右腕,左肩,左肘,左腕,右髋,右膝,右踝,左髋,左膝,左踝]
X Float 人体关键点横坐标
Y Float 人体关键点纵坐标

LowerBodyCloth

下衣属性信息

被如下接口引用:DetectBody。

名称 类型 描述
Color LowerBodyClothColor 下衣颜色信息。
Length LowerBodyClothLength 下衣长度信息 。
Type LowerBodyClothType 下衣类型信息。

LowerBodyClothColor

下衣颜色信息

被如下接口引用:DetectBody。

名称 类型 描述
Type String 下衣颜色信息,返回值为以下集合中的一个{ 黑色系, 灰白色系, 彩色} 。
Probability Float Type识别概率值,[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。

LowerBodyClothLength

下衣长度信息

被如下接口引用:DetectBody。

名称 类型 描述
Type String 下衣长度信息,返回值为以下集合中的一个,{长, 短} 。
Probability Float Type识别概率值,[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。

LowerBodyClothType

下衣类型信息

被如下接口引用:DetectBody。

名称 类型 描述
Type String 下衣类型,返回值为以下集合中的一个 {裤子,裙子} 。
Probability Float Type识别概率值,[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。

Orientation

人体朝向信息。
AttributesType 不含 Orientation 或检测超过 5 个人体时,此参数仍返回,但不具备参考意义。

被如下接口引用:DetectBody。

名称 类型 描述
Type String 人体朝向信息,返回值为以下集合中的一个 {正向, 背向, 左, 右}。
Probability Float Type识别概率值,[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。

PersonInfo

人员信息。

被如下接口引用:GetPersonList。

名称 类型 描述
PersonName String 人员名称。
PersonId String 人员ID。
TraceInfos Array of TraceInfo 包含的人体轨迹图片信息列表。

SegmentationOptions

此参数为分割选项,请根据需要选择自己所想从图片中分割的部分。注意所有选项均为非必选,如未选择则值默认为false, 但是必须要保证多于一个选项的描述为true。

被如下接口引用:SegmentCustomizedPortraitPic。

名称 类型 必选 描述
Background Boolean 分割选项-背景
Hair Boolean 分割选项-头发
LeftEyebrow Boolean 分割选项-左眉
RightEyebrow Boolean 分割选项-右眉
LeftEye Boolean 分割选项-左眼
RightEye Boolean 分割选项-右眼
Nose Boolean 分割选项-鼻子
UpperLip Boolean 分割选项-上唇
LowerLip Boolean 分割选项-下唇
Tooth Boolean 分割选项-牙齿
Mouth Boolean 分割选项-口腔(不包含牙齿)
LeftEar Boolean 分割选项-左耳
RightEar Boolean 分割选项-右耳
Face Boolean 分割选项-面部(不包含眼、耳、口、鼻等五官及头发。)
Head Boolean 复合分割选项-头部(包含所有的头部元素,相关装饰除外)
Body Boolean 分割选项-身体(包含脖子)
Hat Boolean 分割选项-帽子
Headdress Boolean 分割选项-头饰
Earrings Boolean 分割选项-耳环
Necklace Boolean 分割选项-项链
Belongings Boolean 分割选项-随身物品( 例如伞、包、手机等。 )

Trace

人体轨迹信息

被如下接口引用:CreatePerson, CreateTrace, SearchTrace。

名称 类型 必选 描述
Images Array of String 人体轨迹图片 Base64 数组。
数组长度最小为1最大为5。
单个图片 base64 编码后大小不可超过2M。
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
Urls Array of String 人体轨迹图片 Url 数组。
数组长度最小为1最大为5。
单个图片 base64 编码后大小不可超过2M。
Urls、Images必须提供一个,如果都提供,只使用 Urls。
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
非腾讯云存储的Url速度和稳定性可能受一定影响。
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
BodyRects Array of BodyRect 若输入的Images 和 Urls 是已经裁剪后的人体小图,则可以忽略本参数。
若否,或图片中包含多个人体,则需要通过本参数来指定图片中的人体框。
顺序对应 Images 或 Urls 中的顺序。
当不输入本参数时,我们将认为输入图片已是经过裁剪后的人体小图,不会进行人体检测而直接进行特征提取处理。

TraceInfo

人体轨迹信息。

被如下接口引用:GetPersonList。

名称 类型 描述
TraceId String 人体轨迹ID。
BodyIds Array of String 包含的人体轨迹图片Id列表。

UpperBodyCloth

上衣属性信息

被如下接口引用:DetectBody。

名称 类型 描述
Texture UpperBodyClothTexture 上衣纹理信息。
Color UpperBodyClothColor 上衣颜色信息。
Sleeve UpperBodyClothSleeve 上衣衣袖信息。

UpperBodyClothColor

上衣颜色信息。

被如下接口引用:DetectBody。

名称 类型 描述
Type String 上衣颜色信息,返回值为以下集合中的一个 {红色系, 黄色系, 绿色系, 蓝色系, 黑色系, 灰白色系。
Probability Float Type识别概率值,[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。

UpperBodyClothSleeve

上衣衣袖信息。

被如下接口引用:DetectBody。

名称 类型 描述
Type String 上衣衣袖信息, 返回值为以下集合中的一个 {长袖, 短袖}。
Probability Float Type识别概率值,[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。

UpperBodyClothTexture

上衣纹理信息。

被如下接口引用:DetectBody。

名称 类型 描述
Type String 上衣纹理信息,返回值为以下集合中的一个, {纯色, 格子, 大色块}。
Probability Float Type识别概率值,[0.0,1.0], 代表判断正确的概率。如0.8则代表有Type值有80%概率正确。

VideoBasicInformation

视频基础信息

被如下接口引用:DescribeSegmentationTask。

名称 类型 描述
FrameWidth Integer 视频宽度
FrameHeight Integer 视频高度
FramesPerSecond Integer 视频帧速率(FPS)
Duration Float 视频时长
TotalFrames Integer 视频帧数
目录