tencentcloud-sdk-nodejs 4.0.970 → 4.0.971

package/src/services/iai/v20200303/iai_models.ts

@@ -21,24 +21,24 @@
 export interface Eye {
   /**
    * 识别是否佩戴眼镜。
-AttributeItem对应的Type为 —— 0：无眼镜，1：普通眼镜，2：墨镜
+- AttributeItem对应的Type为 —— 0：无眼镜，1：普通眼镜，2：墨镜
    */
-  Glass: AttributeItem
+  Glass?: AttributeItem
   /**
    * 识别眼睛的睁开、闭合状态。
-AttributeItem对应的Type为 —— 0：睁开，1：闭眼
+- AttributeItem对应的Type为 —— 0：睁开，1：闭眼
    */
-  EyeOpen: AttributeItem
+  EyeOpen?: AttributeItem
   /**
    * 识别是否双眼皮。
-AttributeItem对应的Type为 —— 0：无，1：有。
+- AttributeItem对应的Type为 —— 0：无，1：有。
    */
-  EyelidType: AttributeItem
+  EyelidType?: AttributeItem
   /**
    * 眼睛大小。
-AttributeItem对应的Type为 —— 0：小眼睛，1：普通眼睛，2：大眼睛。
+- AttributeItem对应的Type为 —— 0：小眼睛，1：普通眼睛，2：大眼睛。
    */
-  EyeSize: AttributeItem
+  EyeSize?: AttributeItem
 }
 
 /**
@@ -46,38 +46,38 @@ AttributeItem对应的Type为 —— 0：小眼睛，1：普通眼睛，2：大
  */
 export interface Candidate {
   /**
-   * 人员ID
+   * 人员ID。
    */
-  PersonId: string
+  PersonId?: string
   /**
-   * 人脸ID，仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。人员搜索类接口采用融合特征方式检索，该字段无意义
+   * 人脸ID。
+- 仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。
+- 人员搜索类接口采用融合特征方式检索，该字段无意义。
    */
-  FaceId: string
+  FaceId?: string
   /**
    * 候选者的匹配得分。 
-
-1万大小人脸底库下，误识率百分之一对应分数为70分，误识率千分之一对应分数为80分，误识率万分之一对应分数为90分；
-10万大小人脸底库下，误识率百分之一对应分数为80分，误识率千分之一对应分数为90分，误识率万分之一对应分数为100分；
-30万大小人脸底库下，误识率百分之一对应分数为85分，误识率千分之一对应分数为95分。
-
-一般80分左右可适用大部分场景，建议分数不要超过90分。您可以根据实际情况选择合适的分数。
+- 1万大小人脸底库下，误识率百分之一对应分数为70分，误识率千分之一对应分数为80分，误识率万分之一对应分数为90分。
+- 10万大小人脸底库下，误识率百分之一对应分数为80分，误识率千分之一对应分数为90分，误识率万分之一对应分数为100分。
+- 30万大小人脸底库下，误识率百分之一对应分数为85分，误识率千分之一对应分数为95分。
+- 一般80分左右可适用大部分场景，建议分数不要超过90分。您可以根据实际情况选择合适的分数。
    */
-  Score: number
+  Score?: number
   /**
-   * 人员名称
+   * 人员名称。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  PersonName: string
+  PersonName?: string
   /**
-   * 人员性别
+   * 人员性别。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Gender: number
+  Gender?: number
   /**
-   * 包含此人员的人员库及描述字段内容列表
+   * 包含此人员的人员库及描述字段内容列表。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  PersonGroupInfos: Array<PersonGroupInfo>
+  PersonGroupInfos?: Array<PersonGroupInfo>
 }
 
 /**
@@ -133,13 +133,13 @@ export interface SearchPersonsReturnsByGroupResponse {
  */
 export interface PersonGroupInfo {
   /**
-   * 包含此人员的人员库ID
+   * 包含此人员的人员库ID。
    */
-  GroupId: string
+  GroupId?: string
   /**
-   * 人员描述字段内容
+   * 人员描述字段内容。
    */
-  PersonExDescriptions: Array<string>
+  PersonExDescriptions?: Array<string>
 }
 
 /**
@@ -270,20 +270,20 @@ RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
  */
 export interface FaceHairAttributesInfo {
   /**
-   * 0：光头，1：短发，2：中发，3：长发，4：绑发
+   * 取值范围：0：光头，1：短发，2：中发，3：长发，4：绑发。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Length: number
+  Length?: number
   /**
-   * 0：有刘海，1：无刘海
+   * 取值范围：0：有刘海，1：无刘海。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Bang: number
+  Bang?: number
   /**
-   * 0：黑色，1：金色，2：棕色，3：灰白色
+   * 取值范围：0：黑色，1：金色，2：棕色，3：灰白色。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Color: number
+  Color?: number
 }
 
 /**
@@ -395,34 +395,37 @@ export interface GetPersonGroupInfoRequest {
 export interface FaceInfo {
   /**
    * 人脸框左上角横坐标。
-人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 
-若需截取完整人脸，可以在完整分completeness满足需求的情况下，将负值坐标取0。
+- 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 
+- 若需截取完整人脸，可以在完整分completeness满足需求的情况下，将负值坐标取0。
    */
-  X: number
+  X?: number
   /**
    * 人脸框左上角纵坐标。 
-人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 
-若需截取完整人脸，可以在完整分completeness满足需求的情况下，将负值坐标取0。
+- 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 
+- 若需截取完整人脸，可以在完整分completeness满足需求的情况下，将负值坐标取0。
    */
-  Y: number
+  Y?: number
   /**
    * 人脸框宽度。
    */
-  Width: number
+  Width?: number
   /**
    * 人脸框高度。
    */
-  Height: number
+  Height?: number
   /**
-   * 人脸属性信息，包含性别( gender )、年龄( age )、表情( expression )、 
-魅力( beauty )、眼镜( glass )、口罩（mask）、头发（hair）和姿态 (pitch，roll，yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
+   * 人脸属性信息。
+- 包含性别( gender )、年龄( age )、表情( expression )、魅力( beauty )、眼镜( glass )、口罩（mask）、头发（hair）和姿态 (pitch，roll，yaw )。
+- 只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
    */
-  FaceAttributesInfo: FaceAttributesInfo
+  FaceAttributesInfo?: FaceAttributesInfo
   /**
-   * 人脸质量信息，包含质量分（score）、模糊分（sharpness）、光照分（brightness）、遮挡分（completeness）。只有当NeedFaceDetection设为1时才返回有效信息。
+   * 人脸质量信息。
+- 包含质量分（score）、模糊分（sharpness）、光照分（brightness）、遮挡分（completeness）。
+- 只有当NeedFaceDetection设为1时才返回有效信息。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  FaceQualityInfo: FaceQualityInfo
+  FaceQualityInfo?: FaceQualityInfo
 }
 
 /**
@@ -431,19 +434,19 @@ export interface FaceInfo {
 export interface Eyebrow {
   /**
    * 眉毛浓密。
-AttributeItem对应的Type为 —— 0：淡眉，1：浓眉。
+- AttributeItem对应的Type为 —— 0：淡眉，1：浓眉。
    */
-  EyebrowDensity: AttributeItem
+  EyebrowDensity?: AttributeItem
   /**
    * 眉毛弯曲。
-AttributeItem对应的Type为 —— 0：不弯，1：弯眉。
+- AttributeItem对应的Type为 —— 0：不弯，1：弯眉。
    */
-  EyebrowCurve: AttributeItem
+  EyebrowCurve?: AttributeItem
   /**
    * 眉毛长短。
-AttributeItem对应的Type为 —— 0：短眉毛，1：长眉毛。
+- AttributeItem对应的Type为 —— 0：短眉毛，1：长眉毛。
    */
-  EyebrowLength: AttributeItem
+  EyebrowLength?: AttributeItem
 }
 
 /**
@@ -451,24 +454,27 @@ AttributeItem对应的Type为 —— 0：短眉毛，1：长眉毛。
  */
 export interface AnalyzeDenseLandmarksRequest {
   /**
-   * 检测模式。0 为检测所有出现的人脸， 1 为检测面积最大的人脸。 
-默认为 0。 
-最多返回 5 张人脸的五官定位（人脸关键点）具体信息。
+   * 检测模式。
+- 取值范围：0 为检测所有出现的人脸， 1 为检测面积最大的人脸。 
+- 默认为 0。 
+- 最多返回 5 张人脸的五官定位（人脸关键点）具体信息。
    */
   Mode?: number
   /**
-   * 图片 base64 数据，base64 编码后大小不可超过5M。  
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+   * 图片 base64 数据。
+- base64 编码后大小不可超过5M。  
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Image?: string
   /**
-   * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。  
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
-Url、Image必须提供一个，如果都提供，只使用 Url。  
-图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。  
-非腾讯云存储的Url速度和稳定性可能受一定影响。  
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+   * 图片的 Url 。
+- 对应图片 base64 编码后大小不可超过5M。  
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
+- Url、Image必须提供一个，如果都提供，只使用 Url。  
+- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。  
+- 非腾讯云存储的Url速度和稳定性可能受一定影响。  
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Url?: string
   /**
@@ -476,7 +482,11 @@ Url、Image必须提供一个，如果都提供，只使用 Url。
    */
   FaceModelVersion?: string
   /**
-   * 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
+   * 是否开启图片旋转识别支持。
+- 取值范围：0为不开启，1为开启。
+- 默认为0。
+- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
+- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
    */
   NeedRotateDetection?: number
 }
@@ -561,13 +571,16 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00
  */
 export interface DetectLiveFaceAccurateResponse {
   /**
-   * 活体打分，取值范围 [0,100]，根据活体分数对应的阈值区间来判断是否为翻拍。目前阈值可分为[5,10,40,70,90]，其中推荐阈值为40。
+   * 活体打分。
+- 取值范围 [0,100]。
+- 根据活体分数对应的阈值区间来判断是否为翻拍。
+- 目前阈值可分为[5,10,40,70,90]，其中推荐阈值为40。
    */
-  Score: number
+  Score?: number
   /**
    * 人脸识别所用的算法模型版本。
    */
-  FaceModelVersion: string
+  FaceModelVersion?: string
   /**
    * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
    */
@@ -579,38 +592,45 @@ export interface DetectLiveFaceAccurateResponse {
  */
 export interface AnalyzeFaceRequest {
   /**
-   * 检测模式。0 为检测所有出现的人脸， 1 为检测面积最大的人脸。默认为 0。最多返回 10 张人脸的五官定位（人脸关键点）具体信息。
+   * 检测模式。
+- 取值范围：
+0 为检测所有出现的人脸。
+1 为检测面积最大的人脸。
+- 默认为 0。
+- 最多返回 10 张人脸的五官定位（人脸关键点）具体信息。
    */
   Mode?: number
   /**
-   * 图片 base64 数据，base64 编码后大小不可超过5M。
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+   * 图片 base64 数据。
+- base64 编码后大小不可超过5M。
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Image?: string
   /**
-   * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
-Url、Image必须提供一个，如果都提供，只使用 Url。  
-图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
-非腾讯云存储的Url速度和稳定性可能受一定影响。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+   * 图片的 Url 。
+- 对应图片 base64 编码后大小不可超过5M。
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
+- Url、Image必须提供一个，如果都提供，只使用 Url。  
+- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
+- 非腾讯云存储的Url速度和稳定性可能受一定影响。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Url?: string
   /**
    * 人脸识别服务所用的算法模型版本。
-
-目前入参支持 “2.0”和“3.0“ 两个输入。
-
-2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
-
-2020年11月26日后开通服务的账号仅支持输入“3.0”。
-
-不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
+- 目前入参支持 “2.0”和“3.0“ 两个输入。
+- 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
+- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
+- 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
    */
   FaceModelVersion?: string
   /**
-   * 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
+   * 是否开启图片旋转识别支持。
+- 0为不开启，1为开启。
+- 默认为0。
+- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
+- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
    */
   NeedRotateDetection?: number
 }
@@ -690,11 +710,11 @@ export interface GroupCandidate {
   /**
    * 人员库ID 。
    */
-  GroupId: string
+  GroupId?: string
   /**
    * 识别出的最相似候选人。
    */
-  Candidates: Array<Candidate>
+  Candidates?: Array<Candidate>
 }
 
 /**
@@ -903,34 +923,36 @@ export interface GetUpgradeGroupFaceModelVersionResultRequest {
  */
 export interface GroupInfo {
   /**
-   * 人员库名称
+   * 人员库名称。
    */
-  GroupName: string
+  GroupName?: string
   /**
-   * 人员库ID
+   * 人员库ID。
    */
-  GroupId: string
+  GroupId?: string
   /**
-   * 人员库自定义描述字段
+   * 人员库自定义描述字段。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  GroupExDescriptions: Array<string>
+  GroupExDescriptions?: Array<string>
   /**
-   * 人员库信息备注
+   * 人员库信息备注。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Tag: string
+  Tag?: string
   /**
    * 人脸识别所用的算法模型版本。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  FaceModelVersion: string
+  FaceModelVersion?: string
   /**
-   * Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。 
-Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。有关更多信息，请参阅 Unix 时间。
+   * Group的创建时间和日期 CreationTimestamp。
+- CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。 
+- Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。
+- 有关更多信息，请参阅 Unix 时间。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  CreationTimestamp: number
+  CreationTimestamp?: number
 }
 
 /**
@@ -938,32 +960,35 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00
  */
 export interface FaceQualityInfo {
   /**
-   * 质量分: [0,100]，综合评价图像质量是否适合人脸识别，分数越高质量越好。 
-正常情况，只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
-参考范围：[0,40]较差，[40,60] 一般，[60,80]较好，[80,100]很好。 
-建议：人脸入库选取70以上的图片。
+   * 质量分。
+- 取值范围：[0,100]，综合评价图像质量是否适合人脸识别，分数越高质量越好。 
+- 正常情况，只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
+- 参考范围：[0,40]较差，[40,60] 一般，[60,80]较好，[80,100]很好。 
+- 建议：人脸入库选取70以上的图片。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Score: number
+  Score?: number
   /**
-   * 清晰分：[0,100]，评价图片清晰程度，分数越高越清晰。 
-参考范围：[0,40]特别模糊，[40,60]模糊，[60,80]一般，[80,100]清晰。 
-建议：人脸入库选取80以上的图片。
+   * 清晰分。
+- 取值范围：[0,100]，评价图片清晰程度，分数越高越清晰。 
+- 参考范围：[0,40]特别模糊，[40,60]模糊，[60,80]一般，[80,100]清晰。 
+- 建议：人脸入库选取80以上的图片。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Sharpness: number
+  Sharpness?: number
   /**
-   * 光照分：[0,100]，评价图片光照程度，分数越高越亮。 
-参考范围： [0,30]偏暗，[30,70]光照正常，[70,100]偏亮。 
-建议：人脸入库选取[30,70]的图片。
+   * 光照分。
+- 取值范围：[0,100]，评价图片光照程度，分数越高越亮。 
+- 参考范围： [0,30]偏暗，[30,70]光照正常，[70,100]偏亮。 
+- 建议：人脸入库选取[30,70]的图片。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Brightness: number
+  Brightness?: number
   /**
    * 五官遮挡分，评价眉毛（Eyebrow）、眼睛（Eye）、鼻子（Nose）、脸颊（Cheek）、嘴巴（Mouth）、下巴（Chin）的被遮挡程度。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Completeness: FaceQualityCompleteness
+  Completeness?: FaceQualityCompleteness
 }
 
 /**
@@ -1082,95 +1107,95 @@ export interface DenseFaceShape {
   /**
    * 人脸框左上角横坐标。
    */
-  X: number
+  X?: number
   /**
    * 人脸框左上角纵坐标。
    */
-  Y: number
+  Y?: number
   /**
    * 人脸框宽度。
    */
-  Width: number
+  Width?: number
   /**
    * 人脸框高度。
    */
-  Height: number
+  Height?: number
   /**
    * 描述左侧眼睛轮廓的 XX 点。
    */
-  LeftEye: Array<Point>
+  LeftEye?: Array<Point>
   /**
    * 描述右侧眼睛轮廓的 XX 点。
    */
-  RightEye: Array<Point>
+  RightEye?: Array<Point>
   /**
    * 描述左侧眉毛轮廓的 XX 点。
    */
-  LeftEyeBrow: Array<Point>
+  LeftEyeBrow?: Array<Point>
   /**
    * 描述右侧眉毛轮廓的 XX 点。
    */
-  RightEyeBrow: Array<Point>
+  RightEyeBrow?: Array<Point>
   /**
    * 描述外嘴巴轮廓的 XX 点， 从左侧开始逆时针返回。
    */
-  MouthOutside: Array<Point>
+  MouthOutside?: Array<Point>
   /**
    * 描述内嘴巴轮廓的 XX 点，从左侧开始逆时针返回。
    */
-  MouthInside: Array<Point>
+  MouthInside?: Array<Point>
   /**
    * 描述鼻子轮廓的 XX 点。
    */
-  Nose: Array<Point>
+  Nose?: Array<Point>
   /**
    * 左瞳孔轮廓的 XX 个点。
    */
-  LeftPupil: Array<Point>
+  LeftPupil?: Array<Point>
   /**
    * 右瞳孔轮廓的 XX 个点。
    */
-  RightPupil: Array<Point>
+  RightPupil?: Array<Point>
   /**
    * 中轴线轮廓的 XX 个点。
    */
-  CentralAxis: Array<Point>
+  CentralAxis?: Array<Point>
   /**
    * 下巴轮廓的 XX 个点。
    */
-  Chin: Array<Point>
+  Chin?: Array<Point>
   /**
    * 左眼袋的 XX 个点。
    */
-  LeftEyeBags: Array<Point>
+  LeftEyeBags?: Array<Point>
   /**
    * 右眼袋的 XX 个点。
    */
-  RightEyeBags: Array<Point>
+  RightEyeBags?: Array<Point>
   /**
    * 额头的 XX 个点。
    */
-  Forehead: Array<Point>
+  Forehead?: Array<Point>
 }
 
 /**
  * 识别结果。
-
  */
 export interface ResultsReturnsByGroup {
   /**
    * 检测出的人脸框位置。
    */
-  FaceRect: FaceRect
+  FaceRect?: FaceRect
   /**
    * 识别结果。
    */
-  GroupCandidates: Array<GroupCandidate>
+  GroupCandidates?: Array<GroupCandidate>
   /**
-   * 检测出的人脸图片状态返回码。0 表示正常。 
--1601代表不符合图片质量控制要求，此时Candidate内容为空。
+   * 检测出的人脸图片状态返回码。
+- 0 表示正常。 
+- -1601代表不符合图片质量控制要求，此时Candidate内容为空。
    */
-  RetCode: number
+  RetCode?: number
 }
 
 /**
@@ -1178,13 +1203,13 @@ export interface ResultsReturnsByGroup {
  */
 export interface Point {
   /**
-   * x坐标
+   * x坐标。
    */
-  X: number
+  X?: number
   /**
-   * Y坐标
+   * Y坐标。
    */
-  Y: number
+  Y?: number
 }
 
 /**
@@ -1228,35 +1253,44 @@ export interface VerifyFaceRequest {
    */
   PersonId: string
   /**
-   * 图片 base64 数据，base64 编码后大小不可超过5M。
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
-若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+   * 图片 base64 数据。
+- base64 编码后大小不可超过5M。
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
+- 所有格式的图片短边像素不小于64。
+- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Image?: string
   /**
-   * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
-Url、Image必须提供一个，如果都提供，只使用 Url。  
-图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
-非腾讯云存储的Url速度和稳定性可能受一定影响。
-若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+   * 图片的 Url 。
+- 对应图片 base64 编码后大小不可超过5M。
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
+- 所有格式的图片短边像素不小于64。
+- Url、Image必须提供一个，如果都提供，只使用 Url。  
+- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
+- 非腾讯云存储的Url速度和稳定性可能受一定影响。
+- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Url?: string
   /**
    * 图片质量控制。 
-0: 不进行控制； 
-1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 
-2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 
-3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 
-4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； 
-默认 0。 
-若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
+- 取值范围：
+0: 不进行控制。
+1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
+2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。
+3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。
+4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。
+- 默认 0。 
+- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
    */
   QualityControl?: number
   /**
-   * 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
+   * 是否开启图片旋转识别支持。
+- 取值范围：0为不开启，1为开启。
+- 默认为0。
+- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
+- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
    */
   NeedRotateDetection?: number
 }
@@ -1316,18 +1350,19 @@ AttributeItem对应的Type为 —— 0：黑色，1：金色，2：棕色，3：
  */
 export interface Result {
   /**
-   * 识别出的最相似候选人
+   * 识别出的最相似候选人。
    */
-  Candidates: Array<Candidate>
+  Candidates?: Array<Candidate>
   /**
-   * 检测出的人脸框位置
+   * 检测出的人脸框位置。
    */
-  FaceRect: FaceRect
+  FaceRect?: FaceRect
   /**
-   * 检测出的人脸图片状态返回码。0 表示正常。 
--1601代表不符合图片质量控制要求，此时Candidate内容为空。
+   * 检测出的人脸图片状态返回码。
+- 0 表示正常。 
+- -1601代表不符合图片质量控制要求，此时Candidate内容为空。
    */
-  RetCode: number
+  RetCode?: number
 }
 
 /**
@@ -1503,41 +1538,47 @@ export interface RevertGroupFaceModelVersionRequest {
  */
 export interface FaceQualityCompleteness {
   /**
-   * 眉毛的遮挡分数[0,100]，分数越高遮挡越少。 
-参考范围：[0,80]表示发生遮挡。
+   * 眉毛的遮挡分数。
+- 取值范围：[0,100]，分数越高遮挡越少。 
+- 参考范围：[0,80]表示发生遮挡。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Eyebrow: number
+  Eyebrow?: number
   /**
-   * 眼睛的遮挡分数[0,100],分数越高遮挡越少。 
-参考范围：[0,80]表示发生遮挡。
+   * 眼睛的遮挡分数。
+- 取值范围：[0,100],分数越高遮挡越少。 
+- 参考范围：[0,80]表示发生遮挡。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Eye: number
+  Eye?: number
   /**
-   * 鼻子的遮挡分数[0,100],分数越高遮挡越少。 
-参考范围：[0,60]表示发生遮挡。
+   * 鼻子的遮挡分数。
+- 取值范围：[0,100],分数越高遮挡越少。 
+- 参考范围：[0,60]表示发生遮挡。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Nose: number
+  Nose?: number
   /**
-   * 脸颊的遮挡分数[0,100],分数越高遮挡越少。 
-参考范围：[0,70]表示发生遮挡。
+   * 脸颊的遮挡分数。
+- 取值范围：[0,100],分数越高遮挡越少。 
+- 参考范围：[0,70]表示发生遮挡。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Cheek: number
+  Cheek?: number
   /**
-   * 嘴巴的遮挡分数[0,100],分数越高遮挡越少。 
-参考范围：[0,50]表示发生遮挡。
+   * 嘴巴的遮挡分数。
+- 取值范围：[0,100],分数越高遮挡越少。 
+- 参考范围：[0,50]表示发生遮挡。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Mouth: number
+  Mouth?: number
   /**
-   * 下巴的遮挡分数[0,100],分数越高遮挡越少。 
-参考范围：[0,70]表示发生遮挡。
+   * 下巴的遮挡分数。
+- 取值范围：[0,100],分数越高遮挡越少。 
+- 参考范围：[0,70]表示发生遮挡。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Chin: number
+  Chin?: number
 }
 
 /**
@@ -1546,57 +1587,81 @@ export interface FaceQualityCompleteness {
  */
 export interface FaceAttributesInfo {
   /**
-   * 性别[0~49]为女性，[50，100]为男性，越接近0和100表示置信度越高。NeedFaceAttributes 不为 1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 性别。
+- 取值说明：[0~49]为女性，[50，100]为男性，越接近0和100表示置信度越高。
+- NeedFaceAttributes 不为 1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Gender?: number
   /**
-   * 年龄 [0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 年龄 。
+- 取值范围：[0~100]。
+- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Age?: number
   /**
-   * 微笑[0(normal，正常)~100(laugh，大笑)]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 微笑。
+- 取值说明：[0(normal，正常)~100(laugh，大笑)]。
+- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Expression?: number
   /**
-   * 是否有眼镜 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 是否有眼镜。
+- 取值范围： [true,false]。
+- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Glass?: boolean
   /**
-   * 上下偏移[-30,30]，单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。 
-建议：人脸入库选择[-10,10]的图片。
+   * 上下偏移。
+- 取值范围：[-30,30]，单位角度。
+- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。 
+- 建议：人脸入库选择[-10,10]的图片。
    */
   Pitch?: number
   /**
-   * 左右偏移[-30,30]，单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。 
-建议：人脸入库选择[-10,10]的图片。
+   * 左右偏移。
+- 取值范围：[-30,30]，单位角度。 
+- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。 
+- 建议：人脸入库选择[-10,10]的图片。
    */
   Yaw?: number
   /**
-   * 平面旋转[-180,180]，单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。  
-建议：人脸入库选择[-20,20]的图片。
+   * 平面旋转。
+- 取值范围：[-180,180]，单位角度。 
+- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。  
+- 建议：人脸入库选择[-20,20]的图片。
    */
   Roll?: number
   /**
-   * 魅力[0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 魅力。
+- 取值范围：[0~100]。
+- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Beauty?: number
   /**
-   * 是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 是否有帽子。
+- 取值范围： [true,false]。
+- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   Hat?: boolean
   /**
-   * 是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 是否有口罩。
+- 取值范围： [true,false]。
+- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   Mask?: boolean
   /**
-   * 头发信息，包含头发长度（length）、有无刘海（bang）、头发颜色（color）。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 头发信息，包含头发长度（length）、有无刘海（bang）、头发颜色（color）。
+- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   Hair?: FaceHairAttributesInfo
   /**
-   * 双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼，就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 双眼是否睁开。
+- 取值范围： [true,false]。
+- 只要有超过一只眼睛闭眼，就返回false。
+-  NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   EyeOpen?: boolean
@@ -1612,34 +1677,41 @@ export interface VerifyPersonRequest {
   PersonId: string
   /**
    * 图片 base64 数据。
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
-若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
+- 所有格式的图片短边像素不小于64。
+- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Image?: string
   /**
    * 图片的 Url 
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。。
- 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 
-图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
-非腾讯云存储的Url速度和稳定性可能受一定影响。
-若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
+- 所有格式的图片短边像素不小于64。
+-  图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 
+- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
+- 非腾讯云存储的Url速度和稳定性可能受一定影响。
+- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Url?: string
   /**
    * 图片质量控制。 
-0: 不进行控制； 
-1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 
-2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 
-3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 
-4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； 
-默认 0。 
-若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
+- 取值范围：
+0: 不进行控制。
+1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
+2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。
+3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。
+4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。
+- 默认 0。 
+- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
    */
   QualityControl?: number
   /**
-   * 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
+   * 是否开启图片旋转识别支持。
+- 取值范围：0为不开启，1为开启。
+- 默认为0。
+- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
+- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
    */
   NeedRotateDetection?: number
 }
@@ -1689,21 +1761,23 @@ export interface ModifyPersonBaseInfoRequest {
  */
 export interface DetectLiveFaceAccurateRequest {
   /**
-   * 图片 base64 数据，base64 编码后大小不可超过5M。
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 
-图片的宽高比请接近 3:4，手机拍摄比例最佳。
-人脸尺寸大于100X100像素。
-图片格式支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+   * 图片 base64 数据。
+- base64 编码后大小不可超过5M。
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 
+- 图片的宽高比请接近 3:4，手机拍摄比例最佳。
+- 人脸尺寸大于100X100像素。
+- 图片格式支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Image?: string
   /**
-   * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
-Url、Image必须提供一个，如果都提供，只使用 Url。 
-图片的宽高比请接近 3:4，手机拍摄比例最佳。
-人脸尺寸大于100X100像素。
-图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
-图片格式支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+   * 图片的 Url 。
+- 对应图片 base64 编码后大小不可超过5M。
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
+- Url、Image必须提供一个，如果都提供，只使用 Url。 
+- 图片的宽高比请接近 3:4，手机拍摄比例最佳。
+- 人脸尺寸大于100X100像素。
+- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
+- 图片格式支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Url?: string
   /**
@@ -1717,21 +1791,22 @@ Url、Image必须提供一个，如果都提供，只使用 Url。
  */
 export interface VerifyFaceResponse {
   /**
-   * 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸（Face），返回相似度最大的分数。
-
-不同算法版本返回的相似度分数不同。
-若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
-2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
+   * 给定的人脸图片与 PersonId 对应人脸的相似度。
+- 若 PersonId 下有多张人脸（Face），返回相似度最大的分数。
+- 不同算法版本返回的相似度分数不同。
+- 若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
+- 2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
    */
-  Score: number
+  Score?: number
   /**
-   * 是否为同一人判断，固定阈值分数为60分，若想更灵活地调整阈值可取Score参数返回进行判断
+   * 是否为同一人判断，固定阈值分数为60分，若想更灵活地调整阈值可取Score参数返回进行判断。
    */
-  IsMatch: boolean
+  IsMatch?: boolean
   /**
-   * 人脸识别所用的算法模型版本，是该 Person 所在的人员库的算法模型版本。在创建人员库时设置，详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
+   * 人脸识别所用的算法模型版本，是该 Person 所在的人员库的算法模型版本。
+- 在创建人员库时设置，详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
    */
-  FaceModelVersion: string
+  FaceModelVersion?: string
   /**
    * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
    */
@@ -1747,11 +1822,9 @@ export interface FaceDetailInfo {
    */
   FaceRect?: FaceRect
   /**
-   * 人脸属性信息，根据 FaceAttributesType 输入的类型，返回年龄（Age）、颜值（Beauty） 
-情绪（Emotion）、眼睛信息（Eye）、眉毛（Eyebrow）、性别（Gender） 
-头发（Hair）、帽子（Hat）、姿态（Headpose）、口罩（Mask）、嘴巴（Mouth）、胡子（Moustache） 
-鼻子（Nose）、脸型（Shape）、肤色（Skin）、微笑（Smile）等人脸属性信息。  
-若 FaceAttributesType 没有输入相关类型，则FaceDetaiAttributesInfo返回的细项不具备参考意义。
+   * 人脸属性信息。
+- 根据 FaceAttributesType 输入的类型，返回年龄（Age）、颜值（Beauty）、情绪（Emotion）、眼睛信息（Eye）、眉毛（Eyebrow）、性别（Gender）、头发（Hair）、帽子（Hat）、姿态（Headpose）、口罩（Mask）、嘴巴（Mouth）、胡子（Moustache） 、鼻子（Nose）、脸型（Shape）、肤色（Skin）、微笑（Smile）等人脸属性信息。  
+- 若 FaceAttributesType 没有输入相关类型，则FaceDetaiAttributesInfo返回的细项不具备参考意义。
    */
   FaceDetailAttributesInfo?: FaceDetailAttributesInfo
 }
@@ -1891,30 +1964,32 @@ MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要
  */
 export interface PersonInfo {
   /**
-   * 人员名称
+   * 人员名称。
    */
-  PersonName: string
+  PersonName?: string
   /**
-   * 人员Id
+   * 人员Id。
    */
-  PersonId: string
+  PersonId?: string
   /**
-   * 人员性别
+   * 人员性别。
    */
-  Gender: number
+  Gender?: number
   /**
-   * 人员描述字段内容
+   * 人员描述字段内容。
    */
-  PersonExDescriptions: Array<string>
+  PersonExDescriptions?: Array<string>
   /**
-   * 包含的人脸照片列表
+   * 包含的人脸照片列表。
    */
-  FaceIds: Array<string>
+  FaceIds?: Array<string>
   /**
-   * 人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。 
-Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。有关更多信息，请参阅 Unix 时间。
+   * 人员的创建时间和日期 CreationTimestamp。
+- CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。 
+- Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。
+- 有关更多信息，请参阅 Unix 时间。
    */
-  CreationTimestamp: number
+  CreationTimestamp?: number
 }
 
 /**
@@ -1922,11 +1997,11 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00
  */
 export interface GroupExDescriptionInfo {
   /**
-   * 人员库自定义描述字段Index，从0开始
+   * 人员库自定义描述字段Index，从0开始。
    */
   GroupExDescriptionIndex: number
   /**
-   * 需要更新的人员库自定义描述字段内容
+   * 需要更新的人员库自定义描述字段内容。
    */
   GroupExDescription: string
 }
@@ -2017,55 +2092,67 @@ export interface AnalyzeFaceResponse {
  */
 export interface DetectFaceRequest {
   /**
-   * 最多处理的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 
-此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。
+   * 最多处理的人脸数目。
+- 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 
+- 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。
    */
   MaxFaceNum?: number
   /**
    * 人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。
-只支持设置34和20，建议使用34。
-
+- 只支持设置34和20，建议使用34。
    */
   MinFaceSize?: number
   /**
-   * 图片 base64 数据，base64 编码后大小不可超过5M。
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+   * 图片 base64 数据。
+- base64 编码后大小不可超过5M。
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
+- 所有格式的图片短边像素不小于64。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Image?: string
   /**
-   * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
-Url、Image必须提供一个，如果都提供，只使用 Url。  
-图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
-非腾讯云存储的Url速度和稳定性可能受一定影响。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+   * 图片的 Url 。
+- 对应图片 base64 编码后大小不可超过5M。
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。
+- 所有格式的图片短边像素不小于64。
+- Url、Image必须提供一个，如果都提供，只使用 Url。  
+- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
+- 非腾讯云存储的Url速度和稳定性可能受一定影响。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Url?: string
   /**
-   * 是否需要返回人脸属性信息（FaceAttributesInfo）。0 为不需要返回，1 为需要返回。默认为 0。 
-非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。  
-最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。  
-提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。
+   * 是否需要返回人脸属性信息（FaceAttributesInfo）。
+- 0 为不需要返回，1 为需要返回。
+- 默认为 0。 
+- 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。  
+- 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。  
+- 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。
    */
   NeedFaceAttributes?: number
   /**
-   * 是否开启质量检测。0 为关闭，1 为开启。默认为 0。 
-非 1 值均视为不进行质量检测。
-最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。  
-建议：人脸入库操作建议开启此功能。
+   * 是否开启质量检测。
+- 0 为关闭，1 为开启。
+- 默认为 0。 
+- 非 1 值均视为不进行质量检测。
+- 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。  
+- 建议：人脸入库操作建议开启此功能。
    */
   NeedQualityDetection?: number
   /**
    * 人脸识别服务所用的算法模型版本。
-目前入参支持 “2.0”和“3.0“ 两个输入。
-2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
-2020年11月26日后开通服务的账号仅支持输入“3.0”。
-不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
+- 目前入参支持 “2.0”和“3.0“ 两个输入。
+- 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
+- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
+- 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
    */
   FaceModelVersion?: string
   /**
-   * 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
+   * 是否开启图片旋转识别支持。
+- 0为不开启，1为开启。
+- 默认为0。
+- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
+- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
    */
   NeedRotateDetection?: number
 }
@@ -2095,11 +2182,11 @@ export interface DeletePersonResponse {
  */
 export interface PersonExDescriptionInfo {
   /**
-   * 人员描述字段Index，从0开始
+   * 人员描述字段Index，从0开始。
    */
   PersonExDescriptionIndex: number
   /**
-   * 需要更新的人员描述字段内容
+   * 需要更新的人员描述字段内容。
    */
   PersonExDescription: string
 }
@@ -2129,15 +2216,15 @@ export interface HeadPose {
   /**
    * 上下偏移[-30,30]。
    */
-  Pitch: number
+  Pitch?: number
   /**
    * 左右偏移[-30,30]。
    */
-  Yaw: number
+  Yaw?: number
   /**
    * 平面旋转[-180,180]。
    */
-  Roll: number
+  Roll?: number
 }
 
 /**
@@ -2165,38 +2252,44 @@ export interface GetGroupListResponse {
 export interface DetectFaceAttributesRequest {
   /**
    * 最多处理的人脸数目。 
-默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 
-此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。
+- 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 
+- 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。
    */
   MaxFaceNum?: number
   /**
-   * 图片 base64 数据，base64 编码后大小不可超过5M。
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 所有格式的图片短边像素不小于64。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+   * 图片 base64 数据。
+- base64 编码后大小不可超过5M。
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 
+- 所有格式的图片短边像素不小于64。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Image?: string
   /**
    * 图片的 Url 。 
-对应图片 base64 编码后大小不可超过5M。 
-jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
-Url、Image必须提供一个，如果都提供，只使用 Url。 
-图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
-非腾讯云存储的Url速度和稳定性可能受一定影响。 
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+- 对应图片 base64 编码后大小不可超过5M。 
+- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
+- Url、Image必须提供一个，如果都提供，只使用 Url。 
+- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
+- 非腾讯云存储的Url速度和稳定性可能受一定影响。 
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
    */
   Url?: string
   /**
    * 是否返回年龄、性别、情绪等属性。 
-合法值为（大小写不敏感）：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 不具备参考意义。
+- 合法值为（大小写不敏感）：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 不具备参考意义。
    */
   FaceAttributesType?: string
   /**
-   * 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
+   * 是否开启图片旋转识别支持。
+- 0为不开启，1为开启。
+- 默认为0。
+- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
+- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
    */
   NeedRotateDetection?: number
   /**
@@ -2414,7 +2507,8 @@ export interface VerifyPersonResponse {
    */
   IsMatch?: boolean
   /**
-   * 人脸识别所用的算法模型版本，是该 Person 所在的人员库的算法模型版本。在创建人员库时设置，详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
+   * 人脸识别所用的算法模型版本，是该 Person 所在的人员库的算法模型版本。
+- 在创建人员库时设置，详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
    */
   FaceModelVersion?: string
   /**
@@ -2436,7 +2530,8 @@ export interface DetectFaceResponse {
    */
   ImageHeight?: number
   /**
-   * 人脸信息列表。包含人脸坐标信息、属性信息（若需要）、质量分信息（若需要）。
+   * 人脸信息列表。
+- 包含人脸坐标信息、属性信息（若需要）、质量分信息（若需要）。
    */
   FaceInfos?: Array<FaceInfo>
   /**
@@ -2539,24 +2634,26 @@ export interface GetPersonListRequest {
  */
 export interface FaceDetailAttributesInfo {
   /**
-   * 年龄 [0,65]，其中65代表“65岁及以上”。 
-FaceAttributesType 不含Age 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 年龄。
+- 取值范围： [0,65]，其中65代表“65岁及以上”。 
+- FaceAttributesType 不含Age 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Age?: number
   /**
-   * 美丑打分[0,100]。 
-FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 美丑打分。
+- 取值范围：[0,100]。 
+- FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Beauty?: number
   /**
    * 情绪，可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。 
-AttributeItem对应的Type为 —— 0：自然，1：高兴，2：惊讶，3：生气，4：悲伤，5：厌恶，6：害怕
-FaceAttributesType 不含Emotion 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- AttributeItem对应的Type为 —— 0：自然，1：高兴，2：惊讶，3：生气，4：悲伤，5：厌恶，6：害怕。
+- FaceAttributesType 不含Emotion 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Emotion?: AttributeItem
   /**
    * 眼睛相关信息，可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。 
-FaceAttributesType 不含Eye 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- FaceAttributesType 不含Eye 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Eye?: Eye
   /**
@@ -2566,63 +2663,64 @@ FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时，此参数仍
   Eyebrow?: Eyebrow
   /**
    * 性别信息。 
-AttributeItem对应的Type为 —— 	0：男性，1：女性。
-FaceAttributesType 不含Gender 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- AttributeItem对应的Type为 —— 	0：男性，1：女性。
+- FaceAttributesType 不含Gender 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Gender?: AttributeItem
   /**
    * 头发信息，包含头发长度、有无刘海、头发颜色。 
-FaceAttributesType 不含Hair 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- FaceAttributesType 不含Hair 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Hair?: Hair
   /**
    * 帽子信息，可识别是否佩戴帽子、帽子款式、帽子颜色。 
-FaceAttributesType 不含Hat 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- FaceAttributesType 不含Hat 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Hat?: Hat
   /**
    * 姿态信息，包含人脸的上下偏移、左右偏移、平面旋转信息。 
-FaceAttributesType 不含Headpose 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- FaceAttributesType 不含Headpose 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   HeadPose?: HeadPose
   /**
    * 口罩佩戴信息。 
-AttributeItem对应的Type为 —— 0: 无口罩， 1: 有口罩不遮脸，2: 有口罩遮下巴，3: 有口罩遮嘴，4: 正确佩戴口罩。
-FaceAttributesType 不含Mask 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- AttributeItem对应的Type为 —— 0: 无口罩， 1: 有口罩不遮脸，2: 有口罩遮下巴，3: 有口罩遮嘴，4: 正确佩戴口罩。
+- FaceAttributesType 不含Mask 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Mask?: AttributeItem
   /**
    * 嘴巴信息，可识别是否张嘴、嘴唇厚度。 
-FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Mouth?: Mouth
   /**
    * 胡子信息。
-AttributeItem对应的Type为 —— 0：无胡子，1：有胡子。 
-FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- AttributeItem对应的Type为 —— 0：无胡子，1：有胡子。 
+- FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Moustache?: AttributeItem
   /**
    * 鼻子信息。 
-AttributeItem对应的Type为 —— 0：朝天鼻，1：鹰钩鼻，2：普通，3：圆鼻头
-FaceAttributesType 不含 Nose 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- AttributeItem对应的Type为 —— 0：朝天鼻，1：鹰钩鼻，2：普通，3：圆鼻头
+- FaceAttributesType 不含 Nose 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Nose?: AttributeItem
   /**
    * 脸型信息。 
-AttributeItem对应的Type为 —— 0：方脸，1：三角脸，2：鹅蛋脸，3：心形脸，4：圆脸。
-FaceAttributesType 不含 Shape 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- AttributeItem对应的Type为 —— 0：方脸，1：三角脸，2：鹅蛋脸，3：心形脸，4：圆脸。
+- FaceAttributesType 不含 Shape 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Shape?: AttributeItem
   /**
    * 肤色信息。 
-AttributeItem对应的Type为 —— 0：黄色皮肤，1：棕色皮肤，2：黑色皮肤，3：白色皮肤。
-FaceAttributesType 不含 Skin 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+- AttributeItem对应的Type为 —— 0：黄色皮肤，1：棕色皮肤，2：黑色皮肤，3：白色皮肤。
+- FaceAttributesType 不含 Skin 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Skin?: AttributeItem
   /**
-   * 微笑程度，[0,100]。 
-FaceAttributesType 不含 Smile 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
+   * 微笑程度
+- 取值范围：[0,100]。 
+- FaceAttributesType 不含 Smile 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。
    */
   Smile?: number
 }
@@ -2632,11 +2730,12 @@ FaceAttributesType 不含 Smile 或检测超过 5 张人脸时，此参数仍返
  */
 export interface AttributeItem {
   /**
-   * 属性值
+   * 属性值。
    */
   Type?: number
   /**
-   * Type识别概率值,[0,1],代表判断正确的概率。
+   * Type识别概率值。
+- 取值范围：[0,1]，代表判断正确的概率。
    */
   Probability?: number
 }
@@ -2647,24 +2746,24 @@ export interface AttributeItem {
 export interface FaceRect {
   /**
    * 人脸框左上角横坐标。 
-人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 
-若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。
+- 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 
+- 若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。
    */
-  X: number
+  X?: number
   /**
    * 人脸框左上角纵坐标。 
-人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 
-若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。
+- 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 
+- 若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。
    */
-  Y: number
+  Y?: number
   /**
-   * 人脸宽度
+   * 人脸宽度。
    */
-  Width: number
+  Width?: number
   /**
-   * 人脸高度
+   * 人脸高度。
    */
-  Height: number
+  Height?: number
 }
 
 /**