数据结构

最近更新时间:2023-08-17 01:19:38

我的收藏

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。
示例值:xxxxx
TraceId String 人体动作轨迹ID。
示例值:xxxxx
Score Float 候选者的匹配得分。
十万人体库下,误识率百分之五对应的分数为70分;误识率百分之二对应的分数为80分;误识率百分之一对应的分数为90分。

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

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

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 人体关键点横坐标
示例值:0
Y Float 人体关键点纵坐标
示例值:0
BodyScore Float 关键点坐标置信度,分数取值在0-1之间,阈值建议为0.25,小于0.25认为在图中无人体关键点。
示例值:0

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 人员名称。
示例值:xxxxx
PersonId String 人员ID。
示例值:xxxxx
TraceInfos Array of TraceInfo 包含的人体动作轨迹图片信息列表。
示例值:xxxxx

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

TraceInfo

人体动作轨迹信息。

被如下接口引用:GetPersonList。

名称 类型 描述
TraceId String 人体动作轨迹ID。
示例值:xxxxx
BodyIds Array of String 包含的人体动作轨迹图片Id列表。
示例值:xxxxx

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 视频帧数