v20200324

type Age struct {

	// 人体年龄信息，返回值为以下集合中的一个{小孩,青年,中年,老年}。
	Type *string `json:"Type,omitempty" name:"Type"`

	// Type识别概率值，[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。
	Probability *float64 `json:"Probability,omitempty" name:"Probability"`
}

type AttributesOptions struct {

	// 返回年龄信息
	Age *bool `json:"Age,omitempty" name:"Age"`

	// 返回随身挎包信息
	Bag *bool `json:"Bag,omitempty" name:"Bag"`

	// 返回性别信息
	Gender *bool `json:"Gender,omitempty" name:"Gender"`

	// 返回朝向信息
	Orientation *bool `json:"Orientation,omitempty" name:"Orientation"`

	// 返回上装信息
	UpperBodyCloth *bool `json:"UpperBodyCloth,omitempty" name:"UpperBodyCloth"`

	// 返回下装信息
	LowerBodyCloth *bool `json:"LowerBodyCloth,omitempty" name:"LowerBodyCloth"`
}

type Bag struct {

	// 挎包信息，返回值为以下集合中的一个{双肩包, 斜挎包, 手拎包, 无包}。
	Type *string `json:"Type,omitempty" name:"Type"`

	// Type识别概率值，[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。
	Probability *float64 `json:"Probability,omitempty" name:"Probability"`
}

type BodyAttributeInfo struct {

	// 人体年龄信息。
	// AttributesType 不含 Age 或检测超过 5 个人体时，此参数仍返回，但不具备参考意义。
	// 注意：此字段可能返回 null，表示取不到有效值。
	Age *Age `json:"Age,omitempty" name:"Age"`

	// 人体是否挎包。
	// AttributesType 不含 Bag 或检测超过 5 个人体时，此参数仍返回，但不具备参考意义。
	// 注意：此字段可能返回 null，表示取不到有效值。
	Bag *Bag `json:"Bag,omitempty" name:"Bag"`

	// 人体性别信息。
	// AttributesType 不含 Gender 或检测超过 5 个人体时，此参数仍返回，但不具备参考意义。
	// 注意：此字段可能返回 null，表示取不到有效值。
	Gender *Gender `json:"Gender,omitempty" name:"Gender"`

	// 人体朝向信息。
	// AttributesType 不含 UpperBodyCloth 或检测超过 5 个人体时，此参数仍返回，但不具备参考意义。
	// 注意：此字段可能返回 null，表示取不到有效值。
	Orientation *Orientation `json:"Orientation,omitempty" name:"Orientation"`

	// 人体上衣属性信息。
	// AttributesType 不含 Orientation 或检测超过 5 个人体时，此参数仍返回，但不具备参考意义。
	// 注意：此字段可能返回 null，表示取不到有效值。
	UpperBodyCloth *UpperBodyCloth `json:"UpperBodyCloth,omitempty" name:"UpperBodyCloth"`

	// 人体下衣属性信息。
	// AttributesType 不含 LowerBodyCloth 或检测超过 5 个人体时，此参数仍返回，但不具备参考意义。
	// 注意：此字段可能返回 null，表示取不到有效值。
	LowerBodyCloth *LowerBodyCloth `json:"LowerBodyCloth,omitempty" name:"LowerBodyCloth"`
}

type BodyDetectResult struct {

	// 检测出的人体置信度。
	// 误识率百分之十对应的阈值是0.14；误识率百分之五对应的阈值是0.32；误识率百分之二对应的阈值是0.62；误识率百分之一对应的阈值是0.81。
	// 通常情况建议使用阈值0.32，可适用大多数情况。
	Confidence *float64 `json:"Confidence,omitempty" name:"Confidence"`

	// 图中检测出来的人体框
	BodyRect *BodyRect `json:"BodyRect,omitempty" name:"BodyRect"`

	// 图中检测出的人体属性信息。
	BodyAttributeInfo *BodyAttributeInfo `json:"BodyAttributeInfo,omitempty" name:"BodyAttributeInfo"`
}

