# frozen_string_literal: true
# Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
module TencentCloud
module Iai
module V20200303
# AnalyzeDenseLandmarks请求参数结构体
class AnalyzeDenseLandmarksRequest < TencentCloud::Common::AbstractModel
# @param Mode: 检测模式。0 为检测所有出现的人脸， 1 为检测面积最大的人脸。
# 默认为 0。
# 最多返回 5 张人脸的五官定位（人脸关键点）具体信息。
# @type Mode: Integer
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
# @type FaceModelVersion: String
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :Mode, :Image, :Url, :FaceModelVersion, :NeedRotateDetection
def initialize(mode=nil, image=nil, url=nil, facemodelversion=nil, needrotatedetection=nil)
@Mode = mode
@Image = image
@Url = url
@FaceModelVersion = facemodelversion
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@Mode = params['Mode']
@Image = params['Image']
@Url = params['Url']
@FaceModelVersion = params['FaceModelVersion']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# AnalyzeDenseLandmarks返回参数结构体
class AnalyzeDenseLandmarksResponse < TencentCloud::Common::AbstractModel
# @param ImageWidth: 请求的图片宽度。
# @type ImageWidth: Integer
# @param ImageHeight: 请求的图片高度。
# @type ImageHeight: Integer
# @param DenseFaceShapeSet: 稠密人脸关键点具体信息。
# @type DenseFaceShapeSet: Array
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :ImageWidth, :ImageHeight, :DenseFaceShapeSet, :FaceModelVersion, :RequestId
def initialize(imagewidth=nil, imageheight=nil, densefaceshapeset=nil, facemodelversion=nil, requestid=nil)
@ImageWidth = imagewidth
@ImageHeight = imageheight
@DenseFaceShapeSet = densefaceshapeset
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@ImageWidth = params['ImageWidth']
@ImageHeight = params['ImageHeight']
unless params['DenseFaceShapeSet'].nil?
@DenseFaceShapeSet = []
params['DenseFaceShapeSet'].each do |i|
densefaceshape_tmp = DenseFaceShape.new
densefaceshape_tmp.deserialize(i)
@DenseFaceShapeSet << densefaceshape_tmp
end
end
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# AnalyzeFace请求参数结构体
class AnalyzeFaceRequest < TencentCloud::Common::AbstractModel
# @param Mode: 检测模式。0 为检测所有出现的人脸， 1 为检测面积最大的人脸。默认为 0。最多返回 10 张人脸的五官定位（人脸关键点）具体信息。
# @type Mode: Integer
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
# 目前入参支持 “2.0”和“3.0“ 两个输入。
# 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
# 2020年11月26日后开通服务的账号仅支持输入“3.0”。
# 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
# @type FaceModelVersion: String
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :Mode, :Image, :Url, :FaceModelVersion, :NeedRotateDetection
def initialize(mode=nil, image=nil, url=nil, facemodelversion=nil, needrotatedetection=nil)
@Mode = mode
@Image = image
@Url = url
@FaceModelVersion = facemodelversion
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@Mode = params['Mode']
@Image = params['Image']
@Url = params['Url']
@FaceModelVersion = params['FaceModelVersion']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# AnalyzeFace返回参数结构体
class AnalyzeFaceResponse < TencentCloud::Common::AbstractModel
# @param ImageWidth: 请求的图片宽度。
# @type ImageWidth: Integer
# @param ImageHeight: 请求的图片高度。
# @type ImageHeight: Integer
# @param FaceShapeSet: 五官定位（人脸关键点）具体信息。
# @type FaceShapeSet: Array
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :ImageWidth, :ImageHeight, :FaceShapeSet, :FaceModelVersion, :RequestId
def initialize(imagewidth=nil, imageheight=nil, faceshapeset=nil, facemodelversion=nil, requestid=nil)
@ImageWidth = imagewidth
@ImageHeight = imageheight
@FaceShapeSet = faceshapeset
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@ImageWidth = params['ImageWidth']
@ImageHeight = params['ImageHeight']
unless params['FaceShapeSet'].nil?
@FaceShapeSet = []
params['FaceShapeSet'].each do |i|
faceshape_tmp = FaceShape.new
faceshape_tmp.deserialize(i)
@FaceShapeSet << faceshape_tmp
end
end
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# 人脸属性信息
class AttributeItem < TencentCloud::Common::AbstractModel
# @param Type: 属性值
# @type Type: Integer
# @param Probability: Type识别概率值,[0,1],代表判断正确的概率。
# @type Probability: Float
attr_accessor :Type, :Probability
def initialize(type=nil, probability=nil)
@Type = type
@Probability = probability
end
def deserialize(params)
@Type = params['Type']
@Probability = params['Probability']
end
end
# 识别出的最相似候选人
class Candidate < TencentCloud::Common::AbstractModel
# @param PersonId: 人员ID
# @type PersonId: String
# @param FaceId: 人脸ID，仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。人员搜索类接口采用融合特征方式检索，该字段无意义
# @type FaceId: String
# @param Score: 候选者的匹配得分。
# 1万大小人脸底库下，误识率百分之一对应分数为70分，误识率千分之一对应分数为80分，误识率万分之一对应分数为90分；
# 10万大小人脸底库下，误识率百分之一对应分数为80分，误识率千分之一对应分数为90分，误识率万分之一对应分数为100分；
# 30万大小人脸底库下，误识率百分之一对应分数为85分，误识率千分之一对应分数为95分。
# 一般80分左右可适用大部分场景，建议分数不要超过90分。您可以根据实际情况选择合适的分数。
# @type Score: Float
# @param PersonName: 人员名称
# 注意：此字段可能返回 null，表示取不到有效值。
# @type PersonName: String
# @param Gender: 人员性别
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Gender: Integer
# @param PersonGroupInfos: 包含此人员的人员库及描述字段内容列表
# 注意：此字段可能返回 null，表示取不到有效值。
# @type PersonGroupInfos: Array
attr_accessor :PersonId, :FaceId, :Score, :PersonName, :Gender, :PersonGroupInfos
def initialize(personid=nil, faceid=nil, score=nil, personname=nil, gender=nil, persongroupinfos=nil)
@PersonId = personid
@FaceId = faceid
@Score = score
@PersonName = personname
@Gender = gender
@PersonGroupInfos = persongroupinfos
end
def deserialize(params)
@PersonId = params['PersonId']
@FaceId = params['FaceId']
@Score = params['Score']
@PersonName = params['PersonName']
@Gender = params['Gender']
unless params['PersonGroupInfos'].nil?
@PersonGroupInfos = []
params['PersonGroupInfos'].each do |i|
persongroupinfo_tmp = PersonGroupInfo.new
persongroupinfo_tmp.deserialize(i)
@PersonGroupInfos << persongroupinfo_tmp
end
end
end
end
# CompareFace请求参数结构体
class CompareFaceRequest < TencentCloud::Common::AbstractModel
# @param ImageA: A 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 若图片中包含多张人脸，只选取其中置信度最高的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type ImageA: String
# @param ImageB: B 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 若图片中包含多张人脸，只选取其中置信度最高的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type ImageB: String
# @param UrlA: A 图片的 Url ，对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# A 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type UrlA: String
# @param UrlB: B 图片的 Url ，对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# B 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type UrlB: String
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
# 目前入参支持 “2.0”和“3.0“ 两个输入。
# 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
# 2020年11月26日后开通服务的账号仅支持输入“3.0”。
# 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
# @type FaceModelVersion: String
# @param QualityControl: 图片质量控制。
# 0: 不进行控制；
# 1: 较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
# 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
# 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
# 4: 很高的质量要求，各个维度均为最好或最多，在某一维度上存在轻微问题；
# 默认 0。
# 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
# @type QualityControl: Integer
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :ImageA, :ImageB, :UrlA, :UrlB, :FaceModelVersion, :QualityControl, :NeedRotateDetection
def initialize(imagea=nil, imageb=nil, urla=nil, urlb=nil, facemodelversion=nil, qualitycontrol=nil, needrotatedetection=nil)
@ImageA = imagea
@ImageB = imageb
@UrlA = urla
@UrlB = urlb
@FaceModelVersion = facemodelversion
@QualityControl = qualitycontrol
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@ImageA = params['ImageA']
@ImageB = params['ImageB']
@UrlA = params['UrlA']
@UrlB = params['UrlB']
@FaceModelVersion = params['FaceModelVersion']
@QualityControl = params['QualityControl']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# CompareFace返回参数结构体
class CompareFaceResponse < TencentCloud::Common::AbstractModel
# @param Score: 两张图片中人脸的相似度分数。
# 不同算法版本返回的相似度分数不同。
# 若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
# 2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
# 若需要验证两张图片中的人脸是否为同一人，建议使用人脸验证接口。
# @type Score: Float
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :Score, :FaceModelVersion, :RequestId
def initialize(score=nil, facemodelversion=nil, requestid=nil)
@Score = score
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@Score = params['Score']
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# CompareMaskFace请求参数结构体
class CompareMaskFaceRequest < TencentCloud::Common::AbstractModel
# @param ImageA: A 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type ImageA: String
# @param ImageB: B 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type ImageB: String
# @param UrlA: A 图片的 Url ，对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# A 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type UrlA: String
# @param UrlB: B 图片的 Url ，对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# B 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type UrlB: String
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。该接口只支持"3.0"
# @type FaceModelVersion: String
# @param QualityControl: 图片质量控制。
# 0: 不进行控制；
# 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
# 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
# 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
# 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
# 默认 0。
# 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
# @type QualityControl: Integer
attr_accessor :ImageA, :ImageB, :UrlA, :UrlB, :FaceModelVersion, :QualityControl
def initialize(imagea=nil, imageb=nil, urla=nil, urlb=nil, facemodelversion=nil, qualitycontrol=nil)
@ImageA = imagea
@ImageB = imageb
@UrlA = urla
@UrlB = urlb
@FaceModelVersion = facemodelversion
@QualityControl = qualitycontrol
end
def deserialize(params)
@ImageA = params['ImageA']
@ImageB = params['ImageB']
@UrlA = params['UrlA']
@UrlB = params['UrlB']
@FaceModelVersion = params['FaceModelVersion']
@QualityControl = params['QualityControl']
end
end
# CompareMaskFace返回参数结构体
class CompareMaskFaceResponse < TencentCloud::Common::AbstractModel
# @param Score: 两张图片中人脸的相似度分数。
# 不同算法版本返回的相似度分数不同。
# 若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
# 2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
# 若需要验证两张图片中的人脸是否为同一人，建议使用人脸验证接口。
# @type Score: Float
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :Score, :FaceModelVersion, :RequestId
def initialize(score=nil, facemodelversion=nil, requestid=nil)
@Score = score
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@Score = params['Score']
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# CopyPerson请求参数结构体
class CopyPersonRequest < TencentCloud::Common::AbstractModel
# @param PersonId: 人员ID，取值为创建人员接口中的PersonId
# @type PersonId: String
# @param GroupIds: 待加入的人员库列表，数组元素取值为创建人员库接口中的GroupId
# @type GroupIds: Array
attr_accessor :PersonId, :GroupIds
def initialize(personid=nil, groupids=nil)
@PersonId = personid
@GroupIds = groupids
end
def deserialize(params)
@PersonId = params['PersonId']
@GroupIds = params['GroupIds']
end
end
# CopyPerson返回参数结构体
class CopyPersonResponse < TencentCloud::Common::AbstractModel
# @param SucGroupNum: 成功加入的人员库数量
# @type SucGroupNum: Integer
# @param SucGroupIds: 成功加入的人员库列表
# @type SucGroupIds: Array
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :SucGroupNum, :SucGroupIds, :RequestId
def initialize(sucgroupnum=nil, sucgroupids=nil, requestid=nil)
@SucGroupNum = sucgroupnum
@SucGroupIds = sucgroupids
@RequestId = requestid
end
def deserialize(params)
@SucGroupNum = params['SucGroupNum']
@SucGroupIds = params['SucGroupIds']
@RequestId = params['RequestId']
end
end
# CreateFace请求参数结构体
class CreateFaceRequest < TencentCloud::Common::AbstractModel
# @param PersonId: 人员ID，取值为创建人员接口中的PersonId
# @type PersonId: String
# @param Images: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 人员人脸总数量不可超过5张。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Images: Array
# @param Urls: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# 人员人脸总数量不可超过5张。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# @type Urls: Array
# @param FaceMatchThreshold: 只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸，才能增加人脸成功。
# 默认值60分。取值范围[0,100] 。
# @type FaceMatchThreshold: Float
# @param QualityControl: 图片质量控制。
# 0: 不进行控制；
# 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
# 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
# 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
# 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
# 默认 0。
# 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
# @type QualityControl: Integer
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :PersonId, :Images, :Urls, :FaceMatchThreshold, :QualityControl, :NeedRotateDetection
def initialize(personid=nil, images=nil, urls=nil, facematchthreshold=nil, qualitycontrol=nil, needrotatedetection=nil)
@PersonId = personid
@Images = images
@Urls = urls
@FaceMatchThreshold = facematchthreshold
@QualityControl = qualitycontrol
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@PersonId = params['PersonId']
@Images = params['Images']
@Urls = params['Urls']
@FaceMatchThreshold = params['FaceMatchThreshold']
@QualityControl = params['QualityControl']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# CreateFace返回参数结构体
class CreateFaceResponse < TencentCloud::Common::AbstractModel
# @param SucFaceNum: 加入成功的人脸数量
# @type SucFaceNum: Integer
# @param SucFaceIds: 加入成功的人脸ID列表
# @type SucFaceIds: Array
# @param RetCode: 每张人脸图片添加结果，-1101 代表未检测到人脸，-1102 代表图片解码失败，-1109 代表图片尺寸过大或者过小，
# -1601代表不符合图片质量控制要求, -1604 代表人脸相似度没有超过FaceMatchThreshold。
# 其他非 0 值代表算法服务异常。
# RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
# @type RetCode: Array
# @param SucIndexes: 加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。
# 例如， Urls 中 有 3 个 url，第二个 url 失败，则 SucIndexes 值为 [0,2] 。
# @type SucIndexes: Array
# @param SucFaceRects: 加入成功的人脸框位置。顺序和入参中 Images 或 Urls 的顺序一致。
# @type SucFaceRects: Array
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :SucFaceNum, :SucFaceIds, :RetCode, :SucIndexes, :SucFaceRects, :FaceModelVersion, :RequestId
def initialize(sucfacenum=nil, sucfaceids=nil, retcode=nil, sucindexes=nil, sucfacerects=nil, facemodelversion=nil, requestid=nil)
@SucFaceNum = sucfacenum
@SucFaceIds = sucfaceids
@RetCode = retcode
@SucIndexes = sucindexes
@SucFaceRects = sucfacerects
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@SucFaceNum = params['SucFaceNum']
@SucFaceIds = params['SucFaceIds']
@RetCode = params['RetCode']
@SucIndexes = params['SucIndexes']
unless params['SucFaceRects'].nil?
@SucFaceRects = []
params['SucFaceRects'].each do |i|
facerect_tmp = FaceRect.new
facerect_tmp.deserialize(i)
@SucFaceRects << facerect_tmp
end
end
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# CreateGroup请求参数结构体
class CreateGroupRequest < TencentCloud::Common::AbstractModel
# @param GroupName: 人员库名称，[1,60]个字符，可修改，不可重复。
# @type GroupName: String
# @param GroupId: 人员库 ID，不可修改，不可重复。支持英文、数字、-%@#&_，长度限制64B。
# @type GroupId: String
# @param GroupExDescriptions: 人员库自定义描述字段，用于描述人员库中人员属性，该人员库下所有人员将拥有此描述字段。
# 最多可以创建5个。
# 每个自定义描述字段支持[1,30]个字符。
# 在同一人员库中自定义描述字段不可重复。
# 例： 设置某人员库“自定义描述字段”为["学号","工号","手机号"]，
# 则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段，
# 可在对应人员描述字段中填写内容，登记该人员的学号、工号、手机号等信息。
# @type GroupExDescriptions: Array
# @param Tag: 人员库信息备注，[0，40]个字符。
# @type Tag: String
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
# 目前入参支持 “2.0”和“3.0“ 两个输入。
# 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
# 2020年11月26日后开通服务的账号仅支持输入“3.0”。
# 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
# @type FaceModelVersion: String
attr_accessor :GroupName, :GroupId, :GroupExDescriptions, :Tag, :FaceModelVersion
def initialize(groupname=nil, groupid=nil, groupexdescriptions=nil, tag=nil, facemodelversion=nil)
@GroupName = groupname
@GroupId = groupid
@GroupExDescriptions = groupexdescriptions
@Tag = tag
@FaceModelVersion = facemodelversion
end
def deserialize(params)
@GroupName = params['GroupName']
@GroupId = params['GroupId']
@GroupExDescriptions = params['GroupExDescriptions']
@Tag = params['Tag']
@FaceModelVersion = params['FaceModelVersion']
end
end
# CreateGroup返回参数结构体
class CreateGroupResponse < TencentCloud::Common::AbstractModel
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :FaceModelVersion, :RequestId
def initialize(facemodelversion=nil, requestid=nil)
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# CreatePerson请求参数结构体
class CreatePersonRequest < TencentCloud::Common::AbstractModel
# @param GroupId: 待加入的人员库ID，取值为创建人员库接口中的GroupId
# @type GroupId: String
# @param PersonName: 人员名称。[1，60]个字符，可修改，可重复。
# @type PersonName: String
# @param PersonId: 人员ID，单个腾讯云账号下不可修改，不可重复。支持英文、数字、-%@#&_，长度限制64B。
# @type PersonId: String
# @param Gender: 0代表未填写，1代表男性，2代表女性。
# @type Gender: Integer
# @param PersonExDescriptionInfos: 人员描述字段内容，key-value。[0，60]个字符，可修改，可重复。
# @type PersonExDescriptionInfos: Array
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param UniquePersonControl: 此参数用于控制判断 Image 或 Url 中图片包含的人脸，是否在人员库中已有疑似的同一人。
# 如果判断为已有相同人在人员库中，则不会创建新的人员，返回疑似同一人的人员信息。
# 如果判断没有，则完成创建人员。
# 0: 不进行判断，无论是否有疑似同一人在库中均完成入库；
# 1:较低的同一人判断要求（百一误识别率）；
# 2: 一般的同一人判断要求（千一误识别率）；
# 3: 较高的同一人判断要求（万一误识别率）；
# 4: 很高的同一人判断要求（十万一误识别率）。
# 默认 0。
# 注： 要求越高，则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值，您可以根据实际情况调整。
# @type UniquePersonControl: Integer
# @param QualityControl: 图片质量控制。
# 0: 不进行控制；
# 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
# 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
# 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
# 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
# 默认 0。
# 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
# @type QualityControl: Integer
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :GroupId, :PersonName, :PersonId, :Gender, :PersonExDescriptionInfos, :Image, :Url, :UniquePersonControl, :QualityControl, :NeedRotateDetection
def initialize(groupid=nil, personname=nil, personid=nil, gender=nil, personexdescriptioninfos=nil, image=nil, url=nil, uniquepersoncontrol=nil, qualitycontrol=nil, needrotatedetection=nil)
@GroupId = groupid
@PersonName = personname
@PersonId = personid
@Gender = gender
@PersonExDescriptionInfos = personexdescriptioninfos
@Image = image
@Url = url
@UniquePersonControl = uniquepersoncontrol
@QualityControl = qualitycontrol
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@GroupId = params['GroupId']
@PersonName = params['PersonName']
@PersonId = params['PersonId']
@Gender = params['Gender']
unless params['PersonExDescriptionInfos'].nil?
@PersonExDescriptionInfos = []
params['PersonExDescriptionInfos'].each do |i|
personexdescriptioninfo_tmp = PersonExDescriptionInfo.new
personexdescriptioninfo_tmp.deserialize(i)
@PersonExDescriptionInfos << personexdescriptioninfo_tmp
end
end
@Image = params['Image']
@Url = params['Url']
@UniquePersonControl = params['UniquePersonControl']
@QualityControl = params['QualityControl']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# CreatePerson返回参数结构体
class CreatePersonResponse < TencentCloud::Common::AbstractModel
# @param FaceId: 人脸图片唯一标识。
# @type FaceId: String
# @param FaceRect: 检测出的人脸框的位置。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type FaceRect: :class:`Tencentcloud::Iai.v20200303.models.FaceRect`
# @param SimilarPersonId: 疑似同一人的PersonId。
# 当 UniquePersonControl 参数不为0且人员库中有疑似的同一人，此参数才有意义。
# @type SimilarPersonId: String
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :FaceId, :FaceRect, :SimilarPersonId, :FaceModelVersion, :RequestId
def initialize(faceid=nil, facerect=nil, similarpersonid=nil, facemodelversion=nil, requestid=nil)
@FaceId = faceid
@FaceRect = facerect
@SimilarPersonId = similarpersonid
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@FaceId = params['FaceId']
unless params['FaceRect'].nil?
@FaceRect = FaceRect.new
@FaceRect.deserialize(params['FaceRect'])
end
@SimilarPersonId = params['SimilarPersonId']
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# DeleteFace请求参数结构体
class DeleteFaceRequest < TencentCloud::Common::AbstractModel
# @param PersonId: 人员ID，取值为创建人员接口中的PersonId
# @type PersonId: String
# @param FaceIds: 待删除的人脸ID列表，数组元素取值为增加人脸接口返回的FaceId
# @type FaceIds: Array
attr_accessor :PersonId, :FaceIds
def initialize(personid=nil, faceids=nil)
@PersonId = personid
@FaceIds = faceids
end
def deserialize(params)
@PersonId = params['PersonId']
@FaceIds = params['FaceIds']
end
end
# DeleteFace返回参数结构体
class DeleteFaceResponse < TencentCloud::Common::AbstractModel
# @param SucDeletedNum: 删除成功的人脸数量
# @type SucDeletedNum: Integer
# @param SucFaceIds: 删除成功的人脸ID列表
# @type SucFaceIds: Array
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :SucDeletedNum, :SucFaceIds, :RequestId
def initialize(sucdeletednum=nil, sucfaceids=nil, requestid=nil)
@SucDeletedNum = sucdeletednum
@SucFaceIds = sucfaceids
@RequestId = requestid
end
def deserialize(params)
@SucDeletedNum = params['SucDeletedNum']
@SucFaceIds = params['SucFaceIds']
@RequestId = params['RequestId']
end
end
# DeleteGroup请求参数结构体
class DeleteGroupRequest < TencentCloud::Common::AbstractModel
# @param GroupId: 人员库ID，取值为创建人员库接口中的GroupId
# @type GroupId: String
attr_accessor :GroupId
def initialize(groupid=nil)
@GroupId = groupid
end
def deserialize(params)
@GroupId = params['GroupId']
end
end
# DeleteGroup返回参数结构体
class DeleteGroupResponse < TencentCloud::Common::AbstractModel
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :RequestId
def initialize(requestid=nil)
@RequestId = requestid
end
def deserialize(params)
@RequestId = params['RequestId']
end
end
# DeletePersonFromGroup请求参数结构体
class DeletePersonFromGroupRequest < TencentCloud::Common::AbstractModel
# @param PersonId: 人员ID，取值为创建人员接口中的PersonId
# @type PersonId: String
# @param GroupId: 人员库ID，取值为创建人员库接口中的GroupId
# @type GroupId: String
attr_accessor :PersonId, :GroupId
def initialize(personid=nil, groupid=nil)
@PersonId = personid
@GroupId = groupid
end
def deserialize(params)
@PersonId = params['PersonId']
@GroupId = params['GroupId']
end
end
# DeletePersonFromGroup返回参数结构体
class DeletePersonFromGroupResponse < TencentCloud::Common::AbstractModel
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :RequestId
def initialize(requestid=nil)
@RequestId = requestid
end
def deserialize(params)
@RequestId = params['RequestId']
end
end
# DeletePerson请求参数结构体
class DeletePersonRequest < TencentCloud::Common::AbstractModel
# @param PersonId: 人员ID，取值为创建人员接口中的PersonId
# @type PersonId: String
attr_accessor :PersonId
def initialize(personid=nil)
@PersonId = personid
end
def deserialize(params)
@PersonId = params['PersonId']
end
end
# DeletePerson返回参数结构体
class DeletePersonResponse < TencentCloud::Common::AbstractModel
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :RequestId
def initialize(requestid=nil)
@RequestId = requestid
end
def deserialize(params)
@RequestId = params['RequestId']
end
end
# 稠密关键点详细信息
class DenseFaceShape < TencentCloud::Common::AbstractModel
# @param X: 人脸框左上角横坐标。
# @type X: Integer
# @param Y: 人脸框左上角纵坐标。
# @type Y: Integer
# @param Width: 人脸框宽度。
# @type Width: Integer
# @param Height: 人脸框高度。
# @type Height: Integer
# @param LeftEye: 描述左侧眼睛轮廓的 XX 点。
# @type LeftEye: Array
# @param RightEye: 描述右侧眼睛轮廓的 XX 点。
# @type RightEye: Array
# @param LeftEyeBrow: 描述左侧眉毛轮廓的 XX 点。
# @type LeftEyeBrow: Array
# @param RightEyeBrow: 描述右侧眉毛轮廓的 XX 点。
# @type RightEyeBrow: Array
# @param MouthOutside: 描述外嘴巴轮廓的 XX 点， 从左侧开始逆时针返回。
# @type MouthOutside: Array
# @param MouthInside: 描述内嘴巴轮廓的 XX 点，从左侧开始逆时针返回。
# @type MouthInside: Array
# @param Nose: 描述鼻子轮廓的 XX 点。
# @type Nose: Array
# @param LeftPupil: 左瞳孔轮廓的 XX 个点。
# @type LeftPupil: Array
# @param RightPupil: 右瞳孔轮廓的 XX 个点。
# @type RightPupil: Array
# @param CentralAxis: 中轴线轮廓的 XX 个点。
# @type CentralAxis: Array
# @param Chin: 下巴轮廓的 XX 个点。
# @type Chin: Array
# @param LeftEyeBags: 左眼袋的 XX 个点。
# @type LeftEyeBags: Array
# @param RightEyeBags: 右眼袋的 XX 个点。
# @type RightEyeBags: Array
# @param Forehead: 额头的 XX 个点。
# @type Forehead: Array
attr_accessor :X, :Y, :Width, :Height, :LeftEye, :RightEye, :LeftEyeBrow, :RightEyeBrow, :MouthOutside, :MouthInside, :Nose, :LeftPupil, :RightPupil, :CentralAxis, :Chin, :LeftEyeBags, :RightEyeBags, :Forehead
def initialize(x=nil, y=nil, width=nil, height=nil, lefteye=nil, righteye=nil, lefteyebrow=nil, righteyebrow=nil, mouthoutside=nil, mouthinside=nil, nose=nil, leftpupil=nil, rightpupil=nil, centralaxis=nil, chin=nil, lefteyebags=nil, righteyebags=nil, forehead=nil)
@X = x
@Y = y
@Width = width
@Height = height
@LeftEye = lefteye
@RightEye = righteye
@LeftEyeBrow = lefteyebrow
@RightEyeBrow = righteyebrow
@MouthOutside = mouthoutside
@MouthInside = mouthinside
@Nose = nose
@LeftPupil = leftpupil
@RightPupil = rightpupil
@CentralAxis = centralaxis
@Chin = chin
@LeftEyeBags = lefteyebags
@RightEyeBags = righteyebags
@Forehead = forehead
end
def deserialize(params)
@X = params['X']
@Y = params['Y']
@Width = params['Width']
@Height = params['Height']
unless params['LeftEye'].nil?
@LeftEye = []
params['LeftEye'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@LeftEye << point_tmp
end
end
unless params['RightEye'].nil?
@RightEye = []
params['RightEye'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@RightEye << point_tmp
end
end
unless params['LeftEyeBrow'].nil?
@LeftEyeBrow = []
params['LeftEyeBrow'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@LeftEyeBrow << point_tmp
end
end
unless params['RightEyeBrow'].nil?
@RightEyeBrow = []
params['RightEyeBrow'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@RightEyeBrow << point_tmp
end
end
unless params['MouthOutside'].nil?
@MouthOutside = []
params['MouthOutside'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@MouthOutside << point_tmp
end
end
unless params['MouthInside'].nil?
@MouthInside = []
params['MouthInside'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@MouthInside << point_tmp
end
end
unless params['Nose'].nil?
@Nose = []
params['Nose'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@Nose << point_tmp
end
end
unless params['LeftPupil'].nil?
@LeftPupil = []
params['LeftPupil'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@LeftPupil << point_tmp
end
end
unless params['RightPupil'].nil?
@RightPupil = []
params['RightPupil'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@RightPupil << point_tmp
end
end
unless params['CentralAxis'].nil?
@CentralAxis = []
params['CentralAxis'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@CentralAxis << point_tmp
end
end
unless params['Chin'].nil?
@Chin = []
params['Chin'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@Chin << point_tmp
end
end
unless params['LeftEyeBags'].nil?
@LeftEyeBags = []
params['LeftEyeBags'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@LeftEyeBags << point_tmp
end
end
unless params['RightEyeBags'].nil?
@RightEyeBags = []
params['RightEyeBags'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@RightEyeBags << point_tmp
end
end
unless params['Forehead'].nil?
@Forehead = []
params['Forehead'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@Forehead << point_tmp
end
end
end
end
# DetectFaceAttributes请求参数结构体
class DetectFaceAttributesRequest < TencentCloud::Common::AbstractModel
# @param MaxFaceNum: 最多处理的人脸数目。
# 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。
# 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。
# @type MaxFaceNum: Integer
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 所有格式的图片短边像素不小于64。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。
# 对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param FaceAttributesType: 是否返回年龄、性别、情绪等属性。
# 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、
# Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
# None为不需要返回。默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。
# 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。
# 关于各属性的详细描述，参见下文出参。
# 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。
# @type FaceAttributesType: String
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入
# @type FaceModelVersion: String
attr_accessor :MaxFaceNum, :Image, :Url, :FaceAttributesType, :NeedRotateDetection, :FaceModelVersion
def initialize(maxfacenum=nil, image=nil, url=nil, faceattributestype=nil, needrotatedetection=nil, facemodelversion=nil)
@MaxFaceNum = maxfacenum
@Image = image
@Url = url
@FaceAttributesType = faceattributestype
@NeedRotateDetection = needrotatedetection
@FaceModelVersion = facemodelversion
end
def deserialize(params)
@MaxFaceNum = params['MaxFaceNum']
@Image = params['Image']
@Url = params['Url']
@FaceAttributesType = params['FaceAttributesType']
@NeedRotateDetection = params['NeedRotateDetection']
@FaceModelVersion = params['FaceModelVersion']
end
end
# DetectFaceAttributes返回参数结构体
class DetectFaceAttributesResponse < TencentCloud::Common::AbstractModel
# @param ImageWidth: 请求的图片宽度。
# @type ImageWidth: Integer
# @param ImageHeight: 请求的图片高度。
# @type ImageHeight: Integer
# @param FaceDetailInfos: 人脸信息列表。
# @type FaceDetailInfos: Array
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :ImageWidth, :ImageHeight, :FaceDetailInfos, :FaceModelVersion, :RequestId
def initialize(imagewidth=nil, imageheight=nil, facedetailinfos=nil, facemodelversion=nil, requestid=nil)
@ImageWidth = imagewidth
@ImageHeight = imageheight
@FaceDetailInfos = facedetailinfos
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@ImageWidth = params['ImageWidth']
@ImageHeight = params['ImageHeight']
unless params['FaceDetailInfos'].nil?
@FaceDetailInfos = []
params['FaceDetailInfos'].each do |i|
facedetailinfo_tmp = FaceDetailInfo.new
facedetailinfo_tmp.deserialize(i)
@FaceDetailInfos << facedetailinfo_tmp
end
end
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# DetectFace请求参数结构体
class DetectFaceRequest < TencentCloud::Common::AbstractModel
# @param MaxFaceNum: 最多处理的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。
# 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。
# @type MaxFaceNum: Integer
# @param MinFaceSize: 人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。
# 只支持设置34和20，建议使用34。
# @type MinFaceSize: Integer
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param NeedFaceAttributes: 是否需要返回人脸属性信息（FaceAttributesInfo）。0 为不需要返回，1 为需要返回。默认为 0。
# 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。
# 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。
# 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。
# @type NeedFaceAttributes: Integer
# @param NeedQualityDetection: 是否开启质量检测。0 为关闭，1 为开启。默认为 0。
# 非 1 值均视为不进行质量检测。
# 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。
# 建议：人脸入库操作建议开启此功能。
# @type NeedQualityDetection: Integer
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
# 目前入参支持 “2.0”和“3.0“ 两个输入。
# 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
# 2020年11月26日后开通服务的账号仅支持输入“3.0”。
# 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
# @type FaceModelVersion: String
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :MaxFaceNum, :MinFaceSize, :Image, :Url, :NeedFaceAttributes, :NeedQualityDetection, :FaceModelVersion, :NeedRotateDetection
def initialize(maxfacenum=nil, minfacesize=nil, image=nil, url=nil, needfaceattributes=nil, needqualitydetection=nil, facemodelversion=nil, needrotatedetection=nil)
@MaxFaceNum = maxfacenum
@MinFaceSize = minfacesize
@Image = image
@Url = url
@NeedFaceAttributes = needfaceattributes
@NeedQualityDetection = needqualitydetection
@FaceModelVersion = facemodelversion
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@MaxFaceNum = params['MaxFaceNum']
@MinFaceSize = params['MinFaceSize']
@Image = params['Image']
@Url = params['Url']
@NeedFaceAttributes = params['NeedFaceAttributes']
@NeedQualityDetection = params['NeedQualityDetection']
@FaceModelVersion = params['FaceModelVersion']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# DetectFace返回参数结构体
class DetectFaceResponse < TencentCloud::Common::AbstractModel
# @param ImageWidth: 请求的图片宽度。
# @type ImageWidth: Integer
# @param ImageHeight: 请求的图片高度。
# @type ImageHeight: Integer
# @param FaceInfos: 人脸信息列表。包含人脸坐标信息、属性信息（若需要）、质量分信息（若需要）。
# @type FaceInfos: Array
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :ImageWidth, :ImageHeight, :FaceInfos, :FaceModelVersion, :RequestId
def initialize(imagewidth=nil, imageheight=nil, faceinfos=nil, facemodelversion=nil, requestid=nil)
@ImageWidth = imagewidth
@ImageHeight = imageheight
@FaceInfos = faceinfos
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@ImageWidth = params['ImageWidth']
@ImageHeight = params['ImageHeight']
unless params['FaceInfos'].nil?
@FaceInfos = []
params['FaceInfos'].each do |i|
faceinfo_tmp = FaceInfo.new
faceinfo_tmp.deserialize(i)
@FaceInfos << faceinfo_tmp
end
end
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# DetectLiveFaceAccurate请求参数结构体
class DetectLiveFaceAccurateRequest < TencentCloud::Common::AbstractModel
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
# 图片的宽高比请接近 3:4，手机拍摄比例最佳。
# 人脸尺寸大于100X100像素。
# 图片格式支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片的宽高比请接近 3:4，手机拍摄比例最佳。
# 人脸尺寸大于100X100像素。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
# 图片格式支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。目前入参支持“3.0“。
# @type FaceModelVersion: String
attr_accessor :Image, :Url, :FaceModelVersion
def initialize(image=nil, url=nil, facemodelversion=nil)
@Image = image
@Url = url
@FaceModelVersion = facemodelversion
end
def deserialize(params)
@Image = params['Image']
@Url = params['Url']
@FaceModelVersion = params['FaceModelVersion']
end
end
# DetectLiveFaceAccurate返回参数结构体
class DetectLiveFaceAccurateResponse < TencentCloud::Common::AbstractModel
# @param Score: 活体打分，取值范围 [0,100]，根据活体分数对应的阈值区间来判断是否为翻拍。目前阈值可分为[5,10,40,70,90]，其中推荐阈值为40。
# @type Score: Float
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :Score, :FaceModelVersion, :RequestId
def initialize(score=nil, facemodelversion=nil, requestid=nil)
@Score = score
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@Score = params['Score']
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# DetectLiveFace请求参数结构体
class DetectLiveFaceRequest < TencentCloud::Common::AbstractModel
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。（图片的宽高比请接近3:4，不符合宽高比的图片返回的分值不具备参考意义）。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# （图片的宽高比请接近 3:4，不符合宽高比的图片返回的分值不具备参考意义）
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
# 目前入参支持 “2.0”和“3.0“ 两个输入。
# 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
# 2020年11月26日后开通服务的账号仅支持输入“3.0”。
# 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
# @type FaceModelVersion: String
attr_accessor :Image, :Url, :FaceModelVersion
def initialize(image=nil, url=nil, facemodelversion=nil)
@Image = image
@Url = url
@FaceModelVersion = facemodelversion
end
def deserialize(params)
@Image = params['Image']
@Url = params['Url']
@FaceModelVersion = params['FaceModelVersion']
end
end
# DetectLiveFace返回参数结构体
class DetectLiveFaceResponse < TencentCloud::Common::AbstractModel
# @param Score: 活体打分，取值范围 [0,100]，分数一般落于[80, 100]区间内，0分也为常见值。推荐相大于 87 时可判断为活体。可根据具体场景自行调整阈值。
# 本字段当且仅当FaceModelVersion为2.0时才具备参考意义。
# @type Score: Float
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param IsLiveness: 活体检测是否通过。
# 本字段只有FaceModelVersion为3.0时才具备参考意义。
# @type IsLiveness: Boolean
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :Score, :FaceModelVersion, :IsLiveness, :RequestId
def initialize(score=nil, facemodelversion=nil, isliveness=nil, requestid=nil)
@Score = score
@FaceModelVersion = facemodelversion
@IsLiveness = isliveness
@RequestId = requestid
end
def deserialize(params)
@Score = params['Score']
@FaceModelVersion = params['FaceModelVersion']
@IsLiveness = params['IsLiveness']
@RequestId = params['RequestId']
end
end
# 眼睛信息
class Eye < TencentCloud::Common::AbstractModel
# @param Glass: 识别是否佩戴眼镜。
# AttributeItem对应的Type为 —— 0：无眼镜，1：普通眼镜，2：墨镜
# @type Glass: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param EyeOpen: 识别眼睛的睁开、闭合状态。
# AttributeItem对应的Type为 —— 0：睁开，1：闭眼
# @type EyeOpen: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param EyelidType: 识别是否双眼皮。
# AttributeItem对应的Type为 —— 0：无，1：有。
# @type EyelidType: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param EyeSize: 眼睛大小。
# AttributeItem对应的Type为 —— 0：小眼睛，1：普通眼睛，2：大眼睛。
# @type EyeSize: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
attr_accessor :Glass, :EyeOpen, :EyelidType, :EyeSize
def initialize(glass=nil, eyeopen=nil, eyelidtype=nil, eyesize=nil)
@Glass = glass
@EyeOpen = eyeopen
@EyelidType = eyelidtype
@EyeSize = eyesize
end
def deserialize(params)
unless params['Glass'].nil?
@Glass = AttributeItem.new
@Glass.deserialize(params['Glass'])
end
unless params['EyeOpen'].nil?
@EyeOpen = AttributeItem.new
@EyeOpen.deserialize(params['EyeOpen'])
end
unless params['EyelidType'].nil?
@EyelidType = AttributeItem.new
@EyelidType.deserialize(params['EyelidType'])
end
unless params['EyeSize'].nil?
@EyeSize = AttributeItem.new
@EyeSize.deserialize(params['EyeSize'])
end
end
end
# 眉毛信息
class Eyebrow < TencentCloud::Common::AbstractModel
# @param EyebrowDensity: 眉毛浓密。
# AttributeItem对应的Type为 —— 0：淡眉，1：浓眉。
# @type EyebrowDensity: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param EyebrowCurve: 眉毛弯曲。
# AttributeItem对应的Type为 —— 0：不弯，1：弯眉。
# @type EyebrowCurve: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param EyebrowLength: 眉毛长短。
# AttributeItem对应的Type为 —— 0：短眉毛，1：长眉毛。
# @type EyebrowLength: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
attr_accessor :EyebrowDensity, :EyebrowCurve, :EyebrowLength
def initialize(eyebrowdensity=nil, eyebrowcurve=nil, eyebrowlength=nil)
@EyebrowDensity = eyebrowdensity
@EyebrowCurve = eyebrowcurve
@EyebrowLength = eyebrowlength
end
def deserialize(params)
unless params['EyebrowDensity'].nil?
@EyebrowDensity = AttributeItem.new
@EyebrowDensity.deserialize(params['EyebrowDensity'])
end
unless params['EyebrowCurve'].nil?
@EyebrowCurve = AttributeItem.new
@EyebrowCurve.deserialize(params['EyebrowCurve'])
end
unless params['EyebrowLength'].nil?
@EyebrowLength = AttributeItem.new
@EyebrowLength.deserialize(params['EyebrowLength'])
end
end
end
# 人脸属性信息，包含性别( gender )、年龄( age )、表情( expression )、
# 魅力( beauty )、眼镜( glass )、口罩（mask）、头发（hair）和姿态 (pitch，roll，yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息，最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。
class FaceAttributesInfo < TencentCloud::Common::AbstractModel
# @param Gender: 性别[0~49]为女性，[50，100]为男性，越接近0和100表示置信度越高。NeedFaceAttributes 不为 1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Gender: Integer
# @param Age: 年龄 [0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Age: Integer
# @param Expression: 微笑[0(normal，正常)~100(laugh，大笑)]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Expression: Integer
# @param Glass: 是否有眼镜 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Glass: Boolean
# @param Pitch: 上下偏移[-30,30]，单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# 建议：人脸入库选择[-10,10]的图片。
# @type Pitch: Integer
# @param Yaw: 左右偏移[-30,30]，单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# 建议：人脸入库选择[-10,10]的图片。
# @type Yaw: Integer
# @param Roll: 平面旋转[-180,180]，单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# 建议：人脸入库选择[-20,20]的图片。
# @type Roll: Integer
# @param Beauty: 魅力[0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Beauty: Integer
# @param Hat: 是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Hat: Boolean
# @param Mask: 是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Mask: Boolean
# @param Hair: 头发信息，包含头发长度（length）、有无刘海（bang）、头发颜色（color）。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Hair: :class:`Tencentcloud::Iai.v20200303.models.FaceHairAttributesInfo`
# @param EyeOpen: 双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼，就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type EyeOpen: Boolean
attr_accessor :Gender, :Age, :Expression, :Glass, :Pitch, :Yaw, :Roll, :Beauty, :Hat, :Mask, :Hair, :EyeOpen
def initialize(gender=nil, age=nil, expression=nil, glass=nil, pitch=nil, yaw=nil, roll=nil, beauty=nil, hat=nil, mask=nil, hair=nil, eyeopen=nil)
@Gender = gender
@Age = age
@Expression = expression
@Glass = glass
@Pitch = pitch
@Yaw = yaw
@Roll = roll
@Beauty = beauty
@Hat = hat
@Mask = mask
@Hair = hair
@EyeOpen = eyeopen
end
def deserialize(params)
@Gender = params['Gender']
@Age = params['Age']
@Expression = params['Expression']
@Glass = params['Glass']
@Pitch = params['Pitch']
@Yaw = params['Yaw']
@Roll = params['Roll']
@Beauty = params['Beauty']
@Hat = params['Hat']
@Mask = params['Mask']
unless params['Hair'].nil?
@Hair = FaceHairAttributesInfo.new
@Hair.deserialize(params['Hair'])
end
@EyeOpen = params['EyeOpen']
end
end
# 人脸属性信息，根据 FaceAttributesType 输入的类型，返回年龄（Age）、颜值（Beauty）
# 情绪（Emotion）、眼睛信息（Eye）、眉毛（Eyebrow）、性别（Gender）
# 头发（Hair）、帽子（Hat）、姿态（Headpose）、口罩（Mask）、嘴巴（Mouth）、胡子（Moustache）
# 鼻子（Nose）、脸型（Shape）、肤色（Skin）、微笑（Smile）等人脸属性信息。
# 若 FaceAttributesType 没有输入相关类型，则FaceDetaiAttributesInfo返回的细项不具备参考意义。
class FaceDetailAttributesInfo < TencentCloud::Common::AbstractModel
# @param Age: 年龄 [0,65]，其中65代表“65岁及以上”。
# FaceAttributesType 不含Age 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Age: Integer
# @param Beauty: 美丑打分[0,100]。
# FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Beauty: Integer
# @param Emotion: 情绪，可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
# AttributeItem对应的Type为 —— 0：自然，1：高兴，2：惊讶，3：生气，4：悲伤，5：厌恶，6：害怕
# FaceAttributesType 不含Emotion 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Emotion: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param Eye: 眼睛相关信息，可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
# FaceAttributesType 不含Eye 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Eye: :class:`Tencentcloud::Iai.v20200303.models.Eye`
# @param Eyebrow: 眉毛相关信息，可识别眉毛浓密、弯曲、长短信息。
# FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Eyebrow: :class:`Tencentcloud::Iai.v20200303.models.Eyebrow`
# @param Gender: 性别信息。
# AttributeItem对应的Type为 —— 0：男性，1：女性。
# FaceAttributesType 不含Gender 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Gender: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param Hair: 头发信息，包含头发长度、有无刘海、头发颜色。
# FaceAttributesType 不含Hair 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Hair: :class:`Tencentcloud::Iai.v20200303.models.Hair`
# @param Hat: 帽子信息，可识别是否佩戴帽子、帽子款式、帽子颜色。
# FaceAttributesType 不含Hat 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Hat: :class:`Tencentcloud::Iai.v20200303.models.Hat`
# @param HeadPose: 姿态信息，包含人脸的上下偏移、左右偏移、平面旋转信息。
# FaceAttributesType 不含Headpose 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type HeadPose: :class:`Tencentcloud::Iai.v20200303.models.HeadPose`
# @param Mask: 口罩佩戴信息。
# AttributeItem对应的Type为 —— 0: 无口罩， 1: 有口罩不遮脸，2: 有口罩遮下巴，3: 有口罩遮嘴，4: 正确佩戴口罩。
# FaceAttributesType 不含Mask 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Mask: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param Mouth: 嘴巴信息，可识别是否张嘴、嘴唇厚度。
# FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Mouth: :class:`Tencentcloud::Iai.v20200303.models.Mouth`
# @param Moustache: 胡子信息。
# AttributeItem对应的Type为 —— 0：无胡子，1：有胡子。
# FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Moustache: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param Nose: 鼻子信息。
# AttributeItem对应的Type为 —— 0：朝天鼻，1：鹰钩鼻，2：普通，3：圆鼻头
# FaceAttributesType 不含 Nose 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Nose: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param Shape: 脸型信息。
# AttributeItem对应的Type为 —— 0：方脸，1：三角脸，2：鹅蛋脸，3：心形脸，4：圆脸。
# FaceAttributesType 不含 Shape 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Shape: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param Skin: 肤色信息。
# AttributeItem对应的Type为 —— 0：黄色皮肤，1：棕色皮肤，2：黑色皮肤，3：白色皮肤。
# FaceAttributesType 不含 Skin 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Skin: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param Smile: 微笑程度，[0,100]。
# FaceAttributesType 不含 Smile 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
# @type Smile: Integer
attr_accessor :Age, :Beauty, :Emotion, :Eye, :Eyebrow, :Gender, :Hair, :Hat, :HeadPose, :Mask, :Mouth, :Moustache, :Nose, :Shape, :Skin, :Smile
def initialize(age=nil, beauty=nil, emotion=nil, eye=nil, eyebrow=nil, gender=nil, hair=nil, hat=nil, headpose=nil, mask=nil, mouth=nil, moustache=nil, nose=nil, shape=nil, skin=nil, smile=nil)
@Age = age
@Beauty = beauty
@Emotion = emotion
@Eye = eye
@Eyebrow = eyebrow
@Gender = gender
@Hair = hair
@Hat = hat
@HeadPose = headpose
@Mask = mask
@Mouth = mouth
@Moustache = moustache
@Nose = nose
@Shape = shape
@Skin = skin
@Smile = smile
end
def deserialize(params)
@Age = params['Age']
@Beauty = params['Beauty']
unless params['Emotion'].nil?
@Emotion = AttributeItem.new
@Emotion.deserialize(params['Emotion'])
end
unless params['Eye'].nil?
@Eye = Eye.new
@Eye.deserialize(params['Eye'])
end
unless params['Eyebrow'].nil?
@Eyebrow = Eyebrow.new
@Eyebrow.deserialize(params['Eyebrow'])
end
unless params['Gender'].nil?
@Gender = AttributeItem.new
@Gender.deserialize(params['Gender'])
end
unless params['Hair'].nil?
@Hair = Hair.new
@Hair.deserialize(params['Hair'])
end
unless params['Hat'].nil?
@Hat = Hat.new
@Hat.deserialize(params['Hat'])
end
unless params['HeadPose'].nil?
@HeadPose = HeadPose.new
@HeadPose.deserialize(params['HeadPose'])
end
unless params['Mask'].nil?
@Mask = AttributeItem.new
@Mask.deserialize(params['Mask'])
end
unless params['Mouth'].nil?
@Mouth = Mouth.new
@Mouth.deserialize(params['Mouth'])
end
unless params['Moustache'].nil?
@Moustache = AttributeItem.new
@Moustache.deserialize(params['Moustache'])
end
unless params['Nose'].nil?
@Nose = AttributeItem.new
@Nose.deserialize(params['Nose'])
end
unless params['Shape'].nil?
@Shape = AttributeItem.new
@Shape.deserialize(params['Shape'])
end
unless params['Skin'].nil?
@Skin = AttributeItem.new
@Skin.deserialize(params['Skin'])
end
@Smile = params['Smile']
end
end
# 人脸信息列表。
class FaceDetailInfo < TencentCloud::Common::AbstractModel
# @param FaceRect: 检测出的人脸框位置。
# @type FaceRect: :class:`Tencentcloud::Iai.v20200303.models.FaceRect`
# @param FaceDetailAttributesInfo: 人脸属性信息，根据 FaceAttributesType 输入的类型，返回年龄（Age）、颜值（Beauty）
# 情绪（Emotion）、眼睛信息（Eye）、眉毛（Eyebrow）、性别（Gender）
# 头发（Hair）、帽子（Hat）、姿态（Headpose）、口罩（Mask）、嘴巴（Mouth）、胡子（Moustache）
# 鼻子（Nose）、脸型（Shape）、肤色（Skin）、微笑（Smile）等人脸属性信息。
# 若 FaceAttributesType 没有输入相关类型，则FaceDetaiAttributesInfo返回的细项不具备参考意义。
# @type FaceDetailAttributesInfo: :class:`Tencentcloud::Iai.v20200303.models.FaceDetailAttributesInfo`
attr_accessor :FaceRect, :FaceDetailAttributesInfo
def initialize(facerect=nil, facedetailattributesinfo=nil)
@FaceRect = facerect
@FaceDetailAttributesInfo = facedetailattributesinfo
end
def deserialize(params)
unless params['FaceRect'].nil?
@FaceRect = FaceRect.new
@FaceRect.deserialize(params['FaceRect'])
end
unless params['FaceDetailAttributesInfo'].nil?
@FaceDetailAttributesInfo = FaceDetailAttributesInfo.new
@FaceDetailAttributesInfo.deserialize(params['FaceDetailAttributesInfo'])
end
end
end
# 人脸属性中的发型信息。
class FaceHairAttributesInfo < TencentCloud::Common::AbstractModel
# @param Length: 0：光头，1：短发，2：中发，3：长发，4：绑发
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Length: Integer
# @param Bang: 0：有刘海，1：无刘海
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Bang: Integer
# @param Color: 0：黑色，1：金色，2：棕色，3：灰白色
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Color: Integer
attr_accessor :Length, :Bang, :Color
def initialize(length=nil, bang=nil, color=nil)
@Length = length
@Bang = bang
@Color = color
end
def deserialize(params)
@Length = params['Length']
@Bang = params['Bang']
@Color = params['Color']
end
end
# 人脸信息列表。
class FaceInfo < TencentCloud::Common::AbstractModel
# @param X: 人脸框左上角横坐标。
# 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。
# 若需截取完整人脸，可以在完整分completeness满足需求的情况下，将负值坐标取0。
# @type X: Integer
# @param Y: 人脸框左上角纵坐标。
# 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。
# 若需截取完整人脸，可以在完整分completeness满足需求的情况下，将负值坐标取0。
# @type Y: Integer
# @param Width: 人脸框宽度。
# @type Width: Integer
# @param Height: 人脸框高度。
# @type Height: Integer
# @param FaceAttributesInfo: 人脸属性信息，包含性别( gender )、年龄( age )、表情( expression )、
# 魅力( beauty )、眼镜( glass )、口罩（mask）、头发（hair）和姿态 (pitch，roll，yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
# @type FaceAttributesInfo: :class:`Tencentcloud::Iai.v20200303.models.FaceAttributesInfo`
# @param FaceQualityInfo: 人脸质量信息，包含质量分（score）、模糊分（sharpness）、光照分（brightness）、遮挡分（completeness）。只有当NeedFaceDetection设为1时才返回有效信息。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type FaceQualityInfo: :class:`Tencentcloud::Iai.v20200303.models.FaceQualityInfo`
attr_accessor :X, :Y, :Width, :Height, :FaceAttributesInfo, :FaceQualityInfo
def initialize(x=nil, y=nil, width=nil, height=nil, faceattributesinfo=nil, facequalityinfo=nil)
@X = x
@Y = y
@Width = width
@Height = height
@FaceAttributesInfo = faceattributesinfo
@FaceQualityInfo = facequalityinfo
end
def deserialize(params)
@X = params['X']
@Y = params['Y']
@Width = params['Width']
@Height = params['Height']
unless params['FaceAttributesInfo'].nil?
@FaceAttributesInfo = FaceAttributesInfo.new
@FaceAttributesInfo.deserialize(params['FaceAttributesInfo'])
end
unless params['FaceQualityInfo'].nil?
@FaceQualityInfo = FaceQualityInfo.new
@FaceQualityInfo.deserialize(params['FaceQualityInfo'])
end
end
end
# 五官遮挡分，评价眉毛（Eyebrow）、眼睛（Eye）、鼻子（Nose）、脸颊（Cheek）、嘴巴（Mouth）、下巴（Chin）的被遮挡程度。
class FaceQualityCompleteness < TencentCloud::Common::AbstractModel
# @param Eyebrow: 眉毛的遮挡分数[0,100]，分数越高遮挡越少。
# 参考范围：[0,80]表示发生遮挡。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Eyebrow: Integer
# @param Eye: 眼睛的遮挡分数[0,100],分数越高遮挡越少。
# 参考范围：[0,80]表示发生遮挡。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Eye: Integer
# @param Nose: 鼻子的遮挡分数[0,100],分数越高遮挡越少。
# 参考范围：[0,60]表示发生遮挡。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Nose: Integer
# @param Cheek: 脸颊的遮挡分数[0,100],分数越高遮挡越少。
# 参考范围：[0,70]表示发生遮挡。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Cheek: Integer
# @param Mouth: 嘴巴的遮挡分数[0,100],分数越高遮挡越少。
# 参考范围：[0,50]表示发生遮挡。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Mouth: Integer
# @param Chin: 下巴的遮挡分数[0,100],分数越高遮挡越少。
# 参考范围：[0,70]表示发生遮挡。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Chin: Integer
attr_accessor :Eyebrow, :Eye, :Nose, :Cheek, :Mouth, :Chin
def initialize(eyebrow=nil, eye=nil, nose=nil, cheek=nil, mouth=nil, chin=nil)
@Eyebrow = eyebrow
@Eye = eye
@Nose = nose
@Cheek = cheek
@Mouth = mouth
@Chin = chin
end
def deserialize(params)
@Eyebrow = params['Eyebrow']
@Eye = params['Eye']
@Nose = params['Nose']
@Cheek = params['Cheek']
@Mouth = params['Mouth']
@Chin = params['Chin']
end
end
# 人脸质量信息，包含质量分（score）、模糊分（sharpness）、光照分（brightness）、遮挡分（completeness）。只有当NeedFaceDetection设为1时才返回有效信息。
class FaceQualityInfo < TencentCloud::Common::AbstractModel
# @param Score: 质量分: [0,100]，综合评价图像质量是否适合人脸识别，分数越高质量越好。
# 正常情况，只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
# 参考范围：[0,40]较差，[40,60] 一般，[60,80]较好，[80,100]很好。
# 建议：人脸入库选取70以上的图片。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Score: Integer
# @param Sharpness: 清晰分：[0,100]，评价图片清晰程度，分数越高越清晰。
# 参考范围：[0,40]特别模糊，[40,60]模糊，[60,80]一般，[80,100]清晰。
# 建议：人脸入库选取80以上的图片。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Sharpness: Integer
# @param Brightness: 光照分：[0,100]，评价图片光照程度，分数越高越亮。
# 参考范围： [0,30]偏暗，[30,70]光照正常，[70,100]偏亮。
# 建议：人脸入库选取[30,70]的图片。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Brightness: Integer
# @param Completeness: 五官遮挡分，评价眉毛（Eyebrow）、眼睛（Eye）、鼻子（Nose）、脸颊（Cheek）、嘴巴（Mouth）、下巴（Chin）的被遮挡程度。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Completeness: :class:`Tencentcloud::Iai.v20200303.models.FaceQualityCompleteness`
attr_accessor :Score, :Sharpness, :Brightness, :Completeness
def initialize(score=nil, sharpness=nil, brightness=nil, completeness=nil)
@Score = score
@Sharpness = sharpness
@Brightness = brightness
@Completeness = completeness
end
def deserialize(params)
@Score = params['Score']
@Sharpness = params['Sharpness']
@Brightness = params['Brightness']
unless params['Completeness'].nil?
@Completeness = FaceQualityCompleteness.new
@Completeness.deserialize(params['Completeness'])
end
end
end
# 检测出的人脸框的位置
class FaceRect < TencentCloud::Common::AbstractModel
# @param X: 人脸框左上角横坐标。
# 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。
# 若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。
# @type X: Integer
# @param Y: 人脸框左上角纵坐标。
# 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。
# 若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。
# @type Y: Integer
# @param Width: 人脸宽度
# @type Width: Integer
# @param Height: 人脸高度
# @type Height: Integer
attr_accessor :X, :Y, :Width, :Height
def initialize(x=nil, y=nil, width=nil, height=nil)
@X = x
@Y = y
@Width = width
@Height = height
end
def deserialize(params)
@X = params['X']
@Y = params['Y']
@Width = params['Width']
@Height = params['Height']
end
end
# 五官定位（人脸关键点）具体信息。
class FaceShape < TencentCloud::Common::AbstractModel
# @param FaceProfile: 描述脸型轮廓的 21 点。
# @type FaceProfile: Array
# @param LeftEye: 描述左侧眼睛轮廓的 8 点。
# @type LeftEye: Array
# @param RightEye: 描述右侧眼睛轮廓的 8 点。
# @type RightEye: Array
# @param LeftEyeBrow: 描述左侧眉毛轮廓的 8 点。
# @type LeftEyeBrow: Array
# @param RightEyeBrow: 描述右侧眉毛轮廓的 8 点。
# @type RightEyeBrow: Array
# @param Mouth: 描述嘴巴轮廓的 22 点。
# @type Mouth: Array
# @param Nose: 描述鼻子轮廓的 13 点。
# @type Nose: Array
# @param LeftPupil: 左瞳孔轮廓的 1 个点。
# @type LeftPupil: Array
# @param RightPupil: 右瞳孔轮廓的 1 个点。
# @type RightPupil: Array
attr_accessor :FaceProfile, :LeftEye, :RightEye, :LeftEyeBrow, :RightEyeBrow, :Mouth, :Nose, :LeftPupil, :RightPupil
def initialize(faceprofile=nil, lefteye=nil, righteye=nil, lefteyebrow=nil, righteyebrow=nil, mouth=nil, nose=nil, leftpupil=nil, rightpupil=nil)
@FaceProfile = faceprofile
@LeftEye = lefteye
@RightEye = righteye
@LeftEyeBrow = lefteyebrow
@RightEyeBrow = righteyebrow
@Mouth = mouth
@Nose = nose
@LeftPupil = leftpupil
@RightPupil = rightpupil
end
def deserialize(params)
unless params['FaceProfile'].nil?
@FaceProfile = []
params['FaceProfile'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@FaceProfile << point_tmp
end
end
unless params['LeftEye'].nil?
@LeftEye = []
params['LeftEye'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@LeftEye << point_tmp
end
end
unless params['RightEye'].nil?
@RightEye = []
params['RightEye'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@RightEye << point_tmp
end
end
unless params['LeftEyeBrow'].nil?
@LeftEyeBrow = []
params['LeftEyeBrow'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@LeftEyeBrow << point_tmp
end
end
unless params['RightEyeBrow'].nil?
@RightEyeBrow = []
params['RightEyeBrow'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@RightEyeBrow << point_tmp
end
end
unless params['Mouth'].nil?
@Mouth = []
params['Mouth'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@Mouth << point_tmp
end
end
unless params['Nose'].nil?
@Nose = []
params['Nose'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@Nose << point_tmp
end
end
unless params['LeftPupil'].nil?
@LeftPupil = []
params['LeftPupil'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@LeftPupil << point_tmp
end
end
unless params['RightPupil'].nil?
@RightPupil = []
params['RightPupil'].each do |i|
point_tmp = Point.new
point_tmp.deserialize(i)
@RightPupil << point_tmp
end
end
end
end
# GetGroupInfo请求参数结构体
class GetGroupInfoRequest < TencentCloud::Common::AbstractModel
# @param GroupId: 人员库 ID，取值为创建人员库接口中的GroupId
# @type GroupId: String
attr_accessor :GroupId
def initialize(groupid=nil)
@GroupId = groupid
end
def deserialize(params)
@GroupId = params['GroupId']
end
end
# GetGroupInfo返回参数结构体
class GetGroupInfoResponse < TencentCloud::Common::AbstractModel
# @param GroupName: 人员库名称
# @type GroupName: String
# @param GroupId: 人员库ID
# @type GroupId: String
# @param GroupExDescriptions: 人员库自定义描述字段
# @type GroupExDescriptions: Array
# @param Tag: 人员库信息备注
# @type Tag: String
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param CreationTimestamp: Group的创建时间和日期。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
# @type CreationTimestamp: Integer
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :GroupName, :GroupId, :GroupExDescriptions, :Tag, :FaceModelVersion, :CreationTimestamp, :RequestId
def initialize(groupname=nil, groupid=nil, groupexdescriptions=nil, tag=nil, facemodelversion=nil, creationtimestamp=nil, requestid=nil)
@GroupName = groupname
@GroupId = groupid
@GroupExDescriptions = groupexdescriptions
@Tag = tag
@FaceModelVersion = facemodelversion
@CreationTimestamp = creationtimestamp
@RequestId = requestid
end
def deserialize(params)
@GroupName = params['GroupName']
@GroupId = params['GroupId']
@GroupExDescriptions = params['GroupExDescriptions']
@Tag = params['Tag']
@FaceModelVersion = params['FaceModelVersion']
@CreationTimestamp = params['CreationTimestamp']
@RequestId = params['RequestId']
end
end
# GetGroupList请求参数结构体
class GetGroupListRequest < TencentCloud::Common::AbstractModel
# @param Offset: 起始序号，默认值为0
# @type Offset: Integer
# @param Limit: 返回数量，默认值为10，最大值为1000
# @type Limit: Integer
attr_accessor :Offset, :Limit
def initialize(offset=nil, limit=nil)
@Offset = offset
@Limit = limit
end
def deserialize(params)
@Offset = params['Offset']
@Limit = params['Limit']
end
end
# GetGroupList返回参数结构体
class GetGroupListResponse < TencentCloud::Common::AbstractModel
# @param GroupInfos: 返回的人员库信息
# @type GroupInfos: Array
# @param GroupNum: 人员库总数量
# 注意：此字段可能返回 null，表示取不到有效值。
# @type GroupNum: Integer
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :GroupInfos, :GroupNum, :RequestId
def initialize(groupinfos=nil, groupnum=nil, requestid=nil)
@GroupInfos = groupinfos
@GroupNum = groupnum
@RequestId = requestid
end
def deserialize(params)
unless params['GroupInfos'].nil?
@GroupInfos = []
params['GroupInfos'].each do |i|
groupinfo_tmp = GroupInfo.new
groupinfo_tmp.deserialize(i)
@GroupInfos << groupinfo_tmp
end
end
@GroupNum = params['GroupNum']
@RequestId = params['RequestId']
end
end
# GetPersonBaseInfo请求参数结构体
class GetPersonBaseInfoRequest < TencentCloud::Common::AbstractModel
# @param PersonId: 人员ID，创建人员接口中的PersonId
# @type PersonId: String
attr_accessor :PersonId
def initialize(personid=nil)
@PersonId = personid
end
def deserialize(params)
@PersonId = params['PersonId']
end
end
# GetPersonBaseInfo返回参数结构体
class GetPersonBaseInfoResponse < TencentCloud::Common::AbstractModel
# @param PersonName: 人员名称
# @type PersonName: String
# @param Gender: 人员性别，0代表未填写，1代表男性，2代表女性
# @type Gender: Integer
# @param FaceIds: 包含的人脸 ID 列表
# @type FaceIds: Array
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :PersonName, :Gender, :FaceIds, :RequestId
def initialize(personname=nil, gender=nil, faceids=nil, requestid=nil)
@PersonName = personname
@Gender = gender
@FaceIds = faceids
@RequestId = requestid
end
def deserialize(params)
@PersonName = params['PersonName']
@Gender = params['Gender']
@FaceIds = params['FaceIds']
@RequestId = params['RequestId']
end
end
# GetPersonGroupInfo请求参数结构体
class GetPersonGroupInfoRequest < TencentCloud::Common::AbstractModel
# @param PersonId: 人员ID，取值为创建人员接口中的PersonId
# @type PersonId: String
# @param Offset: 起始序号，默认值为0
# @type Offset: Integer
# @param Limit: 返回数量，默认值为10，最大值为100
# @type Limit: Integer
attr_accessor :PersonId, :Offset, :Limit
def initialize(personid=nil, offset=nil, limit=nil)
@PersonId = personid
@Offset = offset
@Limit = limit
end
def deserialize(params)
@PersonId = params['PersonId']
@Offset = params['Offset']
@Limit = params['Limit']
end
end
# GetPersonGroupInfo返回参数结构体
class GetPersonGroupInfoResponse < TencentCloud::Common::AbstractModel
# @param PersonGroupInfos: 包含此人员的人员库及描述字段内容列表
# @type PersonGroupInfos: Array
# @param GroupNum: 人员库总数量
# 注意：此字段可能返回 null，表示取不到有效值。
# @type GroupNum: Integer
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :PersonGroupInfos, :GroupNum, :FaceModelVersion, :RequestId
def initialize(persongroupinfos=nil, groupnum=nil, facemodelversion=nil, requestid=nil)
@PersonGroupInfos = persongroupinfos
@GroupNum = groupnum
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
unless params['PersonGroupInfos'].nil?
@PersonGroupInfos = []
params['PersonGroupInfos'].each do |i|
persongroupinfo_tmp = PersonGroupInfo.new
persongroupinfo_tmp.deserialize(i)
@PersonGroupInfos << persongroupinfo_tmp
end
end
@GroupNum = params['GroupNum']
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# GetPersonListNum请求参数结构体
class GetPersonListNumRequest < TencentCloud::Common::AbstractModel
# @param GroupId: 人员库ID，取值为创建人员库接口中的GroupId
# @type GroupId: String
attr_accessor :GroupId
def initialize(groupid=nil)
@GroupId = groupid
end
def deserialize(params)
@GroupId = params['GroupId']
end
end
# GetPersonListNum返回参数结构体
class GetPersonListNumResponse < TencentCloud::Common::AbstractModel
# @param PersonNum: 人员数量
# @type PersonNum: Integer
# @param FaceNum: 人脸数量
# @type FaceNum: Integer
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :PersonNum, :FaceNum, :RequestId
def initialize(personnum=nil, facenum=nil, requestid=nil)
@PersonNum = personnum
@FaceNum = facenum
@RequestId = requestid
end
def deserialize(params)
@PersonNum = params['PersonNum']
@FaceNum = params['FaceNum']
@RequestId = params['RequestId']
end
end
# GetPersonList请求参数结构体
class GetPersonListRequest < TencentCloud::Common::AbstractModel
# @param GroupId: 人员库ID，取值为创建人员库接口中的GroupId
# @type GroupId: String
# @param Offset: 起始序号，默认值为0
# @type Offset: Integer
# @param Limit: 返回数量，默认值为10，最大值为1000
# @type Limit: Integer
attr_accessor :GroupId, :Offset, :Limit
def initialize(groupid=nil, offset=nil, limit=nil)
@GroupId = groupid
@Offset = offset
@Limit = limit
end
def deserialize(params)
@GroupId = params['GroupId']
@Offset = params['Offset']
@Limit = params['Limit']
end
end
# GetPersonList返回参数结构体
class GetPersonListResponse < TencentCloud::Common::AbstractModel
# @param PersonInfos: 返回的人员信息
# @type PersonInfos: Array
# @param PersonNum: 该人员库的人员数量
# 注意：此字段可能返回 null，表示取不到有效值。
# @type PersonNum: Integer
# @param FaceNum: 该人员库的人脸数量
# 注意：此字段可能返回 null，表示取不到有效值。
# @type FaceNum: Integer
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :PersonInfos, :PersonNum, :FaceNum, :FaceModelVersion, :RequestId
def initialize(personinfos=nil, personnum=nil, facenum=nil, facemodelversion=nil, requestid=nil)
@PersonInfos = personinfos
@PersonNum = personnum
@FaceNum = facenum
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
unless params['PersonInfos'].nil?
@PersonInfos = []
params['PersonInfos'].each do |i|
personinfo_tmp = PersonInfo.new
personinfo_tmp.deserialize(i)
@PersonInfos << personinfo_tmp
end
end
@PersonNum = params['PersonNum']
@FaceNum = params['FaceNum']
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# GetUpgradeGroupFaceModelVersionJobList请求参数结构体
class GetUpgradeGroupFaceModelVersionJobListRequest < TencentCloud::Common::AbstractModel
# @param Offset: 起始序号，默认值为0。
# @type Offset: Integer
# @param Limit: 返回数量，默认值为10，最大值为1000。
# @type Limit: Integer
attr_accessor :Offset, :Limit
def initialize(offset=nil, limit=nil)
@Offset = offset
@Limit = limit
end
def deserialize(params)
@Offset = params['Offset']
@Limit = params['Limit']
end
end
# GetUpgradeGroupFaceModelVersionJobList返回参数结构体
class GetUpgradeGroupFaceModelVersionJobListResponse < TencentCloud::Common::AbstractModel
# @param JobInfos: 人员库升级任务信息列表。
# @type JobInfos: Array
# @param JobNum: 升级任务总数量。
# @type JobNum: Integer
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :JobInfos, :JobNum, :RequestId
def initialize(jobinfos=nil, jobnum=nil, requestid=nil)
@JobInfos = jobinfos
@JobNum = jobnum
@RequestId = requestid
end
def deserialize(params)
unless params['JobInfos'].nil?
@JobInfos = []
params['JobInfos'].each do |i|
upgradejobinfo_tmp = UpgradeJobInfo.new
upgradejobinfo_tmp.deserialize(i)
@JobInfos << upgradejobinfo_tmp
end
end
@JobNum = params['JobNum']
@RequestId = params['RequestId']
end
end
# GetUpgradeGroupFaceModelVersionResult请求参数结构体
class GetUpgradeGroupFaceModelVersionResultRequest < TencentCloud::Common::AbstractModel
# @param JobId: 升级任务ID，用于查询、获取人员库升级的进度和结果。
# @type JobId: String
attr_accessor :JobId
def initialize(jobid=nil)
@JobId = jobid
end
def deserialize(params)
@JobId = params['JobId']
end
end
# GetUpgradeGroupFaceModelVersionResult返回参数结构体
class GetUpgradeGroupFaceModelVersionResultResponse < TencentCloud::Common::AbstractModel
# @param EndTimestamp: 人员升级任务预估结束时间。 StartTimestamp的值是自 Unix 纪元时间到人员查重任务预估结束的毫秒数。
# Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。
# 如果为0表示这个任务已经执行完毕。
# @type EndTimestamp: Integer
# @param Progress: 升级任务完成进度。取值[0.0，100.0]。
# @type Progress: Float
# @param Status: 0表示升级中，1表示升级完毕，2表示回滚完毕，3表示升级失败。
# @type Status: Integer
# @param StartTime: 升级起始时间。
# StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
# Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。
# 有关更多信息，请参阅 Unix 时间。
# @type StartTime: Integer
# @param FromFaceModelVersion: 当前算法模型版本。
# @type FromFaceModelVersion: String
# @param ToFaceModelVersion: 目标算法模型版本。
# @type ToFaceModelVersion: String
# @param GroupId: 人员库ID。
# @type GroupId: String
# @param FailedFacesUrl: 无法升级的人脸Id信息，文件格式为json。内容参见下方示例。url有效期为半小时。
# @type FailedFacesUrl: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :EndTimestamp, :Progress, :Status, :StartTime, :FromFaceModelVersion, :ToFaceModelVersion, :GroupId, :FailedFacesUrl, :RequestId
def initialize(endtimestamp=nil, progress=nil, status=nil, starttime=nil, fromfacemodelversion=nil, tofacemodelversion=nil, groupid=nil, failedfacesurl=nil, requestid=nil)
@EndTimestamp = endtimestamp
@Progress = progress
@Status = status
@StartTime = starttime
@FromFaceModelVersion = fromfacemodelversion
@ToFaceModelVersion = tofacemodelversion
@GroupId = groupid
@FailedFacesUrl = failedfacesurl
@RequestId = requestid
end
def deserialize(params)
@EndTimestamp = params['EndTimestamp']
@Progress = params['Progress']
@Status = params['Status']
@StartTime = params['StartTime']
@FromFaceModelVersion = params['FromFaceModelVersion']
@ToFaceModelVersion = params['ToFaceModelVersion']
@GroupId = params['GroupId']
@FailedFacesUrl = params['FailedFacesUrl']
@RequestId = params['RequestId']
end
end
# 分组识别结果Item
class GroupCandidate < TencentCloud::Common::AbstractModel
# @param GroupId: 人员库ID 。
# @type GroupId: String
# @param Candidates: 识别出的最相似候选人。
# @type Candidates: Array
attr_accessor :GroupId, :Candidates
def initialize(groupid=nil, candidates=nil)
@GroupId = groupid
@Candidates = candidates
end
def deserialize(params)
@GroupId = params['GroupId']
unless params['Candidates'].nil?
@Candidates = []
params['Candidates'].each do |i|
candidate_tmp = Candidate.new
candidate_tmp.deserialize(i)
@Candidates << candidate_tmp
end
end
end
end
# 需要修改的人员库自定义描述字段key-value
class GroupExDescriptionInfo < TencentCloud::Common::AbstractModel
# @param GroupExDescriptionIndex: 人员库自定义描述字段Index，从0开始
# @type GroupExDescriptionIndex: Integer
# @param GroupExDescription: 需要更新的人员库自定义描述字段内容
# @type GroupExDescription: String
attr_accessor :GroupExDescriptionIndex, :GroupExDescription
def initialize(groupexdescriptionindex=nil, groupexdescription=nil)
@GroupExDescriptionIndex = groupexdescriptionindex
@GroupExDescription = groupexdescription
end
def deserialize(params)
@GroupExDescriptionIndex = params['GroupExDescriptionIndex']
@GroupExDescription = params['GroupExDescription']
end
end
# 返回的人员库信息
class GroupInfo < TencentCloud::Common::AbstractModel
# @param GroupName: 人员库名称
# @type GroupName: String
# @param GroupId: 人员库ID
# @type GroupId: String
# @param GroupExDescriptions: 人员库自定义描述字段
# 注意：此字段可能返回 null，表示取不到有效值。
# @type GroupExDescriptions: Array
# @param Tag: 人员库信息备注
# 注意：此字段可能返回 null，表示取不到有效值。
# @type Tag: String
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type FaceModelVersion: String
# @param CreationTimestamp: Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
# Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。有关更多信息，请参阅 Unix 时间。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type CreationTimestamp: Integer
attr_accessor :GroupName, :GroupId, :GroupExDescriptions, :Tag, :FaceModelVersion, :CreationTimestamp
def initialize(groupname=nil, groupid=nil, groupexdescriptions=nil, tag=nil, facemodelversion=nil, creationtimestamp=nil)
@GroupName = groupname
@GroupId = groupid
@GroupExDescriptions = groupexdescriptions
@Tag = tag
@FaceModelVersion = facemodelversion
@CreationTimestamp = creationtimestamp
end
def deserialize(params)
@GroupName = params['GroupName']
@GroupId = params['GroupId']
@GroupExDescriptions = params['GroupExDescriptions']
@Tag = params['Tag']
@FaceModelVersion = params['FaceModelVersion']
@CreationTimestamp = params['CreationTimestamp']
end
end
# 头发信息
class Hair < TencentCloud::Common::AbstractModel
# @param Length: 头发长度信息。
# AttributeItem对应的Type为 —— 0：光头，1：短发，2：中发，3：长发，4：绑发。
# @type Length: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param Bang: 刘海信息。
# AttributeItem对应的Type为 —— 0：无刘海，1：有刘海。
# @type Bang: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param Color: 头发颜色信息。
# AttributeItem对应的Type为 —— 0：黑色，1：金色，2：棕色，3：灰白色。
# @type Color: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
attr_accessor :Length, :Bang, :Color
def initialize(length=nil, bang=nil, color=nil)
@Length = length
@Bang = bang
@Color = color
end
def deserialize(params)
unless params['Length'].nil?
@Length = AttributeItem.new
@Length.deserialize(params['Length'])
end
unless params['Bang'].nil?
@Bang = AttributeItem.new
@Bang.deserialize(params['Bang'])
end
unless params['Color'].nil?
@Color = AttributeItem.new
@Color.deserialize(params['Color'])
end
end
end
# 帽子信息
class Hat < TencentCloud::Common::AbstractModel
# @param Style: 帽子佩戴状态信息。
# AttributeItem对应的Type为 —— 0：不戴帽子，1：普通帽子，2：头盔，3：保安帽。
# @type Style: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
# @param Color: 帽子颜色。
# AttributeItem对应的Type为 —— 0：不戴帽子，1：红色系，2：黄色系，3：蓝色系，4：黑色系，5：灰白色系，6：混色系。
# @type Color: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
attr_accessor :Style, :Color
def initialize(style=nil, color=nil)
@Style = style
@Color = color
end
def deserialize(params)
unless params['Style'].nil?
@Style = AttributeItem.new
@Style.deserialize(params['Style'])
end
unless params['Color'].nil?
@Color = AttributeItem.new
@Color.deserialize(params['Color'])
end
end
end
# 姿态信息
class HeadPose < TencentCloud::Common::AbstractModel
# @param Pitch: 上下偏移[-30,30]。
# @type Pitch: Integer
# @param Yaw: 左右偏移[-30,30]。
# @type Yaw: Integer
# @param Roll: 平面旋转[-180,180]。
# @type Roll: Integer
attr_accessor :Pitch, :Yaw, :Roll
def initialize(pitch=nil, yaw=nil, roll=nil)
@Pitch = pitch
@Yaw = yaw
@Roll = roll
end
def deserialize(params)
@Pitch = params['Pitch']
@Yaw = params['Yaw']
@Roll = params['Roll']
end
end
# ModifyGroup请求参数结构体
class ModifyGroupRequest < TencentCloud::Common::AbstractModel
# @param GroupId: 人员库ID，取值为创建人员库接口中的GroupId
# @type GroupId: String
# @param GroupName: 人员库名称
# @type GroupName: String
# @param GroupExDescriptionInfos: 需要修改的人员库自定义描述字段，key-value
# @type GroupExDescriptionInfos: Array
# @param Tag: 人员库信息备注
# @type Tag: String
attr_accessor :GroupId, :GroupName, :GroupExDescriptionInfos, :Tag
def initialize(groupid=nil, groupname=nil, groupexdescriptioninfos=nil, tag=nil)
@GroupId = groupid
@GroupName = groupname
@GroupExDescriptionInfos = groupexdescriptioninfos
@Tag = tag
end
def deserialize(params)
@GroupId = params['GroupId']
@GroupName = params['GroupName']
unless params['GroupExDescriptionInfos'].nil?
@GroupExDescriptionInfos = []
params['GroupExDescriptionInfos'].each do |i|
groupexdescriptioninfo_tmp = GroupExDescriptionInfo.new
groupexdescriptioninfo_tmp.deserialize(i)
@GroupExDescriptionInfos << groupexdescriptioninfo_tmp
end
end
@Tag = params['Tag']
end
end
# ModifyGroup返回参数结构体
class ModifyGroupResponse < TencentCloud::Common::AbstractModel
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :RequestId
def initialize(requestid=nil)
@RequestId = requestid
end
def deserialize(params)
@RequestId = params['RequestId']
end
end
# ModifyPersonBaseInfo请求参数结构体
class ModifyPersonBaseInfoRequest < TencentCloud::Common::AbstractModel
# @param PersonId: 人员ID，取值为创建人员接口中的PersonId
# @type PersonId: String
# @param PersonName: 需要修改的人员名称
# @type PersonName: String
# @param Gender: 需要修改的人员性别，1代表男性，2代表女性
# @type Gender: Integer
attr_accessor :PersonId, :PersonName, :Gender
def initialize(personid=nil, personname=nil, gender=nil)
@PersonId = personid
@PersonName = personname
@Gender = gender
end
def deserialize(params)
@PersonId = params['PersonId']
@PersonName = params['PersonName']
@Gender = params['Gender']
end
end
# ModifyPersonBaseInfo返回参数结构体
class ModifyPersonBaseInfoResponse < TencentCloud::Common::AbstractModel
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :RequestId
def initialize(requestid=nil)
@RequestId = requestid
end
def deserialize(params)
@RequestId = params['RequestId']
end
end
# ModifyPersonGroupInfo请求参数结构体
class ModifyPersonGroupInfoRequest < TencentCloud::Common::AbstractModel
# @param GroupId: 人员库ID，取值为创建人员库接口中的GroupId
# @type GroupId: String
# @param PersonId: 人员ID，取值为创建人员接口中的PersonId
# @type PersonId: String
# @param PersonExDescriptionInfos: 需要修改的人员描述字段内容，key-value
# @type PersonExDescriptionInfos: Array
attr_accessor :GroupId, :PersonId, :PersonExDescriptionInfos
def initialize(groupid=nil, personid=nil, personexdescriptioninfos=nil)
@GroupId = groupid
@PersonId = personid
@PersonExDescriptionInfos = personexdescriptioninfos
end
def deserialize(params)
@GroupId = params['GroupId']
@PersonId = params['PersonId']
unless params['PersonExDescriptionInfos'].nil?
@PersonExDescriptionInfos = []
params['PersonExDescriptionInfos'].each do |i|
personexdescriptioninfo_tmp = PersonExDescriptionInfo.new
personexdescriptioninfo_tmp.deserialize(i)
@PersonExDescriptionInfos << personexdescriptioninfo_tmp
end
end
end
end
# ModifyPersonGroupInfo返回参数结构体
class ModifyPersonGroupInfoResponse < TencentCloud::Common::AbstractModel
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :RequestId
def initialize(requestid=nil)
@RequestId = requestid
end
def deserialize(params)
@RequestId = params['RequestId']
end
end
# 嘴巴信息。
class Mouth < TencentCloud::Common::AbstractModel
# @param MouthOpen: 是否张嘴信息。
# AttributeItem对应的Type为 —— 0：不张嘴，1：张嘴。
# @type MouthOpen: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
attr_accessor :MouthOpen
def initialize(mouthopen=nil)
@MouthOpen = mouthopen
end
def deserialize(params)
unless params['MouthOpen'].nil?
@MouthOpen = AttributeItem.new
@MouthOpen.deserialize(params['MouthOpen'])
end
end
end
# 需要修改的人员描述字段内容，key-value
class PersonExDescriptionInfo < TencentCloud::Common::AbstractModel
# @param PersonExDescriptionIndex: 人员描述字段Index，从0开始
# @type PersonExDescriptionIndex: Integer
# @param PersonExDescription: 需要更新的人员描述字段内容
# @type PersonExDescription: String
attr_accessor :PersonExDescriptionIndex, :PersonExDescription
def initialize(personexdescriptionindex=nil, personexdescription=nil)
@PersonExDescriptionIndex = personexdescriptionindex
@PersonExDescription = personexdescription
end
def deserialize(params)
@PersonExDescriptionIndex = params['PersonExDescriptionIndex']
@PersonExDescription = params['PersonExDescription']
end
end
# 包含此人员的人员库及描述字段内容列表
class PersonGroupInfo < TencentCloud::Common::AbstractModel
# @param GroupId: 包含此人员的人员库ID
# @type GroupId: String
# @param PersonExDescriptions: 人员描述字段内容
# @type PersonExDescriptions: Array
attr_accessor :GroupId, :PersonExDescriptions
def initialize(groupid=nil, personexdescriptions=nil)
@GroupId = groupid
@PersonExDescriptions = personexdescriptions
end
def deserialize(params)
@GroupId = params['GroupId']
@PersonExDescriptions = params['PersonExDescriptions']
end
end
# 返回的人员信息
class PersonInfo < TencentCloud::Common::AbstractModel
# @param PersonName: 人员名称
# @type PersonName: String
# @param PersonId: 人员Id
# @type PersonId: String
# @param Gender: 人员性别
# @type Gender: Integer
# @param PersonExDescriptions: 人员描述字段内容
# @type PersonExDescriptions: Array
# @param FaceIds: 包含的人脸照片列表
# @type FaceIds: Array
# @param CreationTimestamp: 人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。
# Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。有关更多信息，请参阅 Unix 时间。
# @type CreationTimestamp: Integer
attr_accessor :PersonName, :PersonId, :Gender, :PersonExDescriptions, :FaceIds, :CreationTimestamp
def initialize(personname=nil, personid=nil, gender=nil, personexdescriptions=nil, faceids=nil, creationtimestamp=nil)
@PersonName = personname
@PersonId = personid
@Gender = gender
@PersonExDescriptions = personexdescriptions
@FaceIds = faceids
@CreationTimestamp = creationtimestamp
end
def deserialize(params)
@PersonName = params['PersonName']
@PersonId = params['PersonId']
@Gender = params['Gender']
@PersonExDescriptions = params['PersonExDescriptions']
@FaceIds = params['FaceIds']
@CreationTimestamp = params['CreationTimestamp']
end
end
# 坐标
class Point < TencentCloud::Common::AbstractModel
# @param X: x坐标
# @type X: Integer
# @param Y: Y坐标
# @type Y: Integer
attr_accessor :X, :Y
def initialize(x=nil, y=nil)
@X = x
@Y = y
end
def deserialize(params)
@X = params['X']
@Y = params['Y']
end
end
# 人脸的识别结果
class Result < TencentCloud::Common::AbstractModel
# @param Candidates: 识别出的最相似候选人
# @type Candidates: Array
# @param FaceRect: 检测出的人脸框位置
# @type FaceRect: :class:`Tencentcloud::Iai.v20200303.models.FaceRect`
# @param RetCode: 检测出的人脸图片状态返回码。0 表示正常。
# -1601代表不符合图片质量控制要求，此时Candidate内容为空。
# @type RetCode: Integer
attr_accessor :Candidates, :FaceRect, :RetCode
def initialize(candidates=nil, facerect=nil, retcode=nil)
@Candidates = candidates
@FaceRect = facerect
@RetCode = retcode
end
def deserialize(params)
unless params['Candidates'].nil?
@Candidates = []
params['Candidates'].each do |i|
candidate_tmp = Candidate.new
candidate_tmp.deserialize(i)
@Candidates << candidate_tmp
end
end
unless params['FaceRect'].nil?
@FaceRect = FaceRect.new
@FaceRect.deserialize(params['FaceRect'])
end
@RetCode = params['RetCode']
end
end
# 识别结果。
class ResultsReturnsByGroup < TencentCloud::Common::AbstractModel
# @param FaceRect: 检测出的人脸框位置。
# @type FaceRect: :class:`Tencentcloud::Iai.v20200303.models.FaceRect`
# @param GroupCandidates: 识别结果。
# @type GroupCandidates: Array
# @param RetCode: 检测出的人脸图片状态返回码。0 表示正常。
# -1601代表不符合图片质量控制要求，此时Candidate内容为空。
# @type RetCode: Integer
attr_accessor :FaceRect, :GroupCandidates, :RetCode
def initialize(facerect=nil, groupcandidates=nil, retcode=nil)
@FaceRect = facerect
@GroupCandidates = groupcandidates
@RetCode = retcode
end
def deserialize(params)
unless params['FaceRect'].nil?
@FaceRect = FaceRect.new
@FaceRect.deserialize(params['FaceRect'])
end
unless params['GroupCandidates'].nil?
@GroupCandidates = []
params['GroupCandidates'].each do |i|
groupcandidate_tmp = GroupCandidate.new
groupcandidate_tmp.deserialize(i)
@GroupCandidates << groupcandidate_tmp
end
end
@RetCode = params['RetCode']
end
end
# RevertGroupFaceModelVersion请求参数结构体
class RevertGroupFaceModelVersionRequest < TencentCloud::Common::AbstractModel
# @param JobId: 需要回滚的升级任务ID。
# @type JobId: String
attr_accessor :JobId
def initialize(jobid=nil)
@JobId = jobid
end
def deserialize(params)
@JobId = params['JobId']
end
end
# RevertGroupFaceModelVersion返回参数结构体
class RevertGroupFaceModelVersionResponse < TencentCloud::Common::AbstractModel
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :RequestId
def initialize(requestid=nil)
@RequestId = requestid
end
def deserialize(params)
@RequestId = params['RequestId']
end
end
# SearchFaces请求参数结构体
class SearchFacesRequest < TencentCloud::Common::AbstractModel
# @param GroupIds: 希望搜索的人员库列表，上限100个。数组元素取值为创建人员库接口中的GroupId。
# 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。
# @type GroupIds: Array
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param MaxFaceNum: 最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
# MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。
# 例如：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。
# @type MaxFaceNum: Integer
# @param MinFaceSize: 人脸长和宽的最小尺寸，单位为像素。默认为34。低于34的人脸图片无法被识别。建议设置为80。
# @type MinFaceSize: Integer
# @param MaxPersonNum: 单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
# 例如，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。
# 值越大，需要处理的时间越长。建议不要超过10。
# @type MaxPersonNum: Integer
# @param NeedPersonInfo: 是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
# @type NeedPersonInfo: Integer
# @param QualityControl: 图片质量控制。
# 0: 不进行控制；
# 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
# 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
# 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
# 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
# 默认 0。
# 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
# @type QualityControl: Integer
# @param FaceMatchThreshold: 出参Score中，只有超过FaceMatchThreshold值的结果才会返回。默认为0。
# @type FaceMatchThreshold: Float
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :GroupIds, :Image, :Url, :MaxFaceNum, :MinFaceSize, :MaxPersonNum, :NeedPersonInfo, :QualityControl, :FaceMatchThreshold, :NeedRotateDetection
def initialize(groupids=nil, image=nil, url=nil, maxfacenum=nil, minfacesize=nil, maxpersonnum=nil, needpersoninfo=nil, qualitycontrol=nil, facematchthreshold=nil, needrotatedetection=nil)
@GroupIds = groupids
@Image = image
@Url = url
@MaxFaceNum = maxfacenum
@MinFaceSize = minfacesize
@MaxPersonNum = maxpersonnum
@NeedPersonInfo = needpersoninfo
@QualityControl = qualitycontrol
@FaceMatchThreshold = facematchthreshold
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@GroupIds = params['GroupIds']
@Image = params['Image']
@Url = params['Url']
@MaxFaceNum = params['MaxFaceNum']
@MinFaceSize = params['MinFaceSize']
@MaxPersonNum = params['MaxPersonNum']
@NeedPersonInfo = params['NeedPersonInfo']
@QualityControl = params['QualityControl']
@FaceMatchThreshold = params['FaceMatchThreshold']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# SearchFaces返回参数结构体
class SearchFacesResponse < TencentCloud::Common::AbstractModel
# @param Results: 识别结果。
# @type Results: Array
# @param FaceNum: 搜索的人员库中包含的人脸数。
# @type FaceNum: Integer
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :Results, :FaceNum, :FaceModelVersion, :RequestId
def initialize(results=nil, facenum=nil, facemodelversion=nil, requestid=nil)
@Results = results
@FaceNum = facenum
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
unless params['Results'].nil?
@Results = []
params['Results'].each do |i|
result_tmp = Result.new
result_tmp.deserialize(i)
@Results << result_tmp
end
end
@FaceNum = params['FaceNum']
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# SearchFacesReturnsByGroup请求参数结构体
class SearchFacesReturnsByGroupRequest < TencentCloud::Common::AbstractModel
# @param GroupIds: 希望搜索的人员库列表，上限60个。数组元素取值为创建人员库接口中的GroupId。
# 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。
# @type GroupIds: Array
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param MaxFaceNum: 最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
# MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。
# 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。
# @type MaxFaceNum: Integer
# @param MinFaceSize: 人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
# @type MinFaceSize: Integer
# @param MaxPersonNumPerGroup: 被检测到的人脸，对应最多返回的最相似人员数目。默认值为5，最大值为10。
# 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。
# @type MaxPersonNumPerGroup: Integer
# @param NeedPersonInfo: 是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
# @type NeedPersonInfo: Integer
# @param QualityControl: 图片质量控制。
# 0: 不进行控制；
# 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
# 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
# 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
# 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
# 默认 0。
# 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
# @type QualityControl: Integer
# @param FaceMatchThreshold: 出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。
# 默认为0。
# 取值范围[0.0,100.0) 。
# @type FaceMatchThreshold: Float
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :GroupIds, :Image, :Url, :MaxFaceNum, :MinFaceSize, :MaxPersonNumPerGroup, :NeedPersonInfo, :QualityControl, :FaceMatchThreshold, :NeedRotateDetection
def initialize(groupids=nil, image=nil, url=nil, maxfacenum=nil, minfacesize=nil, maxpersonnumpergroup=nil, needpersoninfo=nil, qualitycontrol=nil, facematchthreshold=nil, needrotatedetection=nil)
@GroupIds = groupids
@Image = image
@Url = url
@MaxFaceNum = maxfacenum
@MinFaceSize = minfacesize
@MaxPersonNumPerGroup = maxpersonnumpergroup
@NeedPersonInfo = needpersoninfo
@QualityControl = qualitycontrol
@FaceMatchThreshold = facematchthreshold
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@GroupIds = params['GroupIds']
@Image = params['Image']
@Url = params['Url']
@MaxFaceNum = params['MaxFaceNum']
@MinFaceSize = params['MinFaceSize']
@MaxPersonNumPerGroup = params['MaxPersonNumPerGroup']
@NeedPersonInfo = params['NeedPersonInfo']
@QualityControl = params['QualityControl']
@FaceMatchThreshold = params['FaceMatchThreshold']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# SearchFacesReturnsByGroup返回参数结构体
class SearchFacesReturnsByGroupResponse < TencentCloud::Common::AbstractModel
# @param FaceNum: 搜索的人员库中包含的人脸数。
# @type FaceNum: Integer
# @param ResultsReturnsByGroup: 识别结果。
# @type ResultsReturnsByGroup: Array
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :FaceNum, :ResultsReturnsByGroup, :FaceModelVersion, :RequestId
def initialize(facenum=nil, resultsreturnsbygroup=nil, facemodelversion=nil, requestid=nil)
@FaceNum = facenum
@ResultsReturnsByGroup = resultsreturnsbygroup
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@FaceNum = params['FaceNum']
unless params['ResultsReturnsByGroup'].nil?
@ResultsReturnsByGroup = []
params['ResultsReturnsByGroup'].each do |i|
resultsreturnsbygroup_tmp = ResultsReturnsByGroup.new
resultsreturnsbygroup_tmp.deserialize(i)
@ResultsReturnsByGroup << resultsreturnsbygroup_tmp
end
end
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# SearchPersons请求参数结构体
class SearchPersonsRequest < TencentCloud::Common::AbstractModel
# @param GroupIds: 希望搜索的人员库列表，上限100个。数组元素取值为创建人员库接口中的GroupId
# @type GroupIds: Array
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param MaxFaceNum: 最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
# MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。
# 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。
# @type MaxFaceNum: Integer
# @param MinFaceSize: 人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
# @type MinFaceSize: Integer
# @param MaxPersonNum: 单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
# 例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。
# 值越大，需要处理的时间越长。建议不要超过10。
# @type MaxPersonNum: Integer
# @param QualityControl: 图片质量控制。
# 0: 不进行控制；
# 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
# 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
# 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
# 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
# 默认 0。
# 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
# @type QualityControl: Integer
# @param FaceMatchThreshold: 出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
# @type FaceMatchThreshold: Float
# @param NeedPersonInfo: 是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
# @type NeedPersonInfo: Integer
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :GroupIds, :Image, :Url, :MaxFaceNum, :MinFaceSize, :MaxPersonNum, :QualityControl, :FaceMatchThreshold, :NeedPersonInfo, :NeedRotateDetection
def initialize(groupids=nil, image=nil, url=nil, maxfacenum=nil, minfacesize=nil, maxpersonnum=nil, qualitycontrol=nil, facematchthreshold=nil, needpersoninfo=nil, needrotatedetection=nil)
@GroupIds = groupids
@Image = image
@Url = url
@MaxFaceNum = maxfacenum
@MinFaceSize = minfacesize
@MaxPersonNum = maxpersonnum
@QualityControl = qualitycontrol
@FaceMatchThreshold = facematchthreshold
@NeedPersonInfo = needpersoninfo
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@GroupIds = params['GroupIds']
@Image = params['Image']
@Url = params['Url']
@MaxFaceNum = params['MaxFaceNum']
@MinFaceSize = params['MinFaceSize']
@MaxPersonNum = params['MaxPersonNum']
@QualityControl = params['QualityControl']
@FaceMatchThreshold = params['FaceMatchThreshold']
@NeedPersonInfo = params['NeedPersonInfo']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# SearchPersons返回参数结构体
class SearchPersonsResponse < TencentCloud::Common::AbstractModel
# @param Results: 识别结果。
# @type Results: Array
# @param PersonNum: 搜索的人员库中包含的人员数。若输入图片中所有人脸均不符合质量要求，则返回0。
# @type PersonNum: Integer
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# 注意：此字段可能返回 null，表示取不到有效值。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :Results, :PersonNum, :FaceModelVersion, :RequestId
def initialize(results=nil, personnum=nil, facemodelversion=nil, requestid=nil)
@Results = results
@PersonNum = personnum
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
unless params['Results'].nil?
@Results = []
params['Results'].each do |i|
result_tmp = Result.new
result_tmp.deserialize(i)
@Results << result_tmp
end
end
@PersonNum = params['PersonNum']
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# SearchPersonsReturnsByGroup请求参数结构体
class SearchPersonsReturnsByGroupRequest < TencentCloud::Common::AbstractModel
# @param GroupIds: 希望搜索的人员库列表，上限60个。数组元素取值为创建人员库接口中的GroupId
# @type GroupIds: Array
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param MaxFaceNum: 最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
# MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。
# 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。
# @type MaxFaceNum: Integer
# @param MinFaceSize: 人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
# @type MinFaceSize: Integer
# @param MaxPersonNumPerGroup: 被检测到的人脸，对应最多返回的最相似人员数目。默认值为5，最大值为10。
# 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。
# @type MaxPersonNumPerGroup: Integer
# @param QualityControl: 图片质量控制。
# 0: 不进行控制；
# 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
# 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
# 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
# 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
# 默认 0。
# 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
# @type QualityControl: Integer
# @param FaceMatchThreshold: 出参Score中，只有超过FaceMatchThreshold值的结果才会返回。默认为0。
# @type FaceMatchThreshold: Float
# @param NeedPersonInfo: 是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
# @type NeedPersonInfo: Integer
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :GroupIds, :Image, :Url, :MaxFaceNum, :MinFaceSize, :MaxPersonNumPerGroup, :QualityControl, :FaceMatchThreshold, :NeedPersonInfo, :NeedRotateDetection
def initialize(groupids=nil, image=nil, url=nil, maxfacenum=nil, minfacesize=nil, maxpersonnumpergroup=nil, qualitycontrol=nil, facematchthreshold=nil, needpersoninfo=nil, needrotatedetection=nil)
@GroupIds = groupids
@Image = image
@Url = url
@MaxFaceNum = maxfacenum
@MinFaceSize = minfacesize
@MaxPersonNumPerGroup = maxpersonnumpergroup
@QualityControl = qualitycontrol
@FaceMatchThreshold = facematchthreshold
@NeedPersonInfo = needpersoninfo
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@GroupIds = params['GroupIds']
@Image = params['Image']
@Url = params['Url']
@MaxFaceNum = params['MaxFaceNum']
@MinFaceSize = params['MinFaceSize']
@MaxPersonNumPerGroup = params['MaxPersonNumPerGroup']
@QualityControl = params['QualityControl']
@FaceMatchThreshold = params['FaceMatchThreshold']
@NeedPersonInfo = params['NeedPersonInfo']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# SearchPersonsReturnsByGroup返回参数结构体
class SearchPersonsReturnsByGroupResponse < TencentCloud::Common::AbstractModel
# @param PersonNum: 搜索的人员库中包含的人员数。若输入图片中所有人脸均不符合质量要求，则返回0。
# @type PersonNum: Integer
# @param ResultsReturnsByGroup: 识别结果。
# @type ResultsReturnsByGroup: Array
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :PersonNum, :ResultsReturnsByGroup, :FaceModelVersion, :RequestId
def initialize(personnum=nil, resultsreturnsbygroup=nil, facemodelversion=nil, requestid=nil)
@PersonNum = personnum
@ResultsReturnsByGroup = resultsreturnsbygroup
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@PersonNum = params['PersonNum']
unless params['ResultsReturnsByGroup'].nil?
@ResultsReturnsByGroup = []
params['ResultsReturnsByGroup'].each do |i|
resultsreturnsbygroup_tmp = ResultsReturnsByGroup.new
resultsreturnsbygroup_tmp.deserialize(i)
@ResultsReturnsByGroup << resultsreturnsbygroup_tmp
end
end
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# UpgradeGroupFaceModelVersion请求参数结构体
class UpgradeGroupFaceModelVersionRequest < TencentCloud::Common::AbstractModel
# @param GroupId: 需要升级的人员库ID。
# @type GroupId: String
# @param FaceModelVersion: 需要升级至的算法模型版本。默认为最新版本。不可逆向升级
# @type FaceModelVersion: String
attr_accessor :GroupId, :FaceModelVersion
def initialize(groupid=nil, facemodelversion=nil)
@GroupId = groupid
@FaceModelVersion = facemodelversion
end
def deserialize(params)
@GroupId = params['GroupId']
@FaceModelVersion = params['FaceModelVersion']
end
end
# UpgradeGroupFaceModelVersion返回参数结构体
class UpgradeGroupFaceModelVersionResponse < TencentCloud::Common::AbstractModel
# @param JobId: 升级任务ID，用于查询、获取升级的进度和结果。
# @type JobId: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :JobId, :RequestId
def initialize(jobid=nil, requestid=nil)
@JobId = jobid
@RequestId = requestid
end
def deserialize(params)
@JobId = params['JobId']
@RequestId = params['RequestId']
end
end
# 人员库升级任务信息
class UpgradeJobInfo < TencentCloud::Common::AbstractModel
# @param JobId: 人员库升级任务ID，用于查询、获取升级的进度和结果。
# @type JobId: String
# @param GroupId: 人员库ID。
# @type GroupId: String
# @param FromFaceModelVersion: 当前算法模型版本。
# @type FromFaceModelVersion: String
# @param ToFaceModelVersion: 目标算法模型版本。
# @type ToFaceModelVersion: String
# @param StartTime: 升级起始时间。
# StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
# Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。
# 有关更多信息，请参阅 Unix 时间。
# @type StartTime: Integer
# @param Status: 0表示升级中，1表示升级完毕，2表示回滚完毕，3表示升级失败。
# @type Status: Integer
attr_accessor :JobId, :GroupId, :FromFaceModelVersion, :ToFaceModelVersion, :StartTime, :Status
def initialize(jobid=nil, groupid=nil, fromfacemodelversion=nil, tofacemodelversion=nil, starttime=nil, status=nil)
@JobId = jobid
@GroupId = groupid
@FromFaceModelVersion = fromfacemodelversion
@ToFaceModelVersion = tofacemodelversion
@StartTime = starttime
@Status = status
end
def deserialize(params)
@JobId = params['JobId']
@GroupId = params['GroupId']
@FromFaceModelVersion = params['FromFaceModelVersion']
@ToFaceModelVersion = params['ToFaceModelVersion']
@StartTime = params['StartTime']
@Status = params['Status']
end
end
# VerifyFace请求参数结构体
class VerifyFaceRequest < TencentCloud::Common::AbstractModel
# @param PersonId: 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
# @type PersonId: String
# @param Image: 图片 base64 数据，base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
# Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param QualityControl: 图片质量控制。
# 0: 不进行控制；
# 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
# 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
# 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
# 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
# 默认 0。
# 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
# @type QualityControl: Integer
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :PersonId, :Image, :Url, :QualityControl, :NeedRotateDetection
def initialize(personid=nil, image=nil, url=nil, qualitycontrol=nil, needrotatedetection=nil)
@PersonId = personid
@Image = image
@Url = url
@QualityControl = qualitycontrol
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@PersonId = params['PersonId']
@Image = params['Image']
@Url = params['Url']
@QualityControl = params['QualityControl']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# VerifyFace返回参数结构体
class VerifyFaceResponse < TencentCloud::Common::AbstractModel
# @param Score: 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸（Face），返回相似度最大的分数。
# 不同算法版本返回的相似度分数不同。
# 若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
# 2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
# @type Score: Float
# @param IsMatch: 是否为同一人判断，固定阈值分数为60分，若想更灵活地调整阈值可取Score参数返回进行判断
# @type IsMatch: Boolean
# @param FaceModelVersion: 人脸识别所用的算法模型版本，是该 Person 所在的人员库的算法模型版本。在创建人员库时设置，详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :Score, :IsMatch, :FaceModelVersion, :RequestId
def initialize(score=nil, ismatch=nil, facemodelversion=nil, requestid=nil)
@Score = score
@IsMatch = ismatch
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@Score = params['Score']
@IsMatch = params['IsMatch']
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
# VerifyPerson请求参数结构体
class VerifyPersonRequest < TencentCloud::Common::AbstractModel
# @param PersonId: 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
# @type PersonId: String
# @param Image: 图片 base64 数据。
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Image: String
# @param Url: 图片的 Url
# jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。。
# 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
# 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
# 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
# @type Url: String
# @param QualityControl: 图片质量控制。
# 0: 不进行控制；
# 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
# 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
# 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
# 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
# 默认 0。
# 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
# @type QualityControl: Integer
# @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
# @type NeedRotateDetection: Integer
attr_accessor :PersonId, :Image, :Url, :QualityControl, :NeedRotateDetection
def initialize(personid=nil, image=nil, url=nil, qualitycontrol=nil, needrotatedetection=nil)
@PersonId = personid
@Image = image
@Url = url
@QualityControl = qualitycontrol
@NeedRotateDetection = needrotatedetection
end
def deserialize(params)
@PersonId = params['PersonId']
@Image = params['Image']
@Url = params['Url']
@QualityControl = params['QualityControl']
@NeedRotateDetection = params['NeedRotateDetection']
end
end
# VerifyPerson返回参数结构体
class VerifyPersonResponse < TencentCloud::Common::AbstractModel
# @param Score: 给定的人脸照片与 PersonId 对应的相似度。若 PersonId 下有多张人脸（Face），会融合多张人脸信息进行验证。
# @type Score: Float
# @param IsMatch: 是否为同一人的判断。
# @type IsMatch: Boolean
# @param FaceModelVersion: 人脸识别所用的算法模型版本，是该 Person 所在的人员库的算法模型版本。在创建人员库时设置，详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
# @type FaceModelVersion: String
# @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
# @type RequestId: String
attr_accessor :Score, :IsMatch, :FaceModelVersion, :RequestId
def initialize(score=nil, ismatch=nil, facemodelversion=nil, requestid=nil)
@Score = score
@IsMatch = ismatch
@FaceModelVersion = facemodelversion
@RequestId = requestid
end
def deserialize(params)
@Score = params['Score']
@IsMatch = params['IsMatch']
@FaceModelVersion = params['FaceModelVersion']
@RequestId = params['RequestId']
end
end
end
end
end