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