type BodyJointsResult struct {

	// 图中检测出来的人体框。
	BoundBox *BoundRect `json:"BoundBox,omitempty" name:"BoundBox"`

	// 14个人体关键点的坐标，人体关键点详见KeyPointInfo。
	BodyJoints []*KeyPointInfo `json:"BodyJoints,omitempty" name:"BodyJoints" list`

	// 检测出的人体置信度，0-1之间，数值越高越准确。
	Confidence *float64 `json:"Confidence,omitempty" name:"Confidence"`
}

type BodyRect struct {

	// 人体框左上角横坐标。
	X *uint64 `json:"X,omitempty" name:"X"`

	// 人体框左上角纵坐标。
	Y *uint64 `json:"Y,omitempty" name:"Y"`

	// 人体宽度。
	Width *uint64 `json:"Width,omitempty" name:"Width"`

	// 人体高度。
	Height *uint64 `json:"Height,omitempty" name:"Height"`
}

type BoundRect struct {

	// 人体框左上角横坐标。
	X *int64 `json:"X,omitempty" name:"X"`

	// 人体框左上角纵坐标。
	Y *int64 `json:"Y,omitempty" name:"Y"`

	// 人体宽度。
	Width *int64 `json:"Width,omitempty" name:"Width"`

	// 人体高度。
	Height *int64 `json:"Height,omitempty" name:"Height"`
}

type Candidate struct {

	// 人员ID。
	PersonId *string `json:"PersonId,omitempty" name:"PersonId"`

	// 人体轨迹ID。
	TraceId *string `json:"TraceId,omitempty" name:"TraceId"`

	// 候选者的匹配得分。
	// 十万人体库下，误识率百分之五对应的分数为70分；误识率百分之二对应的分数为80分；误识率百分之一对应的分数为90分。
	//
	// 二十万人体库下，误识率百分之五对应的分数为80分；误识率百分之二对应的分数为90分；误识率百分之一对应的分数为95分。
	//
	// 通常情况建议使用分数80分（保召回）。若希望获得较高精度，建议使用分数90分（保准确）。
	Score *float64 `json:"Score,omitempty" name:"Score"`
}

type Client struct {
	common.Client
}

type CreateGroupRequest struct {
	*tchttp.BaseRequest

	// 人体库名称，[1,60]个字符，可修改，不可重复。
	GroupName *string `json:"GroupName,omitempty" name:"GroupName"`

	// 人体库 ID，不可修改，不可重复。支持英文、数字、-%@#&_，长度限制64B。
	GroupId *string `json:"GroupId,omitempty" name:"GroupId"`

	// 人体库信息备注，[0，40]个字符。
	Tag *string `json:"Tag,omitempty" name:"Tag"`

	// 人体识别所用的算法模型版本。
	// 目前入参仅支持 “1.0”1个输入。 默认为"1.0"。
	// 不同算法模型版本对应的人体识别算法不同，新版本的整体效果会优于旧版本，后续我们将推出更新版本。
	BodyModelVersion *string `json:"BodyModelVersion,omitempty" name:"BodyModelVersion"`
}

type CreateGroupResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type CreatePersonRequest struct {
	*tchttp.BaseRequest

	// 待加入的人员库ID。
	GroupId *string `json:"GroupId,omitempty" name:"GroupId"`

	// 人员名称。[1，60]个字符，可修改，可重复。
	PersonName *string `json:"PersonName,omitempty" name:"PersonName"`

	// 人员ID，单个腾讯云账号下不可修改，不可重复。
	// 支持英文、数字、-%@#&_，，长度限制64B。
	PersonId *string `json:"PersonId,omitempty" name:"PersonId"`

	// 人体轨迹信息。
	Trace *Trace `json:"Trace,omitempty" name:"Trace"`
}

type CreatePersonResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 人员轨迹唯一标识。
		TraceId *string `json:"TraceId,omitempty" name:"TraceId"`

		// 人体识别所用的算法模型版本。
		BodyModelVersion *string `json:"BodyModelVersion,omitempty" name:"BodyModelVersion"`

		// 输入的人体轨迹图片中的合法性校验结果。
		// 只有为0时结果才有意义。
		// -1001: 输入图片不合法。-1002: 输入图片不能构成轨迹。
		InputRetCode *int64 `json:"InputRetCode,omitempty" name:"InputRetCode"`

		// 输入的人体轨迹图片中的合法性校验结果详情。
		// -1101:图片无效，-1102:url不合法。-1103:图片过大。-1104:图片下载失败。-1105:图片解码失败。-1109:图片分辨率过高。-2023:轨迹中有非同人图片。-2024: 轨迹提取失败。-2025: 人体检测失败。
		// RetCode 的顺序和入参中Images 或 Urls 的顺序一致。
		InputRetCodeDetails []*int64 `json:"InputRetCodeDetails,omitempty" name:"InputRetCodeDetails" list`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type CreateSegmentationTaskRequest struct {
	*tchttp.BaseRequest

	// 需要分割的视频URL，可外网访问。
	VideoUrl *string `json:"VideoUrl,omitempty" name:"VideoUrl"`

	// 背景图片URL。
	// 可以将视频背景替换为输入的图片。
	// 如果不输入背景图片，则输出人像区域mask。
	BackgroundImageUrl *string `json:"BackgroundImageUrl,omitempty" name:"BackgroundImageUrl"`

	// 预留字段，后期用于展示更多识别信息。
	Config *string `json:"Config,omitempty" name:"Config"`
}

type CreateSegmentationTaskResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 任务标识ID,可以用与追溯任务状态，查看任务结果
		TaskID *string `json:"TaskID,omitempty" name:"TaskID"`

		// 预估处理时间，单位为秒
		EstimatedProcessingTime *float64 `json:"EstimatedProcessingTime,omitempty" name:"EstimatedProcessingTime"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type CreateTraceRequest struct {
	*tchttp.BaseRequest

	// 人员ID。
	PersonId *string `json:"PersonId,omitempty" name:"PersonId"`

	// 人体轨迹信息。
	Trace *Trace `json:"Trace,omitempty" name:"Trace"`
}

type CreateTraceResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 人员轨迹唯一标识。
		TraceId *string `json:"TraceId,omitempty" name:"TraceId"`

		// 人体识别所用的算法模型版本。
		BodyModelVersion *string `json:"BodyModelVersion,omitempty" name:"BodyModelVersion"`

		// 输入的人体轨迹图片中的合法性校验结果。
		// 只有为0时结果才有意义。
		// -1001: 输入图片不合法。-1002: 输入图片不能构成轨迹。
		InputRetCode *int64 `json:"InputRetCode,omitempty" name:"InputRetCode"`

		// 输入的人体轨迹图片中的合法性校验结果详情。
		// -1101:图片无效，-1102:url不合法。-1103:图片过大。-1104:图片下载失败。-1105:图片解码失败。-1109:图片分辨率过高。-2023:轨迹中有非同人图片。-2024: 轨迹提取失败。-2025: 人体检测失败。
		InputRetCodeDetails []*int64 `json:"InputRetCodeDetails,omitempty" name:"InputRetCodeDetails" list`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type DeleteGroupRequest struct {
	*tchttp.BaseRequest

	// 人体库ID。
	GroupId *string `json:"GroupId,omitempty" name:"GroupId"`
}

type DeleteGroupResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type DeletePersonRequest struct {
	*tchttp.BaseRequest

	// 人员ID。
	PersonId *string `json:"PersonId,omitempty" name:"PersonId"`
}

type DeletePersonResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type DescribeSegmentationTaskRequest struct {
	*tchttp.BaseRequest

	// 在提交分割任务成功时返回的任务标识ID。
	TaskID *string `json:"TaskID,omitempty" name:"TaskID"`
}

type DescribeSegmentationTaskResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 当前任务状态：
		// QUEUING 排队中
		// PROCESSING 处理中
		// FINISHED 处理完成
		TaskStatus *string `json:"TaskStatus,omitempty" name:"TaskStatus"`

		// 分割后视频URL, 存储于腾讯云COS
		// 注意：此字段可能返回 null，表示取不到有效值。
		ResultVideoUrl *string `json:"ResultVideoUrl,omitempty" name:"ResultVideoUrl"`

		// 分割后视频MD5，用于校验
		// 注意：此字段可能返回 null，表示取不到有效值。
		ResultVideoMD5 *string `json:"ResultVideoMD5,omitempty" name:"ResultVideoMD5"`

		// 视频基本信息
		// 注意：此字段可能返回 null，表示取不到有效值。
		VideoBasicInformation *VideoBasicInformation `json:"VideoBasicInformation,omitempty" name:"VideoBasicInformation"`

		// 分割任务错误信息
		// 注意：此字段可能返回 null，表示取不到有效值。
		ErrorMsg *string `json:"ErrorMsg,omitempty" name:"ErrorMsg"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type DetectBodyJointsRequest struct {
	*tchttp.BaseRequest

	// 图片 base64 数据，base64 编码后大小不可超过5M。
	// 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
	Image *string `json:"Image,omitempty" name:"Image"`

	// 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
	// Url、Image必须提供一个，如果都提供，只使用 Url。
	// 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
	// 非腾讯云存储的Url速度和稳定性可能受一定影响。
	// 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
	Url *string `json:"Url,omitempty" name:"Url"`
}

type DetectBodyJointsResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 图中检测出的人体框和人体关键点， 包含14个人体关键点的坐标，建议根据人体框置信度筛选出合格的人体；
		BodyJointsResults []*BodyJointsResult `json:"BodyJointsResults,omitempty" name:"BodyJointsResults" list`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type DetectBodyRequest struct {
	*tchttp.BaseRequest

	// 人体图片 Base64 数据。
	// 图片 base64 编码后大小不可超过5M。
	// 图片分辨率不得超过 1920 * 1080 。
	// 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
	Image *string `json:"Image,omitempty" name:"Image"`

	// 最多检测的人体数目，默认值为1（仅检测图片中面积最大的那个人体）； 最大值10 ，检测图片中面积最大的10个人体。
	MaxBodyNum *uint64 `json:"MaxBodyNum,omitempty" name:"MaxBodyNum"`

	// 人体图片 Url 。
	// Url、Image必须提供一个，如果都提供，只使用 Url。
	// 图片 base64 编码后大小不可超过5M。
	// 图片分辨率不得超过 1920 * 1080 。
	// 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
	// 非腾讯云存储的Url速度和稳定性可能受一定影响。
	// 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
	Url *string `json:"Url,omitempty" name:"Url"`

	// 是否返回年龄、性别、朝向等属性。
	// 可选项有 Age、Bag、Gender、UpperBodyCloth、LowerBodyCloth、Orientation。
	// 如果此参数为空则为不需要返回。
	// 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。
	// 关于各属性的详细描述，参见下文出参。
	// 最多返回面积最大的 5 个人体属性信息，超过 5 个人体（第 6 个及以后的人体）的 BodyAttributesInfo 不具备参考意义。
	AttributesOptions *AttributesOptions `json:"AttributesOptions,omitempty" name:"AttributesOptions"`
}

type DetectBodyResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 图中检测出来的人体框。
		BodyDetectResults []*BodyDetectResult `json:"BodyDetectResults,omitempty" name:"BodyDetectResults" list`

		// 人体识别所用的算法模型版本。
		BodyModelVersion *string `json:"BodyModelVersion,omitempty" name:"BodyModelVersion"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type Gender struct {

	// 性别信息，返回值为以下集合中的一个 {男性, 女性}
	Type *string `json:"Type,omitempty" name:"Type"`

	// Type识别概率值，[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。
	Probability *float64 `json:"Probability,omitempty" name:"Probability"`
}

type GetGroupListRequest struct {
	*tchttp.BaseRequest

	// 起始序号，默认值为0。
	Offset *uint64 `json:"Offset,omitempty" name:"Offset"`

	// 返回数量，默认值为10，最大值为1000。
	Limit *uint64 `json:"Limit,omitempty" name:"Limit"`
}

type GetGroupListResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 返回的人体库信息。
		GroupInfos []*GroupInfo `json:"GroupInfos,omitempty" name:"GroupInfos" list`

		// 人体库总数量。
		GroupNum *uint64 `json:"GroupNum,omitempty" name:"GroupNum"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type GetPersonListRequest struct {
	*tchttp.BaseRequest

	// 人体库ID。
	GroupId *string `json:"GroupId,omitempty" name:"GroupId"`

	// 起始序号，默认值为0。
	Offset *uint64 `json:"Offset,omitempty" name:"Offset"`

	// 返回数量，默认值为10，最大值为1000。
	Limit *uint64 `json:"Limit,omitempty" name:"Limit"`
}

type GetPersonListResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 返回的人员信息。
		PersonInfos []*PersonInfo `json:"PersonInfos,omitempty" name:"PersonInfos" list`

		// 该人体库的人员数量。
		PersonNum *uint64 `json:"PersonNum,omitempty" name:"PersonNum"`

		// 人体识别所用的算法模型版本。
		BodyModelVersion *string `json:"BodyModelVersion,omitempty" name:"BodyModelVersion"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type GroupInfo struct {

	// 人体库名称。
	GroupName *string `json:"GroupName,omitempty" name:"GroupName"`

	// 人体库ID。
	GroupId *string `json:"GroupId,omitempty" name:"GroupId"`

	// 人体库信息备注。
	Tag *string `json:"Tag,omitempty" name:"Tag"`

	// 人体识别所用的算法模型版本。
	BodyModelVersion *string `json:"BodyModelVersion,omitempty" name:"BodyModelVersion"`

	// Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
	// Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 。
	CreationTimestamp *uint64 `json:"CreationTimestamp,omitempty" name:"CreationTimestamp"`
}

type ImageRect struct {

	// 左上角横坐标。
	X *int64 `json:"X,omitempty" name:"X"`

	// 左上角纵坐标。
	Y *int64 `json:"Y,omitempty" name:"Y"`

	// 人体宽度。
	Width *int64 `json:"Width,omitempty" name:"Width"`

	// 人体高度。
	Height *int64 `json:"Height,omitempty" name:"Height"`

	// 分割选项名称。
	Label *string `json:"Label,omitempty" name:"Label"`
}

type KeyPointInfo struct {

	// 代表不同位置的人体关键点信息，返回值为以下集合中的一个 [头部,颈部,右肩,右肘,右腕,左肩,左肘,左腕,右髋,右膝,右踝,左髋,左膝,左踝]
	KeyPointType *string `json:"KeyPointType,omitempty" name:"KeyPointType"`

	// 人体关键点横坐标
	X *float64 `json:"X,omitempty" name:"X"`

	// 人体关键点纵坐标
	Y *float64 `json:"Y,omitempty" name:"Y"`
}

type LowerBodyCloth struct {

	// 下衣颜色信息。
	Color *LowerBodyClothColor `json:"Color,omitempty" name:"Color"`

	// 下衣长度信息 。
	Length *LowerBodyClothLength `json:"Length,omitempty" name:"Length"`

	// 下衣类型信息。
	Type *LowerBodyClothType `json:"Type,omitempty" name:"Type"`
}

type LowerBodyClothColor struct {

	// 下衣颜色信息，返回值为以下集合中的一个{ 黑色系, 灰白色系, 彩色} 。
	Type *string `json:"Type,omitempty" name:"Type"`

	// Type识别概率值，[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。
	Probability *float64 `json:"Probability,omitempty" name:"Probability"`
}

type LowerBodyClothLength struct {

	// 下衣长度信息，返回值为以下集合中的一个，{长, 短} 。
	Type *string `json:"Type,omitempty" name:"Type"`

	// Type识别概率值，[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。
	Probability *float64 `json:"Probability,omitempty" name:"Probability"`
}

type LowerBodyClothType struct {

	// 下衣类型，返回值为以下集合中的一个 {裤子,裙子} 。
	Type *string `json:"Type,omitempty" name:"Type"`

	// Type识别概率值，[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。
	Probability *float64 `json:"Probability,omitempty" name:"Probability"`
}

type ModifyGroupRequest struct {
	*tchttp.BaseRequest

	// 人体库ID。
	GroupId *string `json:"GroupId,omitempty" name:"GroupId"`

	// 人体库名称。
	GroupName *string `json:"GroupName,omitempty" name:"GroupName"`

	// 人体库信息备注。
	Tag *string `json:"Tag,omitempty" name:"Tag"`
}

type ModifyGroupResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type ModifyPersonInfoRequest struct {
	*tchttp.BaseRequest

	// 人员ID。
	PersonId *string `json:"PersonId,omitempty" name:"PersonId"`

	// 人员名称。
	PersonName *string `json:"PersonName,omitempty" name:"PersonName"`
}

type ModifyPersonInfoResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type Orientation struct {

	// 人体朝向信息，返回值为以下集合中的一个 {正向, 背向, 左, 右}。
	Type *string `json:"Type,omitempty" name:"Type"`

	// Type识别概率值，[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。
	Probability *float64 `json:"Probability,omitempty" name:"Probability"`
}

type PersonInfo struct {

	// 人员名称。
	PersonName *string `json:"PersonName,omitempty" name:"PersonName"`

	// 人员ID。
	PersonId *string `json:"PersonId,omitempty" name:"PersonId"`

	// 包含的人体轨迹图片信息列表。
	TraceInfos []*TraceInfo `json:"TraceInfos,omitempty" name:"TraceInfos" list`
}

type SearchTraceRequest struct {
	*tchttp.BaseRequest

	// 希望搜索的人体库ID。
	GroupId *string `json:"GroupId,omitempty" name:"GroupId"`

	// 人体轨迹信息。
	Trace *Trace `json:"Trace,omitempty" name:"Trace"`

	// 单张被识别的人体轨迹返回的最相似人员数量。
	// 默认值为5，最大值为100。
	//  例，设MaxPersonNum为8，则返回Top8相似的人员信息。 值越大，需要处理的时间越长。建议不要超过10。
	MaxPersonNum *uint64 `json:"MaxPersonNum,omitempty" name:"MaxPersonNum"`

	// 出参Score中，只有超过TraceMatchThreshold值的结果才会返回。
	// 默认为0。范围[0, 100.0]。
	TraceMatchThreshold *float64 `json:"TraceMatchThreshold,omitempty" name:"TraceMatchThreshold"`
}

type SearchTraceResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 识别出的最相似候选人。
		Candidates []*Candidate `json:"Candidates,omitempty" name:"Candidates" list`

		// 输入的人体轨迹图片中的合法性校验结果。
		// 只有为0时结果才有意义。
		// -1001: 输入图片不合法。-1002: 输入图片不能构成轨迹。
		InputRetCode *int64 `json:"InputRetCode,omitempty" name:"InputRetCode"`

		// 输入的人体轨迹图片中的合法性校验结果详情。
		// -1101:图片无效，-1102:url不合法。-1103:图片过大。-1104:图片下载失败。-1105:图片解码失败。-1109:图片分辨率过高。-2023:轨迹中有非同人图片。-2024: 轨迹提取失败。-2025: 人体检测失败。
		InputRetCodeDetails []*int64 `json:"InputRetCodeDetails,omitempty" name:"InputRetCodeDetails" list`

		// 人体识别所用的算法模型版本。
		BodyModelVersion *string `json:"BodyModelVersion,omitempty" name:"BodyModelVersion"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type SegmentCustomizedPortraitPicRequest struct {
	*tchttp.BaseRequest

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

	// 图片 base64 数据，base64 编码后大小不可超过5M。
	// 图片分辨率须小于2000*2000。
	// 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
	Image *string `json:"Image,omitempty" name:"Image"`

	// 图片的 Url 。
	// Url、Image必须提供一个，如果都提供，只使用 Url。
	// 图片分辨率须小于2000*2000 ，图片 base64 编码后大小不可超过5M。
	// 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
	// 非腾讯云存储的Url速度和稳定性可能受一定影响。
	// 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
	Url *string `json:"Url,omitempty" name:"Url"`
}

type SegmentCustomizedPortraitPicResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 根据指定标签分割输出的透明背景人像图片的 base64 数据。
		PortraitImage *string `json:"PortraitImage,omitempty" name:"PortraitImage"`

		// 指定标签处理后的Mask。一个通过 Base64 编码的文件，解码后文件由 Float 型浮点数组成。这些浮点数代表原图从左上角开始的每一行的每一个像素点，每一个浮点数的值是原图相应像素点位于人体轮廓内的置信度（0-1）转化的灰度值（0-255）
		MaskImage *string `json:"MaskImage,omitempty" name:"MaskImage"`

		// 坐标信息。
		// 注意：此字段可能返回 null，表示取不到有效值。
		ImageRects []*ImageRect `json:"ImageRects,omitempty" name:"ImageRects" list`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type SegmentPortraitPicRequest struct {
	*tchttp.BaseRequest

	// 图片 base64 数据，base64 编码后大小不可超过5M。
	// 图片分辨率须小于2000*2000。
	// 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
	Image *string `json:"Image,omitempty" name:"Image"`

	// 图片的 Url 。
	// Url、Image必须提供一个，如果都提供，只使用 Url。
	// 图片分辨率须小于2000*2000 ，图片 base64 编码后大小不可超过5M。
	// 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
	// 非腾讯云存储的Url速度和稳定性可能受一定影响。
	// 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
	Url *string `json:"Url,omitempty" name:"Url"`
}

type SegmentPortraitPicResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 处理后的图片 base64 数据，透明背景图
		ResultImage *string `json:"ResultImage,omitempty" name:"ResultImage"`

		// 一个通过 Base64 编码的文件，解码后文件由 Float 型浮点数组成。这些浮点数代表原图从左上角开始的每一行的每一个像素点，每一个浮点数的值是原图相应像素点位于人体轮廓内的置信度（0-1）转化的灰度值（0-255）
		ResultMask *string `json:"ResultMask,omitempty" name:"ResultMask"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type SegmentationOptions struct {

	// 分割选项-背景
	Background *bool `json:"Background,omitempty" name:"Background"`

	// 分割选项-头发
	Hair *bool `json:"Hair,omitempty" name:"Hair"`

	// 分割选项-左眉
	LeftEyebrow *bool `json:"LeftEyebrow,omitempty" name:"LeftEyebrow"`

	// 分割选项-右眉
	RightEyebrow *bool `json:"RightEyebrow,omitempty" name:"RightEyebrow"`

	// 分割选项-左眼
	LeftEye *bool `json:"LeftEye,omitempty" name:"LeftEye"`

	// 分割选项-右眼
	RightEye *bool `json:"RightEye,omitempty" name:"RightEye"`

	// 分割选项-鼻子
	Nose *bool `json:"Nose,omitempty" name:"Nose"`

	// 分割选项-上唇
	UpperLip *bool `json:"UpperLip,omitempty" name:"UpperLip"`

	// 分割选项-下唇
	LowerLip *bool `json:"LowerLip,omitempty" name:"LowerLip"`

	// 分割选项-牙齿
	Tooth *bool `json:"Tooth,omitempty" name:"Tooth"`

	// 分割选项-口腔（不包含牙齿）
	Mouth *bool `json:"Mouth,omitempty" name:"Mouth"`

	// 分割选项-左耳
	LeftEar *bool `json:"LeftEar,omitempty" name:"LeftEar"`

	// 分割选项-右耳
	RightEar *bool `json:"RightEar,omitempty" name:"RightEar"`

	// 分割选项-面部(不包含眼、耳、口、鼻等五官及头发。)
	Face *bool `json:"Face,omitempty" name:"Face"`

	// 复合分割选项-头部(包含所有的头部元素，相关装饰除外)
	Head *bool `json:"Head,omitempty" name:"Head"`

	// 分割选项-身体（包含脖子）
	Body *bool `json:"Body,omitempty" name:"Body"`

	// 分割选项-帽子
	Hat *bool `json:"Hat,omitempty" name:"Hat"`

	// 分割选项-头饰
	Headdress *bool `json:"Headdress,omitempty" name:"Headdress"`

	// 分割选项-耳环
	Earrings *bool `json:"Earrings,omitempty" name:"Earrings"`

	// 分割选项-项链
	Necklace *bool `json:"Necklace,omitempty" name:"Necklace"`

	// 分割选项-随身物品（ 例如伞、包、手机等。 ）
	Belongings *bool `json:"Belongings,omitempty" name:"Belongings"`
}

type TerminateSegmentationTaskRequest struct {
	*tchttp.BaseRequest

	// 在提交分割任务成功时返回的任务标识ID。
	TaskID *string `json:"TaskID,omitempty" name:"TaskID"`
}

type TerminateSegmentationTaskResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

type Trace struct {

	// 人体轨迹图片 Base64 数组。
	// 数组长度最小为1最大为5。
	// 单个图片 base64 编码后大小不可超过2M。
	// 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
	Images []*string `json:"Images,omitempty" name:"Images" list`

	// 人体轨迹图片 Url 数组。
	// 数组长度最小为1最大为5。
	// 单个图片 base64 编码后大小不可超过2M。
	// Urls、Images必须提供一个，如果都提供，只使用 Urls。
	// 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
	// 非腾讯云存储的Url速度和稳定性可能受一定影响。
	// 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
	Urls []*string `json:"Urls,omitempty" name:"Urls" list`

	// 若输入的Images 和 Urls 是已经裁剪后的人体小图，则可以忽略本参数。
	// 若否，或图片中包含多个人体，则需要通过本参数来指定图片中的人体框。
	// 顺序对应 Images 或 Urls 中的顺序。
	// 当不输入本参数时，我们将认为输入图片已是经过裁剪后的人体小图，不会进行人体检测而直接进行特征提取处理。
	BodyRects []*BodyRect `json:"BodyRects,omitempty" name:"BodyRects" list`
}

type TraceInfo struct {

	// 人体轨迹ID。
	TraceId *string `json:"TraceId,omitempty" name:"TraceId"`

	// 包含的人体轨迹图片Id列表。
	BodyIds []*string `json:"BodyIds,omitempty" name:"BodyIds" list`
}

type UpperBodyCloth struct {

	// 上衣纹理信息。
	Texture *UpperBodyClothTexture `json:"Texture,omitempty" name:"Texture"`

	// 上衣颜色信息。
	Color *UpperBodyClothColor `json:"Color,omitempty" name:"Color"`

	// 上衣衣袖信息。
	Sleeve *UpperBodyClothSleeve `json:"Sleeve,omitempty" name:"Sleeve"`
}

type UpperBodyClothColor struct {

	// 上衣颜色信息，返回值为以下集合中的一个 {红色系, 黄色系, 绿色系, 蓝色系, 黑色系, 灰白色系。
	Type *string `json:"Type,omitempty" name:"Type"`

	// Type识别概率值，[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。
	Probability *float64 `json:"Probability,omitempty" name:"Probability"`
}

type UpperBodyClothSleeve struct {

	// 上衣衣袖信息, 返回值为以下集合中的一个 {长袖, 短袖}。
	Type *string `json:"Type,omitempty" name:"Type"`

	// Type识别概率值，[0.0,1.0],代表判断正确的概率。如0.8则代表有Type值有80%概率正确。
	Probability *float64 `json:"Probability,omitempty" name:"Probability"`
}

type UpperBodyClothTexture struct {

	// 上衣纹理信息，返回值为以下集合中的一个, {纯色, 格子, 大色块}。
	Type *string `json:"Type,omitempty" name:"Type"`

	// Type识别概率值，[0.0,1.0], 代表判断正确的概率。如0.8则代表有Type值有80%概率正确。
	Probability *float64 `json:"Probability,omitempty" name:"Probability"`
}

type VideoBasicInformation struct {

	// 视频宽度
	FrameWidth *int64 `json:"FrameWidth,omitempty" name:"FrameWidth"`

	// 视频高度
	FrameHeight *int64 `json:"FrameHeight,omitempty" name:"FrameHeight"`

	// 视频帧速率(FPS)
	FramesPerSecond *int64 `json:"FramesPerSecond,omitempty" name:"FramesPerSecond"`

	// 视频时长
	Duration *float64 `json:"Duration,omitempty" name:"Duration"`

	// 视频帧数
	TotalFrames *int64 `json:"TotalFrames,omitempty" name:"TotalFrames"`
}