tencentcloud-sdk-iai 3.0.939 → 3.0.940
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/VERSION +1 -1
- data/lib/v20180301/models.rb +2 -2
- data/lib/v20200303/models.rb +364 -263
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: d8843240ea78e637d3db59edbc29f408060d7121
|
4
|
+
data.tar.gz: b31e798f3d58f76d83baf3a94e8feef46fb85dda
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 135daf342519db58275f06f999daabb72aaf4fa8634205b2b423633c8001b86d00f8f6128de2a8acdc6c1af3bec9f81c56c5d060e3c45f4e05e7df1fd4d13ba5
|
7
|
+
data.tar.gz: 8eb0c9799c38baa5109992a0bb00230c434a5744b768b35ff3ff1c966b2050d47047fb4466f2c59000c16584954de604464a828f585c8e57d73cb7400bd609ef
|
data/lib/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
3.0.
|
1
|
+
3.0.940
|
data/lib/v20180301/models.rb
CHANGED
@@ -2749,9 +2749,9 @@ module TencentCloud
|
|
2749
2749
|
|
2750
2750
|
# 坐标
|
2751
2751
|
class Point < TencentCloud::Common::AbstractModel
|
2752
|
-
# @param X: x
|
2752
|
+
# @param X: x坐标。
|
2753
2753
|
# @type X: Integer
|
2754
|
-
# @param Y: Y
|
2754
|
+
# @param Y: Y坐标。
|
2755
2755
|
# @type Y: Integer
|
2756
2756
|
|
2757
2757
|
attr_accessor :X, :Y
|
data/lib/v20200303/models.rb
CHANGED
@@ -19,24 +19,31 @@ module TencentCloud
|
|
19
19
|
module V20200303
|
20
20
|
# AnalyzeDenseLandmarks请求参数结构体
|
21
21
|
class AnalyzeDenseLandmarksRequest < TencentCloud::Common::AbstractModel
|
22
|
-
# @param Mode: 检测模式。
|
23
|
-
#
|
24
|
-
#
|
22
|
+
# @param Mode: 检测模式。
|
23
|
+
# - 取值范围:0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
|
24
|
+
# - 默认为 0。
|
25
|
+
# - 最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
|
25
26
|
# @type Mode: Integer
|
26
|
-
# @param Image: 图片 base64
|
27
|
-
#
|
28
|
-
#
|
27
|
+
# @param Image: 图片 base64 数据。
|
28
|
+
# - base64 编码后大小不可超过5M。
|
29
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
30
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
29
31
|
# @type Image: String
|
30
|
-
# @param Url: 图片的 Url
|
31
|
-
#
|
32
|
-
#
|
33
|
-
#
|
34
|
-
#
|
35
|
-
#
|
32
|
+
# @param Url: 图片的 Url 。
|
33
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
34
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
35
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
36
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
37
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
38
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
36
39
|
# @type Url: String
|
37
40
|
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
|
38
41
|
# @type FaceModelVersion: String
|
39
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
42
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
43
|
+
# - 取值范围:0为不开启,1为开启。
|
44
|
+
# - 默认为0。
|
45
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
46
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
40
47
|
# @type NeedRotateDetection: Integer
|
41
48
|
|
42
49
|
attr_accessor :Mode, :Image, :Url, :FaceModelVersion, :NeedRotateDetection
|
@@ -99,30 +106,37 @@ module TencentCloud
|
|
99
106
|
|
100
107
|
# AnalyzeFace请求参数结构体
|
101
108
|
class AnalyzeFaceRequest < TencentCloud::Common::AbstractModel
|
102
|
-
# @param Mode: 检测模式。
|
109
|
+
# @param Mode: 检测模式。
|
110
|
+
# - 取值范围:
|
111
|
+
# 0 为检测所有出现的人脸。
|
112
|
+
# 1 为检测面积最大的人脸。
|
113
|
+
# - 默认为 0。
|
114
|
+
# - 最多返回 10 张人脸的五官定位(人脸关键点)具体信息。
|
103
115
|
# @type Mode: Integer
|
104
|
-
# @param Image: 图片 base64
|
105
|
-
#
|
106
|
-
#
|
116
|
+
# @param Image: 图片 base64 数据。
|
117
|
+
# - base64 编码后大小不可超过5M。
|
118
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
119
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
107
120
|
# @type Image: String
|
108
|
-
# @param Url: 图片的 Url
|
109
|
-
#
|
110
|
-
#
|
111
|
-
#
|
112
|
-
#
|
113
|
-
#
|
121
|
+
# @param Url: 图片的 Url 。
|
122
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
123
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
124
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
125
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
126
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
127
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
114
128
|
# @type Url: String
|
115
129
|
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
|
116
|
-
|
117
|
-
#
|
118
|
-
|
119
|
-
#
|
120
|
-
|
121
|
-
# 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
122
|
-
|
123
|
-
# 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
130
|
+
# - 目前入参支持 “2.0”和“3.0“ 两个输入。
|
131
|
+
# - 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
132
|
+
# - 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
133
|
+
# - 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
124
134
|
# @type FaceModelVersion: String
|
125
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
135
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
136
|
+
# - 0为不开启,1为开启。
|
137
|
+
# - 默认为0。
|
138
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
139
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
126
140
|
# @type NeedRotateDetection: Integer
|
127
141
|
|
128
142
|
attr_accessor :Mode, :Image, :Url, :FaceModelVersion, :NeedRotateDetection
|
@@ -185,9 +199,10 @@ module TencentCloud
|
|
185
199
|
|
186
200
|
# 人脸属性信息
|
187
201
|
class AttributeItem < TencentCloud::Common::AbstractModel
|
188
|
-
# @param Type:
|
202
|
+
# @param Type: 属性值。
|
189
203
|
# @type Type: Integer
|
190
|
-
# @param Probability: Type
|
204
|
+
# @param Probability: Type识别概率值。
|
205
|
+
# - 取值范围:[0,1],代表判断正确的概率。
|
191
206
|
# @type Probability: Float
|
192
207
|
|
193
208
|
attr_accessor :Type, :Probability
|
@@ -205,25 +220,25 @@ module TencentCloud
|
|
205
220
|
|
206
221
|
# 识别出的最相似候选人
|
207
222
|
class Candidate < TencentCloud::Common::AbstractModel
|
208
|
-
# @param PersonId: 人员ID
|
223
|
+
# @param PersonId: 人员ID。
|
209
224
|
# @type PersonId: String
|
210
|
-
# @param FaceId: 人脸ID
|
225
|
+
# @param FaceId: 人脸ID。
|
226
|
+
# - 仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。
|
227
|
+
# - 人员搜索类接口采用融合特征方式检索,该字段无意义。
|
211
228
|
# @type FaceId: String
|
212
229
|
# @param Score: 候选者的匹配得分。
|
213
|
-
|
214
|
-
#
|
215
|
-
#
|
216
|
-
#
|
217
|
-
|
218
|
-
# 一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
|
230
|
+
# - 1万大小人脸底库下,误识率百分之一对应分数为70分,误识率千分之一对应分数为80分,误识率万分之一对应分数为90分。
|
231
|
+
# - 10万大小人脸底库下,误识率百分之一对应分数为80分,误识率千分之一对应分数为90分,误识率万分之一对应分数为100分。
|
232
|
+
# - 30万大小人脸底库下,误识率百分之一对应分数为85分,误识率千分之一对应分数为95分。
|
233
|
+
# - 一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
|
219
234
|
# @type Score: Float
|
220
|
-
# @param PersonName:
|
235
|
+
# @param PersonName: 人员名称。
|
221
236
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
222
237
|
# @type PersonName: String
|
223
|
-
# @param Gender:
|
238
|
+
# @param Gender: 人员性别。
|
224
239
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
225
240
|
# @type Gender: Integer
|
226
|
-
# @param PersonGroupInfos:
|
241
|
+
# @param PersonGroupInfos: 包含此人员的人员库及描述字段内容列表。
|
227
242
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
228
243
|
# @type PersonGroupInfos: Array
|
229
244
|
|
@@ -1105,30 +1120,36 @@ module TencentCloud
|
|
1105
1120
|
# DetectFaceAttributes请求参数结构体
|
1106
1121
|
class DetectFaceAttributesRequest < TencentCloud::Common::AbstractModel
|
1107
1122
|
# @param MaxFaceNum: 最多处理的人脸数目。
|
1108
|
-
# 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
1109
|
-
# 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
1123
|
+
# - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
1124
|
+
# - 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
1110
1125
|
# @type MaxFaceNum: Integer
|
1111
|
-
# @param Image: 图片 base64
|
1112
|
-
#
|
1113
|
-
#
|
1126
|
+
# @param Image: 图片 base64 数据。
|
1127
|
+
# - base64 编码后大小不可超过5M。
|
1128
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
1129
|
+
# - 所有格式的图片短边像素不小于64。
|
1130
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1114
1131
|
# @type Image: String
|
1115
1132
|
# @param Url: 图片的 Url 。
|
1116
|
-
# 对应图片 base64 编码后大小不可超过5M。
|
1117
|
-
# jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1118
|
-
# Url、Image必须提供一个,如果都提供,只使用 Url。
|
1119
|
-
# 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
1120
|
-
# 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
1121
|
-
# 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1133
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
1134
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1135
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
1136
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
1137
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
1138
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1122
1139
|
# @type Url: String
|
1123
1140
|
# @param FaceAttributesType: 是否返回年龄、性别、情绪等属性。
|
1124
|
-
# 合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、
|
1125
|
-
#
|
1126
|
-
#
|
1127
|
-
# 需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
1128
|
-
# 关于各属性的详细描述,参见下文出参。
|
1129
|
-
# 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
1141
|
+
# - 合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
|
1142
|
+
# - None为不需要返回。
|
1143
|
+
# - 默认为 None。即FaceAttributesType属性为空时,各属性返回值为0。
|
1144
|
+
# - 需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
1145
|
+
# - 关于各属性的详细描述,参见下文出参。
|
1146
|
+
# - 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
1130
1147
|
# @type FaceAttributesType: String
|
1131
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
1148
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
1149
|
+
# - 0为不开启,1为开启。
|
1150
|
+
# - 默认为0。
|
1151
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
1152
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
1132
1153
|
# @type NeedRotateDetection: Integer
|
1133
1154
|
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入
|
1134
1155
|
# @type FaceModelVersion: String
|
@@ -1195,40 +1216,53 @@ module TencentCloud
|
|
1195
1216
|
|
1196
1217
|
# DetectFace请求参数结构体
|
1197
1218
|
class DetectFaceRequest < TencentCloud::Common::AbstractModel
|
1198
|
-
# @param MaxFaceNum:
|
1199
|
-
#
|
1219
|
+
# @param MaxFaceNum: 最多处理的人脸数目。
|
1220
|
+
# - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
1221
|
+
# - 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
1200
1222
|
# @type MaxFaceNum: Integer
|
1201
1223
|
# @param MinFaceSize: 人脸长和宽的最小尺寸,单位为像素,低于MinFaceSize值的人脸不会被检测。
|
1202
|
-
# 只支持设置34和20,建议使用34。
|
1224
|
+
# - 只支持设置34和20,建议使用34。
|
1203
1225
|
# @type MinFaceSize: Integer
|
1204
|
-
# @param Image: 图片 base64
|
1205
|
-
#
|
1206
|
-
#
|
1226
|
+
# @param Image: 图片 base64 数据。
|
1227
|
+
# - base64 编码后大小不可超过5M。
|
1228
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
1229
|
+
# - 所有格式的图片短边像素不小于64。
|
1230
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1207
1231
|
# @type Image: String
|
1208
|
-
# @param Url: 图片的 Url
|
1209
|
-
#
|
1210
|
-
#
|
1211
|
-
#
|
1212
|
-
#
|
1213
|
-
#
|
1232
|
+
# @param Url: 图片的 Url 。
|
1233
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
1234
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
1235
|
+
# - 所有格式的图片短边像素不小于64。
|
1236
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
1237
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
1238
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
1239
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1214
1240
|
# @type Url: String
|
1215
|
-
# @param NeedFaceAttributes: 是否需要返回人脸属性信息(FaceAttributesInfo)。
|
1216
|
-
#
|
1217
|
-
#
|
1218
|
-
#
|
1241
|
+
# @param NeedFaceAttributes: 是否需要返回人脸属性信息(FaceAttributesInfo)。
|
1242
|
+
# - 0 为不需要返回,1 为需要返回。
|
1243
|
+
# - 默认为 0。
|
1244
|
+
# - 非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
|
1245
|
+
# - 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
|
1246
|
+
# - 提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
|
1219
1247
|
# @type NeedFaceAttributes: Integer
|
1220
|
-
# @param NeedQualityDetection: 是否开启质量检测。
|
1221
|
-
#
|
1222
|
-
#
|
1223
|
-
#
|
1248
|
+
# @param NeedQualityDetection: 是否开启质量检测。
|
1249
|
+
# - 0 为关闭,1 为开启。
|
1250
|
+
# - 默认为 0。
|
1251
|
+
# - 非 1 值均视为不进行质量检测。
|
1252
|
+
# - 最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
|
1253
|
+
# - 建议:人脸入库操作建议开启此功能。
|
1224
1254
|
# @type NeedQualityDetection: Integer
|
1225
1255
|
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
|
1226
|
-
# 目前入参支持 “2.0”和“3.0“ 两个输入。
|
1227
|
-
# 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
1228
|
-
# 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
1229
|
-
# 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
1256
|
+
# - 目前入参支持 “2.0”和“3.0“ 两个输入。
|
1257
|
+
# - 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
1258
|
+
# - 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
1259
|
+
# - 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
1230
1260
|
# @type FaceModelVersion: String
|
1231
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
1261
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
1262
|
+
# - 0为不开启,1为开启。
|
1263
|
+
# - 默认为0。
|
1264
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
1265
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
1232
1266
|
# @type NeedRotateDetection: Integer
|
1233
1267
|
|
1234
1268
|
attr_accessor :MaxFaceNum, :MinFaceSize, :Image, :Url, :NeedFaceAttributes, :NeedQualityDetection, :FaceModelVersion, :NeedRotateDetection
|
@@ -1262,7 +1296,8 @@ module TencentCloud
|
|
1262
1296
|
# @type ImageWidth: Integer
|
1263
1297
|
# @param ImageHeight: 请求的图片高度。
|
1264
1298
|
# @type ImageHeight: Integer
|
1265
|
-
# @param FaceInfos:
|
1299
|
+
# @param FaceInfos: 人脸信息列表。
|
1300
|
+
# - 包含人脸坐标信息、属性信息(若需要)、质量分信息(若需要)。
|
1266
1301
|
# @type FaceInfos: Array
|
1267
1302
|
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
|
1268
1303
|
# @type FaceModelVersion: String
|
@@ -1297,19 +1332,21 @@ module TencentCloud
|
|
1297
1332
|
|
1298
1333
|
# DetectLiveFaceAccurate请求参数结构体
|
1299
1334
|
class DetectLiveFaceAccurateRequest < TencentCloud::Common::AbstractModel
|
1300
|
-
# @param Image: 图片 base64
|
1301
|
-
#
|
1302
|
-
#
|
1303
|
-
#
|
1304
|
-
#
|
1335
|
+
# @param Image: 图片 base64 数据。
|
1336
|
+
# - base64 编码后大小不可超过5M。
|
1337
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
1338
|
+
# - 图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
1339
|
+
# - 人脸尺寸大于100X100像素。
|
1340
|
+
# - 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1305
1341
|
# @type Image: String
|
1306
|
-
# @param Url: 图片的 Url
|
1307
|
-
#
|
1308
|
-
#
|
1309
|
-
#
|
1310
|
-
#
|
1311
|
-
#
|
1312
|
-
#
|
1342
|
+
# @param Url: 图片的 Url 。
|
1343
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
1344
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
1345
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
1346
|
+
# - 图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
1347
|
+
# - 人脸尺寸大于100X100像素。
|
1348
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
|
1349
|
+
# - 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1313
1350
|
# @type Url: String
|
1314
1351
|
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。目前入参支持“3.0“。
|
1315
1352
|
# @type FaceModelVersion: String
|
@@ -1331,7 +1368,10 @@ module TencentCloud
|
|
1331
1368
|
|
1332
1369
|
# DetectLiveFaceAccurate返回参数结构体
|
1333
1370
|
class DetectLiveFaceAccurateResponse < TencentCloud::Common::AbstractModel
|
1334
|
-
# @param Score:
|
1371
|
+
# @param Score: 活体打分。
|
1372
|
+
# - 取值范围 [0,100]。
|
1373
|
+
# - 根据活体分数对应的阈值区间来判断是否为翻拍。
|
1374
|
+
# - 目前阈值可分为[5,10,40,70,90],其中推荐阈值为40。
|
1335
1375
|
# @type Score: Float
|
1336
1376
|
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
|
1337
1377
|
# @type FaceModelVersion: String
|
@@ -1426,16 +1466,16 @@ module TencentCloud
|
|
1426
1466
|
# 眼睛信息
|
1427
1467
|
class Eye < TencentCloud::Common::AbstractModel
|
1428
1468
|
# @param Glass: 识别是否佩戴眼镜。
|
1429
|
-
# AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
|
1469
|
+
# - AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
|
1430
1470
|
# @type Glass: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1431
1471
|
# @param EyeOpen: 识别眼睛的睁开、闭合状态。
|
1432
|
-
# AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
1472
|
+
# - AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
1433
1473
|
# @type EyeOpen: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1434
1474
|
# @param EyelidType: 识别是否双眼皮。
|
1435
|
-
# AttributeItem对应的Type为 —— 0:无,1:有。
|
1475
|
+
# - AttributeItem对应的Type为 —— 0:无,1:有。
|
1436
1476
|
# @type EyelidType: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1437
1477
|
# @param EyeSize: 眼睛大小。
|
1438
|
-
# AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
|
1478
|
+
# - AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
|
1439
1479
|
# @type EyeSize: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1440
1480
|
|
1441
1481
|
attr_accessor :Glass, :EyeOpen, :EyelidType, :EyeSize
|
@@ -1470,13 +1510,13 @@ module TencentCloud
|
|
1470
1510
|
# 眉毛信息
|
1471
1511
|
class Eyebrow < TencentCloud::Common::AbstractModel
|
1472
1512
|
# @param EyebrowDensity: 眉毛浓密。
|
1473
|
-
# AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
1513
|
+
# - AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
1474
1514
|
# @type EyebrowDensity: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1475
1515
|
# @param EyebrowCurve: 眉毛弯曲。
|
1476
|
-
# AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
1516
|
+
# - AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
1477
1517
|
# @type EyebrowCurve: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1478
1518
|
# @param EyebrowLength: 眉毛长短。
|
1479
|
-
# AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
1519
|
+
# - AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
1480
1520
|
# @type EyebrowLength: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1481
1521
|
|
1482
1522
|
attr_accessor :EyebrowDensity, :EyebrowCurve, :EyebrowLength
|
@@ -1506,35 +1546,59 @@ module TencentCloud
|
|
1506
1546
|
# 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
|
1507
1547
|
# 魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息,最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
|
1508
1548
|
class FaceAttributesInfo < TencentCloud::Common::AbstractModel
|
1509
|
-
# @param Gender:
|
1549
|
+
# @param Gender: 性别。
|
1550
|
+
# - 取值说明:[0~49]为女性,[50,100]为男性,越接近0和100表示置信度越高。
|
1551
|
+
# - NeedFaceAttributes 不为 1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1510
1552
|
# @type Gender: Integer
|
1511
|
-
# @param Age: 年龄
|
1553
|
+
# @param Age: 年龄 。
|
1554
|
+
# - 取值范围:[0~100]。
|
1555
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1512
1556
|
# @type Age: Integer
|
1513
|
-
# @param Expression:
|
1557
|
+
# @param Expression: 微笑。
|
1558
|
+
# - 取值说明:[0(normal,正常)~100(laugh,大笑)]。
|
1559
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1514
1560
|
# @type Expression: Integer
|
1515
|
-
# @param Glass:
|
1561
|
+
# @param Glass: 是否有眼镜。
|
1562
|
+
# - 取值范围: [true,false]。
|
1563
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1516
1564
|
# @type Glass: Boolean
|
1517
|
-
# @param Pitch:
|
1518
|
-
#
|
1565
|
+
# @param Pitch: 上下偏移。
|
1566
|
+
# - 取值范围:[-30,30],单位角度。
|
1567
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1568
|
+
# - 建议:人脸入库选择[-10,10]的图片。
|
1519
1569
|
# @type Pitch: Integer
|
1520
|
-
# @param Yaw:
|
1521
|
-
#
|
1570
|
+
# @param Yaw: 左右偏移。
|
1571
|
+
# - 取值范围:[-30,30],单位角度。
|
1572
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1573
|
+
# - 建议:人脸入库选择[-10,10]的图片。
|
1522
1574
|
# @type Yaw: Integer
|
1523
|
-
# @param Roll:
|
1524
|
-
#
|
1575
|
+
# @param Roll: 平面旋转。
|
1576
|
+
# - 取值范围:[-180,180],单位角度。
|
1577
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1578
|
+
# - 建议:人脸入库选择[-20,20]的图片。
|
1525
1579
|
# @type Roll: Integer
|
1526
|
-
# @param Beauty:
|
1580
|
+
# @param Beauty: 魅力。
|
1581
|
+
# - 取值范围:[0~100]。
|
1582
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1527
1583
|
# @type Beauty: Integer
|
1528
|
-
# @param Hat:
|
1584
|
+
# @param Hat: 是否有帽子。
|
1585
|
+
# - 取值范围: [true,false]。
|
1586
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1529
1587
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1530
1588
|
# @type Hat: Boolean
|
1531
|
-
# @param Mask:
|
1589
|
+
# @param Mask: 是否有口罩。
|
1590
|
+
# - 取值范围: [true,false]。
|
1591
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1532
1592
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1533
1593
|
# @type Mask: Boolean
|
1534
|
-
# @param Hair: 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。
|
1594
|
+
# @param Hair: 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。
|
1595
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1535
1596
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1536
1597
|
# @type Hair: :class:`Tencentcloud::Iai.v20200303.models.FaceHairAttributesInfo`
|
1537
|
-
# @param EyeOpen:
|
1598
|
+
# @param EyeOpen: 双眼是否睁开。
|
1599
|
+
# - 取值范围: [true,false]。
|
1600
|
+
# - 只要有超过一只眼睛闭眼,就返回false。
|
1601
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1538
1602
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1539
1603
|
# @type EyeOpen: Boolean
|
1540
1604
|
|
@@ -1580,60 +1644,63 @@ module TencentCloud
|
|
1580
1644
|
# 鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
1581
1645
|
# 若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
1582
1646
|
class FaceDetailAttributesInfo < TencentCloud::Common::AbstractModel
|
1583
|
-
# @param Age:
|
1584
|
-
#
|
1647
|
+
# @param Age: 年龄。
|
1648
|
+
# - 取值范围: [0,65],其中65代表“65岁及以上”。
|
1649
|
+
# - FaceAttributesType 不含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1585
1650
|
# @type Age: Integer
|
1586
|
-
# @param Beauty:
|
1587
|
-
#
|
1651
|
+
# @param Beauty: 美丑打分。
|
1652
|
+
# - 取值范围:[0,100]。
|
1653
|
+
# - FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1588
1654
|
# @type Beauty: Integer
|
1589
1655
|
# @param Emotion: 情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
|
1590
|
-
# AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6
|
1591
|
-
# FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1656
|
+
# - AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕。
|
1657
|
+
# - FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1592
1658
|
# @type Emotion: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1593
1659
|
# @param Eye: 眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
|
1594
|
-
# FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1660
|
+
# - FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1595
1661
|
# @type Eye: :class:`Tencentcloud::Iai.v20200303.models.Eye`
|
1596
1662
|
# @param Eyebrow: 眉毛相关信息,可识别眉毛浓密、弯曲、长短信息。
|
1597
1663
|
# FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1598
1664
|
# @type Eyebrow: :class:`Tencentcloud::Iai.v20200303.models.Eyebrow`
|
1599
1665
|
# @param Gender: 性别信息。
|
1600
|
-
# AttributeItem对应的Type为 —— 0:男性,1:女性。
|
1601
|
-
# FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1666
|
+
# - AttributeItem对应的Type为 —— 0:男性,1:女性。
|
1667
|
+
# - FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1602
1668
|
# @type Gender: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1603
1669
|
# @param Hair: 头发信息,包含头发长度、有无刘海、头发颜色。
|
1604
|
-
# FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1670
|
+
# - FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1605
1671
|
# @type Hair: :class:`Tencentcloud::Iai.v20200303.models.Hair`
|
1606
1672
|
# @param Hat: 帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
|
1607
|
-
# FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1673
|
+
# - FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1608
1674
|
# @type Hat: :class:`Tencentcloud::Iai.v20200303.models.Hat`
|
1609
1675
|
# @param HeadPose: 姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
|
1610
|
-
# FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1676
|
+
# - FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1611
1677
|
# @type HeadPose: :class:`Tencentcloud::Iai.v20200303.models.HeadPose`
|
1612
1678
|
# @param Mask: 口罩佩戴信息。
|
1613
|
-
# AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
1614
|
-
# FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1679
|
+
# - AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
1680
|
+
# - FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1615
1681
|
# @type Mask: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1616
1682
|
# @param Mouth: 嘴巴信息,可识别是否张嘴、嘴唇厚度。
|
1617
|
-
# FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1683
|
+
# - FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1618
1684
|
# @type Mouth: :class:`Tencentcloud::Iai.v20200303.models.Mouth`
|
1619
1685
|
# @param Moustache: 胡子信息。
|
1620
|
-
# AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
1621
|
-
# FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1686
|
+
# - AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
1687
|
+
# - FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1622
1688
|
# @type Moustache: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1623
1689
|
# @param Nose: 鼻子信息。
|
1624
|
-
# AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
1625
|
-
# FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1690
|
+
# - AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
1691
|
+
# - FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1626
1692
|
# @type Nose: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1627
1693
|
# @param Shape: 脸型信息。
|
1628
|
-
# AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
1629
|
-
# FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1694
|
+
# - AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
1695
|
+
# - FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1630
1696
|
# @type Shape: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1631
1697
|
# @param Skin: 肤色信息。
|
1632
|
-
# AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
1633
|
-
# FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1698
|
+
# - AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
1699
|
+
# - FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1634
1700
|
# @type Skin: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
|
1635
|
-
# @param Smile:
|
1636
|
-
#
|
1701
|
+
# @param Smile: 微笑程度
|
1702
|
+
# - 取值范围:[0,100]。
|
1703
|
+
# - FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1637
1704
|
# @type Smile: Integer
|
1638
1705
|
|
1639
1706
|
attr_accessor :Age, :Beauty, :Emotion, :Eye, :Eyebrow, :Gender, :Hair, :Hat, :HeadPose, :Mask, :Mouth, :Moustache, :Nose, :Shape, :Skin, :Smile
|
@@ -1720,11 +1787,9 @@ module TencentCloud
|
|
1720
1787
|
class FaceDetailInfo < TencentCloud::Common::AbstractModel
|
1721
1788
|
# @param FaceRect: 检测出的人脸框位置。
|
1722
1789
|
# @type FaceRect: :class:`Tencentcloud::Iai.v20200303.models.FaceRect`
|
1723
|
-
# @param FaceDetailAttributesInfo:
|
1724
|
-
#
|
1725
|
-
#
|
1726
|
-
# 鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
1727
|
-
# 若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
1790
|
+
# @param FaceDetailAttributesInfo: 人脸属性信息。
|
1791
|
+
# - 根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)、情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)、头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouth)、胡子(Moustache) 、鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
1792
|
+
# - 若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
1728
1793
|
# @type FaceDetailAttributesInfo: :class:`Tencentcloud::Iai.v20200303.models.FaceDetailAttributesInfo`
|
1729
1794
|
|
1730
1795
|
attr_accessor :FaceRect, :FaceDetailAttributesInfo
|
@@ -1748,13 +1813,13 @@ module TencentCloud
|
|
1748
1813
|
|
1749
1814
|
# 人脸属性中的发型信息。
|
1750
1815
|
class FaceHairAttributesInfo < TencentCloud::Common::AbstractModel
|
1751
|
-
# @param Length: 0:光头,1:短发,2:中发,3:长发,4
|
1816
|
+
# @param Length: 取值范围:0:光头,1:短发,2:中发,3:长发,4:绑发。
|
1752
1817
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1753
1818
|
# @type Length: Integer
|
1754
|
-
# @param Bang: 0:有刘海,1
|
1819
|
+
# @param Bang: 取值范围:0:有刘海,1:无刘海。
|
1755
1820
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1756
1821
|
# @type Bang: Integer
|
1757
|
-
# @param Color: 0:黑色,1:金色,2:棕色,3
|
1822
|
+
# @param Color: 取值范围:0:黑色,1:金色,2:棕色,3:灰白色。
|
1758
1823
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1759
1824
|
# @type Color: Integer
|
1760
1825
|
|
@@ -1776,21 +1841,24 @@ module TencentCloud
|
|
1776
1841
|
# 人脸信息列表。
|
1777
1842
|
class FaceInfo < TencentCloud::Common::AbstractModel
|
1778
1843
|
# @param X: 人脸框左上角横坐标。
|
1779
|
-
# 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
1780
|
-
# 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
1844
|
+
# - 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
1845
|
+
# - 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
1781
1846
|
# @type X: Integer
|
1782
1847
|
# @param Y: 人脸框左上角纵坐标。
|
1783
|
-
# 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
1784
|
-
# 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
1848
|
+
# - 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
1849
|
+
# - 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
1785
1850
|
# @type Y: Integer
|
1786
1851
|
# @param Width: 人脸框宽度。
|
1787
1852
|
# @type Width: Integer
|
1788
1853
|
# @param Height: 人脸框高度。
|
1789
1854
|
# @type Height: Integer
|
1790
|
-
# @param FaceAttributesInfo:
|
1791
|
-
#
|
1855
|
+
# @param FaceAttributesInfo: 人脸属性信息。
|
1856
|
+
# - 包含性别( gender )、年龄( age )、表情( expression )、魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。
|
1857
|
+
# - 只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
|
1792
1858
|
# @type FaceAttributesInfo: :class:`Tencentcloud::Iai.v20200303.models.FaceAttributesInfo`
|
1793
|
-
# @param FaceQualityInfo:
|
1859
|
+
# @param FaceQualityInfo: 人脸质量信息。
|
1860
|
+
# - 包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。
|
1861
|
+
# - 只有当NeedFaceDetection设为1时才返回有效信息。
|
1794
1862
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1795
1863
|
# @type FaceQualityInfo: :class:`Tencentcloud::Iai.v20200303.models.FaceQualityInfo`
|
1796
1864
|
|
@@ -1823,28 +1891,34 @@ module TencentCloud
|
|
1823
1891
|
|
1824
1892
|
# 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
|
1825
1893
|
class FaceQualityCompleteness < TencentCloud::Common::AbstractModel
|
1826
|
-
# @param Eyebrow:
|
1827
|
-
#
|
1894
|
+
# @param Eyebrow: 眉毛的遮挡分数。
|
1895
|
+
# - 取值范围:[0,100],分数越高遮挡越少。
|
1896
|
+
# - 参考范围:[0,80]表示发生遮挡。
|
1828
1897
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1829
1898
|
# @type Eyebrow: Integer
|
1830
|
-
# @param Eye:
|
1831
|
-
#
|
1899
|
+
# @param Eye: 眼睛的遮挡分数。
|
1900
|
+
# - 取值范围:[0,100],分数越高遮挡越少。
|
1901
|
+
# - 参考范围:[0,80]表示发生遮挡。
|
1832
1902
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1833
1903
|
# @type Eye: Integer
|
1834
|
-
# @param Nose:
|
1835
|
-
#
|
1904
|
+
# @param Nose: 鼻子的遮挡分数。
|
1905
|
+
# - 取值范围:[0,100],分数越高遮挡越少。
|
1906
|
+
# - 参考范围:[0,60]表示发生遮挡。
|
1836
1907
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1837
1908
|
# @type Nose: Integer
|
1838
|
-
# @param Cheek:
|
1839
|
-
#
|
1909
|
+
# @param Cheek: 脸颊的遮挡分数。
|
1910
|
+
# - 取值范围:[0,100],分数越高遮挡越少。
|
1911
|
+
# - 参考范围:[0,70]表示发生遮挡。
|
1840
1912
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1841
1913
|
# @type Cheek: Integer
|
1842
|
-
# @param Mouth:
|
1843
|
-
#
|
1914
|
+
# @param Mouth: 嘴巴的遮挡分数。
|
1915
|
+
# - 取值范围:[0,100],分数越高遮挡越少。
|
1916
|
+
# - 参考范围:[0,50]表示发生遮挡。
|
1844
1917
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1845
1918
|
# @type Mouth: Integer
|
1846
|
-
# @param Chin:
|
1847
|
-
#
|
1919
|
+
# @param Chin: 下巴的遮挡分数。
|
1920
|
+
# - 取值范围:[0,100],分数越高遮挡越少。
|
1921
|
+
# - 参考范围:[0,70]表示发生遮挡。
|
1848
1922
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1849
1923
|
# @type Chin: Integer
|
1850
1924
|
|
@@ -1871,20 +1945,23 @@ module TencentCloud
|
|
1871
1945
|
|
1872
1946
|
# 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
|
1873
1947
|
class FaceQualityInfo < TencentCloud::Common::AbstractModel
|
1874
|
-
# @param Score:
|
1875
|
-
#
|
1876
|
-
#
|
1877
|
-
#
|
1948
|
+
# @param Score: 质量分。
|
1949
|
+
# - 取值范围:[0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
|
1950
|
+
# - 正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
|
1951
|
+
# - 参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
|
1952
|
+
# - 建议:人脸入库选取70以上的图片。
|
1878
1953
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1879
1954
|
# @type Score: Integer
|
1880
|
-
# @param Sharpness:
|
1881
|
-
#
|
1882
|
-
#
|
1955
|
+
# @param Sharpness: 清晰分。
|
1956
|
+
# - 取值范围:[0,100],评价图片清晰程度,分数越高越清晰。
|
1957
|
+
# - 参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
|
1958
|
+
# - 建议:人脸入库选取80以上的图片。
|
1883
1959
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1884
1960
|
# @type Sharpness: Integer
|
1885
|
-
# @param Brightness:
|
1886
|
-
#
|
1887
|
-
#
|
1961
|
+
# @param Brightness: 光照分。
|
1962
|
+
# - 取值范围:[0,100],评价图片光照程度,分数越高越亮。
|
1963
|
+
# - 参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
|
1964
|
+
# - 建议:人脸入库选取[30,70]的图片。
|
1888
1965
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1889
1966
|
# @type Brightness: Integer
|
1890
1967
|
# @param Completeness: 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
|
@@ -1914,16 +1991,16 @@ module TencentCloud
|
|
1914
1991
|
# 检测出的人脸框的位置
|
1915
1992
|
class FaceRect < TencentCloud::Common::AbstractModel
|
1916
1993
|
# @param X: 人脸框左上角横坐标。
|
1917
|
-
# 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
1918
|
-
# 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
1994
|
+
# - 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
1995
|
+
# - 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
1919
1996
|
# @type X: Integer
|
1920
1997
|
# @param Y: 人脸框左上角纵坐标。
|
1921
|
-
# 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
1922
|
-
# 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
1998
|
+
# - 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
1999
|
+
# - 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
1923
2000
|
# @type Y: Integer
|
1924
|
-
# @param Width:
|
2001
|
+
# @param Width: 人脸宽度。
|
1925
2002
|
# @type Width: Integer
|
1926
|
-
# @param Height:
|
2003
|
+
# @param Height: 人脸高度。
|
1927
2004
|
# @type Height: Integer
|
1928
2005
|
|
1929
2006
|
attr_accessor :X, :Y, :Width, :Height
|
@@ -2522,9 +2599,9 @@ module TencentCloud
|
|
2522
2599
|
|
2523
2600
|
# 需要修改的人员库自定义描述字段key-value
|
2524
2601
|
class GroupExDescriptionInfo < TencentCloud::Common::AbstractModel
|
2525
|
-
# @param GroupExDescriptionIndex: 人员库自定义描述字段Index,从0
|
2602
|
+
# @param GroupExDescriptionIndex: 人员库自定义描述字段Index,从0开始。
|
2526
2603
|
# @type GroupExDescriptionIndex: Integer
|
2527
|
-
# @param GroupExDescription:
|
2604
|
+
# @param GroupExDescription: 需要更新的人员库自定义描述字段内容。
|
2528
2605
|
# @type GroupExDescription: String
|
2529
2606
|
|
2530
2607
|
attr_accessor :GroupExDescriptionIndex, :GroupExDescription
|
@@ -2542,21 +2619,23 @@ module TencentCloud
|
|
2542
2619
|
|
2543
2620
|
# 返回的人员库信息
|
2544
2621
|
class GroupInfo < TencentCloud::Common::AbstractModel
|
2545
|
-
# @param GroupName:
|
2622
|
+
# @param GroupName: 人员库名称。
|
2546
2623
|
# @type GroupName: String
|
2547
|
-
# @param GroupId: 人员库ID
|
2624
|
+
# @param GroupId: 人员库ID。
|
2548
2625
|
# @type GroupId: String
|
2549
|
-
# @param GroupExDescriptions:
|
2626
|
+
# @param GroupExDescriptions: 人员库自定义描述字段。
|
2550
2627
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
2551
2628
|
# @type GroupExDescriptions: Array
|
2552
|
-
# @param Tag:
|
2629
|
+
# @param Tag: 人员库信息备注。
|
2553
2630
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
2554
2631
|
# @type Tag: String
|
2555
2632
|
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
|
2556
2633
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
2557
2634
|
# @type FaceModelVersion: String
|
2558
|
-
# @param CreationTimestamp: Group的创建时间和日期 CreationTimestamp。
|
2559
|
-
#
|
2635
|
+
# @param CreationTimestamp: Group的创建时间和日期 CreationTimestamp。
|
2636
|
+
# - CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
2637
|
+
# - Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
2638
|
+
# - 有关更多信息,请参阅 Unix 时间。
|
2560
2639
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
2561
2640
|
# @type CreationTimestamp: Integer
|
2562
2641
|
|
@@ -2829,9 +2908,9 @@ module TencentCloud
|
|
2829
2908
|
|
2830
2909
|
# 需要修改的人员描述字段内容,key-value
|
2831
2910
|
class PersonExDescriptionInfo < TencentCloud::Common::AbstractModel
|
2832
|
-
# @param PersonExDescriptionIndex: 人员描述字段Index,从0
|
2911
|
+
# @param PersonExDescriptionIndex: 人员描述字段Index,从0开始。
|
2833
2912
|
# @type PersonExDescriptionIndex: Integer
|
2834
|
-
# @param PersonExDescription:
|
2913
|
+
# @param PersonExDescription: 需要更新的人员描述字段内容。
|
2835
2914
|
# @type PersonExDescription: String
|
2836
2915
|
|
2837
2916
|
attr_accessor :PersonExDescriptionIndex, :PersonExDescription
|
@@ -2849,9 +2928,9 @@ module TencentCloud
|
|
2849
2928
|
|
2850
2929
|
# 包含此人员的人员库及描述字段内容列表
|
2851
2930
|
class PersonGroupInfo < TencentCloud::Common::AbstractModel
|
2852
|
-
# @param GroupId: 包含此人员的人员库ID
|
2931
|
+
# @param GroupId: 包含此人员的人员库ID。
|
2853
2932
|
# @type GroupId: String
|
2854
|
-
# @param PersonExDescriptions:
|
2933
|
+
# @param PersonExDescriptions: 人员描述字段内容。
|
2855
2934
|
# @type PersonExDescriptions: Array
|
2856
2935
|
|
2857
2936
|
attr_accessor :GroupId, :PersonExDescriptions
|
@@ -2869,18 +2948,20 @@ module TencentCloud
|
|
2869
2948
|
|
2870
2949
|
# 返回的人员信息
|
2871
2950
|
class PersonInfo < TencentCloud::Common::AbstractModel
|
2872
|
-
# @param PersonName:
|
2951
|
+
# @param PersonName: 人员名称。
|
2873
2952
|
# @type PersonName: String
|
2874
|
-
# @param PersonId: 人员Id
|
2953
|
+
# @param PersonId: 人员Id。
|
2875
2954
|
# @type PersonId: String
|
2876
|
-
# @param Gender:
|
2955
|
+
# @param Gender: 人员性别。
|
2877
2956
|
# @type Gender: Integer
|
2878
|
-
# @param PersonExDescriptions:
|
2957
|
+
# @param PersonExDescriptions: 人员描述字段内容。
|
2879
2958
|
# @type PersonExDescriptions: Array
|
2880
|
-
# @param FaceIds:
|
2959
|
+
# @param FaceIds: 包含的人脸照片列表。
|
2881
2960
|
# @type FaceIds: Array
|
2882
|
-
# @param CreationTimestamp: 人员的创建时间和日期 CreationTimestamp。
|
2883
|
-
#
|
2961
|
+
# @param CreationTimestamp: 人员的创建时间和日期 CreationTimestamp。
|
2962
|
+
# - CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。
|
2963
|
+
# - Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
2964
|
+
# - 有关更多信息,请参阅 Unix 时间。
|
2884
2965
|
# @type CreationTimestamp: Integer
|
2885
2966
|
|
2886
2967
|
attr_accessor :PersonName, :PersonId, :Gender, :PersonExDescriptions, :FaceIds, :CreationTimestamp
|
@@ -2906,9 +2987,9 @@ module TencentCloud
|
|
2906
2987
|
|
2907
2988
|
# 坐标
|
2908
2989
|
class Point < TencentCloud::Common::AbstractModel
|
2909
|
-
# @param X: x
|
2990
|
+
# @param X: x坐标。
|
2910
2991
|
# @type X: Integer
|
2911
|
-
# @param Y: Y
|
2992
|
+
# @param Y: Y坐标。
|
2912
2993
|
# @type Y: Integer
|
2913
2994
|
|
2914
2995
|
attr_accessor :X, :Y
|
@@ -2926,12 +3007,13 @@ module TencentCloud
|
|
2926
3007
|
|
2927
3008
|
# 人脸的识别结果
|
2928
3009
|
class Result < TencentCloud::Common::AbstractModel
|
2929
|
-
# @param Candidates:
|
3010
|
+
# @param Candidates: 识别出的最相似候选人。
|
2930
3011
|
# @type Candidates: Array
|
2931
|
-
# @param FaceRect:
|
3012
|
+
# @param FaceRect: 检测出的人脸框位置。
|
2932
3013
|
# @type FaceRect: :class:`Tencentcloud::Iai.v20200303.models.FaceRect`
|
2933
|
-
# @param RetCode: 检测出的人脸图片状态返回码。
|
2934
|
-
# -
|
3014
|
+
# @param RetCode: 检测出的人脸图片状态返回码。
|
3015
|
+
# - 0 表示正常。
|
3016
|
+
# - -1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
2935
3017
|
# @type RetCode: Integer
|
2936
3018
|
|
2937
3019
|
attr_accessor :Candidates, :FaceRect, :RetCode
|
@@ -2965,8 +3047,9 @@ module TencentCloud
|
|
2965
3047
|
# @type FaceRect: :class:`Tencentcloud::Iai.v20200303.models.FaceRect`
|
2966
3048
|
# @param GroupCandidates: 识别结果。
|
2967
3049
|
# @type GroupCandidates: Array
|
2968
|
-
# @param RetCode: 检测出的人脸图片状态返回码。
|
2969
|
-
# -
|
3050
|
+
# @param RetCode: 检测出的人脸图片状态返回码。
|
3051
|
+
# - 0 表示正常。
|
3052
|
+
# - -1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
2970
3053
|
# @type RetCode: Integer
|
2971
3054
|
|
2972
3055
|
attr_accessor :FaceRect, :GroupCandidates, :RetCode
|
@@ -3533,29 +3616,38 @@ module TencentCloud
|
|
3533
3616
|
class VerifyFaceRequest < TencentCloud::Common::AbstractModel
|
3534
3617
|
# @param PersonId: 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
|
3535
3618
|
# @type PersonId: String
|
3536
|
-
# @param Image: 图片 base64
|
3537
|
-
#
|
3538
|
-
#
|
3539
|
-
#
|
3619
|
+
# @param Image: 图片 base64 数据。
|
3620
|
+
# - base64 编码后大小不可超过5M。
|
3621
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
3622
|
+
# - 所有格式的图片短边像素不小于64。
|
3623
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
3624
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
3540
3625
|
# @type Image: String
|
3541
|
-
# @param Url: 图片的 Url
|
3542
|
-
#
|
3543
|
-
#
|
3544
|
-
#
|
3545
|
-
#
|
3546
|
-
#
|
3547
|
-
#
|
3626
|
+
# @param Url: 图片的 Url 。
|
3627
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
3628
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
3629
|
+
# - 所有格式的图片短边像素不小于64。
|
3630
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
3631
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
3632
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
3633
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
3634
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
3548
3635
|
# @type Url: String
|
3549
3636
|
# @param QualityControl: 图片质量控制。
|
3550
|
-
#
|
3551
|
-
#
|
3552
|
-
#
|
3553
|
-
#
|
3554
|
-
#
|
3555
|
-
#
|
3556
|
-
#
|
3637
|
+
# - 取值范围:
|
3638
|
+
# 0: 不进行控制。
|
3639
|
+
# 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
3640
|
+
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
3641
|
+
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
3642
|
+
# 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
3643
|
+
# - 默认 0。
|
3644
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
3557
3645
|
# @type QualityControl: Integer
|
3558
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
3646
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
3647
|
+
# - 取值范围:0为不开启,1为开启。
|
3648
|
+
# - 默认为0。
|
3649
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
3650
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
3559
3651
|
# @type NeedRotateDetection: Integer
|
3560
3652
|
|
3561
3653
|
attr_accessor :PersonId, :Image, :Url, :QualityControl, :NeedRotateDetection
|
@@ -3579,15 +3671,16 @@ module TencentCloud
|
|
3579
3671
|
|
3580
3672
|
# VerifyFace返回参数结构体
|
3581
3673
|
class VerifyFaceResponse < TencentCloud::Common::AbstractModel
|
3582
|
-
# @param Score: 给定的人脸图片与 PersonId
|
3583
|
-
|
3584
|
-
# 不同算法版本返回的相似度分数不同。
|
3585
|
-
# 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
3586
|
-
# 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
3674
|
+
# @param Score: 给定的人脸图片与 PersonId 对应人脸的相似度。
|
3675
|
+
# - 若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
|
3676
|
+
# - 不同算法版本返回的相似度分数不同。
|
3677
|
+
# - 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
3678
|
+
# - 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
3587
3679
|
# @type Score: Float
|
3588
|
-
# @param IsMatch: 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score
|
3680
|
+
# @param IsMatch: 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断。
|
3589
3681
|
# @type IsMatch: Boolean
|
3590
|
-
# @param FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person
|
3682
|
+
# @param FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。
|
3683
|
+
# - 在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
|
3591
3684
|
# @type FaceModelVersion: String
|
3592
3685
|
# @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
3593
3686
|
# @type RequestId: String
|
@@ -3614,28 +3707,35 @@ module TencentCloud
|
|
3614
3707
|
# @param PersonId: 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
|
3615
3708
|
# @type PersonId: String
|
3616
3709
|
# @param Image: 图片 base64 数据。
|
3617
|
-
# jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
3618
|
-
#
|
3619
|
-
#
|
3710
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
3711
|
+
# - 所有格式的图片短边像素不小于64。
|
3712
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
3713
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
3620
3714
|
# @type Image: String
|
3621
3715
|
# @param Url: 图片的 Url
|
3622
|
-
# jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
|
3623
|
-
#
|
3624
|
-
#
|
3625
|
-
#
|
3626
|
-
#
|
3627
|
-
#
|
3716
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
3717
|
+
# - 所有格式的图片短边像素不小于64。
|
3718
|
+
# - 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
3719
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
3720
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
3721
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
3722
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
3628
3723
|
# @type Url: String
|
3629
3724
|
# @param QualityControl: 图片质量控制。
|
3630
|
-
#
|
3631
|
-
#
|
3632
|
-
#
|
3633
|
-
#
|
3634
|
-
#
|
3635
|
-
#
|
3636
|
-
#
|
3725
|
+
# - 取值范围:
|
3726
|
+
# 0: 不进行控制。
|
3727
|
+
# 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
3728
|
+
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
3729
|
+
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
3730
|
+
# 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
3731
|
+
# - 默认 0。
|
3732
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
3637
3733
|
# @type QualityControl: Integer
|
3638
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
3734
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
3735
|
+
# - 取值范围:0为不开启,1为开启。
|
3736
|
+
# - 默认为0。
|
3737
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
3738
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
3639
3739
|
# @type NeedRotateDetection: Integer
|
3640
3740
|
|
3641
3741
|
attr_accessor :PersonId, :Image, :Url, :QualityControl, :NeedRotateDetection
|
@@ -3663,7 +3763,8 @@ module TencentCloud
|
|
3663
3763
|
# @type Score: Float
|
3664
3764
|
# @param IsMatch: 是否为同一人的判断。
|
3665
3765
|
# @type IsMatch: Boolean
|
3666
|
-
# @param FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person
|
3766
|
+
# @param FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。
|
3767
|
+
# - 在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
|
3667
3768
|
# @type FaceModelVersion: String
|
3668
3769
|
# @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
3669
3770
|
# @type RequestId: String
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: tencentcloud-sdk-iai
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 3.0.
|
4
|
+
version: 3.0.940
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Tencent Cloud
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2024-11-
|
11
|
+
date: 2024-11-12 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: tencentcloud-sdk-common
|