tccli 3.0.1216.1__py2.py3-none-any.whl → 3.0.1217.1__py2.py3-none-any.whl

tccli/services/iai/v20200303/api.json

@@ -64,7 +64,7 @@
       "status": "online"
     },
     "DeleteGroup": {
-      "document": "删除该人员库及包含的所有的人员。同时，人员对应的所有人脸信息将被删除。若某人员同时存在多个人员库中，该人员不会被删除，但属于该人员库中的自定义描述字段信息会被删除，属于其他人员库的自定义描述字段信息不受影响。\n",
+      "document": "删除该人员库及包含的所有的人员。同时，人员对应的所有人脸信息将被删除。若某人员同时存在多个人员库中，该人员不会被删除，但属于该人员库中的自定义描述字段信息会被删除，属于其他人员库的自定义描述字段信息不受影响。",
       "input": "DeleteGroupRequest",
       "name": "删除人员库",
       "output": "DeleteGroupResponse",
@@ -143,7 +143,7 @@
     "GetPersonList": {
       "document": "获取指定人员库中的人员列表。",
       "input": "GetPersonListRequest",
-      "name": "获取人员列表",
+      "name": "获取指定人员列表",
       "output": "GetPersonListResponse",
       "status": "online"
     },
@@ -258,7 +258,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "检测模式。0 为检测所有出现的人脸， 1 为检测面积最大的人脸。 \n默认为 0。 \n最多返回 5 张人脸的五官定位（人脸关键点）具体信息。",
+          "document": "检测模式。\n- 取值范围：0 为检测所有出现的人脸， 1 为检测面积最大的人脸。 \n- 默认为 0。 \n- 最多返回 5 张人脸的五官定位（人脸关键点）具体信息。",
           "example": "0",
           "member": "uint64",
           "name": "Mode",
@@ -267,8 +267,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。  \njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。  \n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -276,7 +276,7 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。  \njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nUrl、Image必须提供一个，如果都提供，只使用 Url。  \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。  \n非腾讯云存储的Url速度和稳定性可能受一定影响。  \n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。  \n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- Url、Image必须提供一个，如果都提供，只使用 Url。  \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。  \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。  \n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "Url",
@@ -294,7 +294,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 取值范围：0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "int64",
           "name": "NeedRotateDetection",
@@ -361,7 +361,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "检测模式。0 为检测所有出现的人脸， 1 为检测面积最大的人脸。默认为 0。最多返回 10 张人脸的五官定位（人脸关键点）具体信息。",
+          "document": "检测模式。\n- 取值范围：\n0 为检测所有出现的人脸。\n1 为检测面积最大的人脸。\n- 默认为 0。\n- 最多返回 10 张人脸的五官定位（人脸关键点）具体信息。",
           "example": "0",
           "member": "uint64",
           "name": "Mode",
@@ -370,8 +370,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -379,7 +379,7 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nUrl、Image必须提供一个，如果都提供，只使用 Url。  \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- Url、Image必须提供一个，如果都提供，只使用 Url。  \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "Url",
@@ -388,7 +388,7 @@
         },
         {
           "disabled": false,
-          "document": "人脸识别服务所用的算法模型版本。\n\n目前入参支持 “2.0”和“3.0“ 两个输入。\n\n2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。\n\n2020年11月26日后开通服务的账号仅支持输入“3.0”。\n\n不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
+          "document": "人脸识别服务所用的算法模型版本。\n- 目前入参支持 “2.0”和“3.0“ 两个输入。\n- 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。\n- 2020年11月26日后开通服务的账号仅支持输入“3.0”。\n- 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
           "example": "3.0",
           "member": "string",
           "name": "FaceModelVersion",
@@ -397,7 +397,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
@@ -464,8 +464,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "属性值",
-          "example": "无",
+          "document": "属性值。",
+          "example": "1",
           "member": "int64",
           "name": "Type",
           "output_required": true,
@@ -474,8 +474,8 @@
         },
         {
           "disabled": false,
-          "document": "Type识别概率值,[0,1],代表判断正确的概率。",
-          "example": "无",
+          "document": "Type识别概率值。\n- 取值范围：[0,1]，代表判断正确的概率。",
+          "example": "90",
           "member": "float",
           "name": "Probability",
           "output_required": true,
@@ -490,61 +490,61 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员ID",
+          "document": "人员ID。",
           "example": "person1",
           "member": "string",
           "name": "PersonId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人脸ID，仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。人员搜索类接口采用融合特征方式检索，该字段无意义",
+          "document": "人脸ID。\n- 仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。\n- 人员搜索类接口采用融合特征方式检索，该字段无意义。",
           "example": "3820314501007076807",
           "member": "string",
           "name": "FaceId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "候选者的匹配得分。 \n\n1万大小人脸底库下，误识率百分之一对应分数为70分，误识率千分之一对应分数为80分，误识率万分之一对应分数为90分；\n10万大小人脸底库下，误识率百分之一对应分数为80分，误识率千分之一对应分数为90分，误识率万分之一对应分数为100分；\n30万大小人脸底库下，误识率百分之一对应分数为85分，误识率千分之一对应分数为95分。\n\n一般80分左右可适用大部分场景，建议分数不要超过90分。您可以根据实际情况选择合适的分数。",
+          "document": "候选者的匹配得分。 \n- 1万大小人脸底库下，误识率百分之一对应分数为70分，误识率千分之一对应分数为80分，误识率万分之一对应分数为90分。\n- 10万大小人脸底库下，误识率百分之一对应分数为80分，误识率千分之一对应分数为90分，误识率万分之一对应分数为100分。\n- 30万大小人脸底库下，误识率百分之一对应分数为85分，误识率千分之一对应分数为95分。\n- 一般80分左右可适用大部分场景，建议分数不要超过90分。您可以根据实际情况选择合适的分数。",
           "example": "50",
           "member": "float",
           "name": "Score",
-          "required": true,
+          "output_required": true,
           "type": "float",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人员名称\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "hello",
+          "document": "人员名称。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "韦小宝",
           "member": "string",
           "name": "PersonName",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "人员性别\n注意：此字段可能返回 null，表示取不到有效值。",
+          "document": "人员性别。\n注意：此字段可能返回 null，表示取不到有效值。",
           "example": "0",
           "member": "int64",
           "name": "Gender",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "包含此人员的人员库及描述字段内容列表\n注意：此字段可能返回 null，表示取不到有效值。",
+          "document": "包含此人员的人员库及描述字段内容列表。\n注意：此字段可能返回 null，表示取不到有效值。",
           "example": "无",
           "member": "PersonGroupInfo",
           "name": "PersonGroupInfos",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": true
         }
@@ -556,8 +556,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "A 图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n若图片中包含多张人脸，只选取其中置信度最高的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "A 图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- 若图片中包含多张人脸，只选取其中置信度最高的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "ImageA",
           "required": false,
@@ -565,8 +565,8 @@
         },
         {
           "disabled": false,
-          "document": "B 图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n若图片中包含多张人脸，只选取其中置信度最高的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "B 图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- 若图片中包含多张人脸，只选取其中置信度最高的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "ImageB",
           "required": false,
@@ -574,7 +574,7 @@
         },
         {
           "disabled": false,
-          "document": "A 图片的 Url ，对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nA 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "A 图片的 Url。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- A 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "UrlA",
@@ -583,7 +583,7 @@
         },
         {
           "disabled": false,
-          "document": "B 图片的 Url ，对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nB 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "B 图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- B 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testB.jpg",
           "member": "string",
           "name": "UrlB",
@@ -592,7 +592,7 @@
         },
         {
           "disabled": false,
-          "document": "人脸识别服务所用的算法模型版本。\n\n目前入参支持 “2.0”和“3.0“ 两个输入。\n\n2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。\n\n2020年11月26日后开通服务的账号仅支持输入“3.0”。\n\n不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
+          "document": "人脸识别服务所用的算法模型版本。\n- 目前入参支持 “2.0”和“3.0“ 两个输入。\n- 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。\n- 2020年11月26日后开通服务的账号仅支持输入“3.0”。\n- 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
           "example": "3.0",
           "member": "string",
           "name": "FaceModelVersion",
@@ -601,7 +601,7 @@
         },
         {
           "disabled": false,
-          "document": "图片质量控制。 \n0: 不进行控制； \n1: 较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多，在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
+          "document": "图片质量控制。 \n- 取值范围：\n0: 不进行控制； \n1: 较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多，在某一维度上存在轻微问题； \n默认 0。 \n\n- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
           "example": "0",
           "member": "uint64",
           "name": "QualityControl",
@@ -610,7 +610,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 取值范围：0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
@@ -625,7 +625,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "两张图片中人脸的相似度分数。\n不同算法版本返回的相似度分数不同。 \n若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。  一般超过50分则可认定为同一人。 \n2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。 \n若需要验证两张图片中的人脸是否为同一人，建议使用人脸验证接口。",
+          "document": "两张图片中人脸的相似度分数。\n- 不同算法版本返回的相似度分数不同。 \n- 若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。  一般超过50分则可认定为同一人。 \n- 2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。 \n- 若需要验证两张图片中的人脸是否为同一人，建议使用人脸验证接口。",
           "example": "0.999",
           "member": "float",
           "name": "Score",
@@ -657,8 +657,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "A 图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "XyE7l...",
+          "document": "A 图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "ImageA",
           "required": false,
@@ -666,8 +666,8 @@
         },
         {
           "disabled": false,
-          "document": "B 图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "XyE7l...",
+          "document": "B 图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "ImageB",
           "required": false,
@@ -675,7 +675,7 @@
         },
         {
           "disabled": false,
-          "document": "A 图片的 Url ，对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nA 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "A 图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- A 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "UrlA",
@@ -684,7 +684,7 @@
         },
         {
           "disabled": false,
-          "document": "B 图片的 Url ，对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nB 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "B 图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- B 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testB.jpg",
           "member": "string",
           "name": "UrlB",
@@ -702,7 +702,7 @@
         },
         {
           "disabled": false,
-          "document": "图片质量控制。 \n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
+          "document": "图片质量控制。 \n- 取值范围：\n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n- 默认 0。 \n- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
           "example": "0",
           "member": "uint64",
           "name": "QualityControl",
@@ -717,7 +717,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "两张图片中人脸的相似度分数。\n不同算法版本返回的相似度分数不同。 \n若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。  一般超过50分则可认定为同一人。 \n2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。 \n若需要验证两张图片中的人脸是否为同一人，建议使用人脸验证接口。",
+          "document": "两张图片中人脸的相似度分数。\n- 不同算法版本返回的相似度分数不同。 \n- 若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。  一般超过50分则可认定为同一人。 \n- 2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。 \n- 若需要验证两张图片中的人脸是否为同一人，建议使用人脸验证接口。",
           "example": "99",
           "member": "float",
           "name": "Score",
@@ -749,8 +749,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员ID，取值为创建人员接口中的PersonId",
-          "example": "",
+          "document": "人员ID，取值为创建人员接口中的PersonId。",
+          "example": "1001",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -758,8 +758,8 @@
         },
         {
           "disabled": false,
-          "document": "待加入的人员库列表，数组元素取值为创建人员库接口中的GroupId",
-          "example": "",
+          "document": "待加入的人员库列表，数组元素取值为创建人员库接口中的GroupId。",
+          "example": "[\"TencentShenZhenEmployee\"]",
           "member": "string",
           "name": "GroupIds",
           "required": true,
@@ -773,19 +773,21 @@
       "members": [
         {
           "disabled": false,
-          "document": "成功加入的人员库数量",
-          "example": "",
+          "document": "成功加入的人员库数量。",
+          "example": "10",
           "member": "uint64",
           "name": "SucGroupNum",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "成功加入的人员库列表",
-          "example": "",
+          "document": "成功加入的人员库列表。",
+          "example": "[\"TencentShenZhenEmployee\"]",
           "member": "string",
           "name": "SucGroupIds",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
@@ -803,7 +805,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员ID，取值为创建人员接口中的PersonId",
+          "document": "人员ID，取值为创建人员接口中的PersonId。",
           "example": "1001",
           "member": "string",
           "name": "PersonId",
@@ -812,8 +814,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n人员人脸总数量不可超过5张。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- 人员人脸总数量不可超过5张。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Images",
           "required": false,
@@ -821,8 +823,8 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nUrl、Image必须提供一个，如果都提供，只使用 Url。  \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。\n人员人脸总数量不可超过5张。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。",
-          "example": "[\"http:\\/\\/test.image.myqcloud.com\\/testA.jpg\"]",
+          "document": "图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- Url、Image必须提供一个，如果都提供，只使用 Url。  \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。\n- 人员人脸总数量不可超过5张。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。",
+          "example": "[\"http://test.image.myqcloud.com/testA.jpg\"]",
           "member": "string",
           "name": "Urls",
           "required": false,
@@ -830,7 +832,7 @@
         },
         {
           "disabled": false,
-          "document": "只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸，才能增加人脸成功。 \n默认值60分。取值范围[0,100] 。",
+          "document": "只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸，才能增加人脸成功。 \n- 默认值60分。\n- 取值范围：[0,100] 。",
           "example": "60",
           "member": "float",
           "name": "FaceMatchThreshold",
@@ -839,7 +841,7 @@
         },
         {
           "disabled": false,
-          "document": "图片质量控制。 \n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
+          "document": "图片质量控制。 \n- 取值范围：\n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n- 默认 0。 \n- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
           "example": "0",
           "member": "uint64",
           "name": "QualityControl",
@@ -848,7 +850,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 取值范围：0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
@@ -863,7 +865,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "加入成功的人脸数量",
+          "document": "加入成功的人脸数量。",
           "example": "1",
           "member": "uint64",
           "name": "SucFaceNum",
@@ -873,7 +875,7 @@
         },
         {
           "disabled": false,
-          "document": "加入成功的人脸ID列表",
+          "document": "加入成功的人脸ID列表。",
           "example": "[\"2875186538564559728\"]",
           "member": "string",
           "name": "SucFaceIds",
@@ -883,7 +885,7 @@
         },
         {
           "disabled": false,
-          "document": "每张人脸图片添加结果，-1101 代表未检测到人脸，-1102 代表图片解码失败，-1109 代表图片尺寸过大或者过小， \n-1601代表不符合图片质量控制要求, -1604 代表人脸相似度没有超过FaceMatchThreshold。 \n其他非 0 值代表算法服务异常。 \nRetCode的顺序和入参中 Images 或 Urls 的顺序一致。",
+          "document": "每张人脸图片添加结果。\n- 其他非 0 值代表算法服务异常，取值范围：\n-1101 代表未检测到人脸。\n-1102 代表图片解码失败。\n-1109 代表图片尺寸过大或者过小。\n-1601代表不符合图片质量控制要求。\n-1604 代表人脸相似度没有超过FaceMatchThreshold。 \n- RetCode的顺序和入参中 Images 或 Urls 的顺序一致。",
           "example": "[0]",
           "member": "int64",
           "name": "RetCode",
@@ -893,7 +895,7 @@
         },
         {
           "disabled": false,
-          "document": "加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。 \n例如， Urls 中 有 3 个 url，第二个 url 失败，则 SucIndexes 值为 [0,2] 。",
+          "document": "加入成功的人脸索引。\n- 索引顺序和入参中 Images 或 Urls 的顺序一致。 \n- 例如， Urls 中 有 3 个 url，第二个 url 失败，则 SucIndexes 值为 [0,2] 。",
           "example": "[0]",
           "member": "uint64",
           "name": "SucIndexes",
@@ -953,8 +955,8 @@
         },
         {
           "disabled": false,
-          "document": "人员库自定义描述字段，用于描述人员库中人员属性，该人员库下所有人员将拥有此描述字段。 \n最多可以创建5个。 \n每个自定义描述字段支持[1,30]个字符。 \n在同一人员库中自定义描述字段不可重复。 \n例： 设置某人员库“自定义描述字段”为[\"学号\",\"工号\",\"手机号\"]， \n则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段， \n可在对应人员描述字段中填写内容，登记该人员的学号、工号、手机号等信息。",
-          "example": "[\"\\u4e8b\\u4e1a\\u7fa4\",\"\\u90e8\\u95e8\\u540d\",\"\\u7ec4\\u540d\"]",
+          "document": "人员库自定义描述字段，用于描述人员库中人员属性，该人员库下所有人员将拥有此描述字段。 \n- 最多可以创建5个。 \n- 每个自定义描述字段支持[1,30]个字符。 \n- 在同一人员库中自定义描述字段不可重复。 \n- 例： 设置某人员库“自定义描述字段”为[\"学号\",\"工号\",\"手机号\"]， 则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段， 可在对应人员描述字段中填写内容，登记该人员的学号、工号、手机号等信息。",
+          "example": "[\"学号\",\"工号\",\"手机号\"]",
           "member": "string",
           "name": "GroupExDescriptions",
           "required": false,
@@ -971,7 +973,7 @@
         },
         {
           "disabled": false,
-          "document": "人脸识别服务所用的算法模型版本。\n目前入参支持 “2.0”和“3.0“ 两个输入。\n2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。\n2020年11月26日后开通服务的账号仅支持输入“3.0”。\n不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
+          "document": "人脸识别服务所用的算法模型版本。\n- 目前入参支持 “2.0”和“3.0“ 两个输入。\n- 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。\n- 2020年11月26日后开通服务的账号仅支持输入“3.0”。\n- 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
           "example": "3.0",
           "member": "string",
           "name": "FaceModelVersion",
@@ -1008,8 +1010,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "待加入的人员库ID，取值为创建人员库接口中的GroupId",
-          "example": "ZhuYuanDormitoryNo1",
+          "document": "待加入的人员库ID，取值为创建人员库接口中的GroupId。",
+          "example": "78",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -1018,7 +1020,7 @@
         {
           "disabled": false,
           "document": "人员名称。[1，60]个字符，可修改，可重复。",
-          "example": "Junly",
+          "example": "韦小宝",
           "member": "string",
           "name": "PersonName",
           "required": true,
@@ -1026,7 +1028,7 @@
         },
         {
           "disabled": false,
-          "document": "人员ID，单个腾讯云账号下不可修改，不可重复。支持英文、数字、-%@#&_，长度限制64B。",
+          "document": "人员ID。\n- 单个腾讯云账号下不可修改，不可重复。\n- 支持英文、数字、-%@#&_，长度限制64B。",
           "example": "2001",
           "member": "string",
           "name": "PersonId",
@@ -1035,7 +1037,7 @@
         },
         {
           "disabled": false,
-          "document": "0代表未填写，1代表男性，2代表女性。",
+          "document": "性别。\n- 取值范围：0代表未填写，1代表男性，2代表女性。",
           "example": "1",
           "member": "int64",
           "name": "Gender",
@@ -1053,8 +1055,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -1062,7 +1064,7 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nUrl、Image必须提供一个，如果都提供，只使用 Url。  \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- Url、Image必须提供一个，如果都提供，只使用 Url。  \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testB.jpg",
           "member": "string",
           "name": "Url",
@@ -1071,7 +1073,7 @@
         },
         {
           "disabled": false,
-          "document": "此参数用于控制判断 Image 或 Url 中图片包含的人脸，是否在人员库中已有疑似的同一人。 \n如果判断为已有相同人在人员库中，则不会创建新的人员，返回疑似同一人的人员信息。 \n如果判断没有，则完成创建人员。 \n0: 不进行判断，无论是否有疑似同一人在库中均完成入库； \n1:较低的同一人判断要求（百一误识别率）； \n2: 一般的同一人判断要求（千一误识别率）； \n3: 较高的同一人判断要求（万一误识别率）； \n4: 很高的同一人判断要求（十万一误识别率）。 \n默认 0。  \n注： 要求越高，则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值，您可以根据实际情况调整。",
+          "document": "此参数用于控制判断 Image 或 Url 中图片包含的人脸，是否在人员库中已有疑似的同一人。 \n- 如果判断为已有相同人在人员库中，则不会创建新的人员，返回疑似同一人的人员信息。 \n- 如果判断没有，则完成创建人员。 \n- 取值范围：\n0: 不进行判断，无论是否有疑似同一人在库中均完成入库； \n1:较低的同一人判断要求（百一误识别率）； \n2: 一般的同一人判断要求（千一误识别率）； \n3: 较高的同一人判断要求（万一误识别率）； \n4: 很高的同一人判断要求（十万一误识别率）。 \n- 默认 0。  \n- 注： 要求越高，则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值，您可以根据实际情况调整。",
           "example": "0",
           "member": "uint64",
           "name": "UniquePersonControl",
@@ -1080,7 +1082,7 @@
         },
         {
           "disabled": false,
-          "document": "图片质量控制。 \n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
+          "document": "图片质量控制。 \n- 取值范围：\n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n- 默认 0。 \n- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
           "example": "0",
           "member": "uint64",
           "name": "QualityControl",
@@ -1089,7 +1091,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 取值范围：0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
@@ -1124,8 +1126,8 @@
         },
         {
           "disabled": false,
-          "document": "疑似同一人的PersonId。 \n当 UniquePersonControl 参数不为0且人员库中有疑似的同一人，此参数才有意义。",
-          "example": "无",
+          "document": "疑似同一人的PersonId。 \n- 当 UniquePersonControl 参数不为0且人员库中有疑似的同一人，此参数才有意义。",
+          "example": "18",
           "member": "string",
           "name": "SimilarPersonId",
           "output_required": true,
@@ -1156,8 +1158,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员ID，取值为创建人员接口中的PersonId",
-          "example": "",
+          "document": "人员ID，取值为创建人员接口中的PersonId。",
+          "example": "5001",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -1165,8 +1167,8 @@
         },
         {
           "disabled": false,
-          "document": "待删除的人脸ID列表，数组元素取值为增加人脸接口返回的FaceId",
-          "example": "",
+          "document": "待删除的人脸ID列表，数组元素取值为增加人脸接口返回的FaceId。",
+          "example": "[\"2875186538564559728\"]",
           "member": "string",
           "name": "FaceIds",
           "required": true,
@@ -1180,19 +1182,21 @@
       "members": [
         {
           "disabled": false,
-          "document": "删除成功的人脸数量",
-          "example": "",
+          "document": "删除成功的人脸数量.",
+          "example": "1",
           "member": "uint64",
           "name": "SucDeletedNum",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "删除成功的人脸ID列表",
-          "example": "",
+          "document": "删除成功的人脸ID列表。",
+          "example": "[\"2875186538564559728\"]",
           "member": "string",
           "name": "SucFaceIds",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
@@ -1210,8 +1214,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员库ID，取值为创建人员库接口中的GroupId",
-          "example": "",
+          "document": "人员库ID，取值为创建人员库接口中的GroupId。",
+          "example": "21",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -1237,8 +1241,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员ID，取值为创建人员接口中的PersonId",
-          "example": "",
+          "document": "人员ID，取值为创建人员接口中的PersonId。",
+          "example": "3001",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -1246,8 +1250,8 @@
         },
         {
           "disabled": false,
-          "document": "人员库ID，取值为创建人员库接口中的GroupId",
-          "example": "",
+          "document": "人员库ID，取值为创建人员库接口中的GroupId。",
+          "example": "ZhuYuanDormitoryNo1",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -1273,8 +1277,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员ID，取值为创建人员接口中的PersonId",
-          "example": "",
+          "document": "人员ID，取值为创建人员接口中的PersonId。",
+          "example": "3001",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -1301,180 +1305,180 @@
         {
           "disabled": false,
           "document": "人脸框左上角横坐标。",
-          "example": "",
+          "example": "198",
           "member": "int64",
           "name": "X",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人脸框左上角纵坐标。",
-          "example": "",
+          "example": "254",
           "member": "int64",
           "name": "Y",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人脸框宽度。",
-          "example": "",
+          "example": "924",
           "member": "int64",
           "name": "Width",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人脸框高度。",
-          "example": "",
+          "example": "809",
           "member": "int64",
           "name": "Height",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "描述左侧眼睛轮廓的 XX 点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "LeftEye",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "描述右侧眼睛轮廓的 XX 点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "RightEye",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "描述左侧眉毛轮廓的 XX 点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "LeftEyeBrow",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "描述右侧眉毛轮廓的 XX 点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "RightEyeBrow",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "描述外嘴巴轮廓的 XX 点， 从左侧开始逆时针返回。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "MouthOutside",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "描述内嘴巴轮廓的 XX 点，从左侧开始逆时针返回。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "MouthInside",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "描述鼻子轮廓的 XX 点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "Nose",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "左瞳孔轮廓的 XX 个点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "LeftPupil",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "右瞳孔轮廓的 XX 个点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "RightPupil",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "中轴线轮廓的 XX 个点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "CentralAxis",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "下巴轮廓的 XX 个点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "Chin",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "左眼袋的 XX 个点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "LeftEyeBags",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "右眼袋的 XX 个点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "RightEyeBags",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "额头的 XX 个点。",
-          "example": "",
+          "example": "无",
           "member": "Point",
           "name": "Forehead",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         }
@@ -1486,7 +1490,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "最多处理的人脸数目。 \n默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 \n此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。",
+          "document": "最多处理的人脸数目。 \n- 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 \n- 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。",
           "example": "1",
           "member": "uint64",
           "name": "MaxFaceNum",
@@ -1495,8 +1499,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 所有格式的图片短边像素不小于64。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 \n- 所有格式的图片短边像素不小于64。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -1504,7 +1508,7 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。 \n对应图片 base64 编码后大小不可超过5M。 \njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nUrl、Image必须提供一个，如果都提供，只使用 Url。 \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。 \n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "图片的 Url 。 \n- 对应图片 base64 编码后大小不可超过5M。 \n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n- Url、Image必须提供一个，如果都提供，只使用 Url。 \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。 \n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "Url",
@@ -1513,7 +1517,7 @@
         },
         {
           "disabled": false,
-          "document": "是否返回年龄、性别、情绪等属性。 \n合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、 \nGender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。 \nNone为不需要返回。默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。\n需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。 \n关于各属性的详细描述，参见下文出参。 \n最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。",
+          "document": "是否返回年龄、性别、情绪等属性。 \n- 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。 \n- None为不需要返回。\n- 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。\n- 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。 \n- 关于各属性的详细描述，参见下文出参。 \n- 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。",
           "example": "eye",
           "member": "string",
           "name": "FaceAttributesType",
@@ -1522,7 +1526,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
@@ -1598,7 +1602,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "最多处理的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 \n此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。",
+          "document": "最多处理的人脸数目。\n- 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 \n- 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。",
           "example": "1",
           "member": "uint64",
           "name": "MaxFaceNum",
@@ -1607,7 +1611,7 @@
         },
         {
           "disabled": false,
-          "document": "人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。\n只支持设置34和20，建议使用34。\n",
+          "document": "人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。\n- 只支持设置34和20，建议使用34。",
           "example": "34",
           "member": "uint64",
           "name": "MinFaceSize",
@@ -1616,8 +1620,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -1625,7 +1629,7 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nUrl、Image必须提供一个，如果都提供，只使用 Url。  \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- Url、Image必须提供一个，如果都提供，只使用 Url。  \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "https://test.image.myqcloud.com/testB.jpg",
           "member": "string",
           "name": "Url",
@@ -1634,7 +1638,7 @@
         },
         {
           "disabled": false,
-          "document": "是否需要返回人脸属性信息（FaceAttributesInfo）。0 为不需要返回，1 为需要返回。默认为 0。 \n非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。  \n最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。  \n提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。",
+          "document": "是否需要返回人脸属性信息（FaceAttributesInfo）。\n- 0 为不需要返回，1 为需要返回。\n- 默认为 0。 \n- 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。  \n- 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。  \n- 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。",
           "example": "0",
           "member": "uint64",
           "name": "NeedFaceAttributes",
@@ -1643,7 +1647,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启质量检测。0 为关闭，1 为开启。默认为 0。 \n非 1 值均视为不进行质量检测。\n最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。  \n建议：人脸入库操作建议开启此功能。",
+          "document": "是否开启质量检测。\n- 0 为关闭，1 为开启。\n- 默认为 0。 \n- 非 1 值均视为不进行质量检测。\n- 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。  \n- 建议：人脸入库操作建议开启此功能。",
           "example": "0",
           "member": "uint64",
           "name": "NeedQualityDetection",
@@ -1652,7 +1656,7 @@
         },
         {
           "disabled": false,
-          "document": "人脸识别服务所用的算法模型版本。\n目前入参支持 “2.0”和“3.0“ 两个输入。\n2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。\n2020年11月26日后开通服务的账号仅支持输入“3.0”。\n不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
+          "document": "人脸识别服务所用的算法模型版本。\n- 目前入参支持 “2.0”和“3.0“ 两个输入。\n- 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。\n- 2020年11月26日后开通服务的账号仅支持输入“3.0”。\n- 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
           "example": "3.0",
           "member": "string",
           "name": "FaceModelVersion",
@@ -1661,7 +1665,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
@@ -1696,7 +1700,7 @@
         },
         {
           "disabled": false,
-          "document": "人脸信息列表。包含人脸坐标信息、属性信息（若需要）、质量分信息（若需要）。",
+          "document": "人脸信息列表。\n- 包含人脸坐标信息、属性信息（若需要）、质量分信息（若需要）。",
           "example": "无",
           "member": "FaceInfo",
           "name": "FaceInfos",
@@ -1728,8 +1732,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 \n图片的宽高比请接近 3:4，手机拍摄比例最佳。\n人脸尺寸大于100X100像素。\n图片格式支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "base64",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 \n- 图片的宽高比请接近 3:4，手机拍摄比例最佳。\n- 人脸尺寸大于100X100像素。\n- 图片格式支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -1737,7 +1741,7 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\nUrl、Image必须提供一个，如果都提供，只使用 Url。 \n图片的宽高比请接近 3:4，手机拍摄比例最佳。\n人脸尺寸大于100X100像素。\n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。\n图片格式支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- Url、Image必须提供一个，如果都提供，只使用 Url。 \n- 图片的宽高比请接近 3:4，手机拍摄比例最佳。\n- 人脸尺寸大于100X100像素。\n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 图片格式支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "Url",
@@ -1761,11 +1765,11 @@
       "members": [
         {
           "disabled": false,
-          "document": "活体打分，取值范围 [0,100]，根据活体分数对应的阈值区间来判断是否为翻拍。目前阈值可分为[5,10,40,70,90]，其中推荐阈值为40。",
+          "document": "活体打分。\n- 取值范围 [0,100]。\n- 根据活体分数对应的阈值区间来判断是否为翻拍。\n- 目前阈值可分为[5,10,40,70,90]，其中推荐阈值为40。",
           "example": "99",
           "member": "float",
           "name": "Score",
-          "required": true,
+          "output_required": true,
           "type": "float",
           "value_allowed_null": false
         },
@@ -1775,7 +1779,7 @@
           "example": "3.0",
           "member": "string",
           "name": "FaceModelVersion",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
@@ -1868,41 +1872,41 @@
       "members": [
         {
           "disabled": false,
-          "document": "识别是否佩戴眼镜。\nAttributeItem对应的Type为 —— 0：无眼镜，1：普通眼镜，2：墨镜",
-          "example": "",
+          "document": "识别是否佩戴眼镜。\n- AttributeItem对应的Type为 —— 0：无眼镜，1：普通眼镜，2：墨镜",
+          "example": "无",
           "member": "AttributeItem",
           "name": "Glass",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "识别眼睛的睁开、闭合状态。\nAttributeItem对应的Type为 —— 0：睁开，1：闭眼",
-          "example": "",
+          "document": "识别眼睛的睁开、闭合状态。\n- AttributeItem对应的Type为 —— 0：睁开，1：闭眼",
+          "example": "无",
           "member": "AttributeItem",
           "name": "EyeOpen",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "识别是否双眼皮。\nAttributeItem对应的Type为 —— 0：无，1：有。",
-          "example": "",
+          "document": "识别是否双眼皮。\n- AttributeItem对应的Type为 —— 0：无，1：有。",
+          "example": "无",
           "member": "AttributeItem",
           "name": "EyelidType",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "眼睛大小。\nAttributeItem对应的Type为 —— 0：小眼睛，1：普通眼睛，2：大眼睛。",
-          "example": "",
+          "document": "眼睛大小。\n- AttributeItem对应的Type为 —— 0：小眼睛，1：普通眼睛，2：大眼睛。",
+          "example": "无",
           "member": "AttributeItem",
           "name": "EyeSize",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": false
         }
@@ -1914,31 +1918,31 @@
       "members": [
         {
           "disabled": false,
-          "document": "眉毛浓密。\nAttributeItem对应的Type为 —— 0：淡眉，1：浓眉。",
-          "example": "",
+          "document": "眉毛浓密。\n- AttributeItem对应的Type为 —— 0：淡眉，1：浓眉。",
+          "example": "无",
           "member": "AttributeItem",
           "name": "EyebrowDensity",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "眉毛弯曲。\nAttributeItem对应的Type为 —— 0：不弯，1：弯眉。",
-          "example": "",
+          "document": "眉毛弯曲。\n- AttributeItem对应的Type为 —— 0：不弯，1：弯眉。",
+          "example": "无",
           "member": "AttributeItem",
           "name": "EyebrowCurve",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "眉毛长短。\nAttributeItem对应的Type为 —— 0：短眉毛，1：长眉毛。",
-          "example": "",
+          "document": "眉毛长短。\n- AttributeItem对应的Type为 —— 0：短眉毛，1：长眉毛。",
+          "example": "无",
           "member": "AttributeItem",
           "name": "EyebrowLength",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": false
         }
@@ -1950,8 +1954,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "性别[0~49]为女性，[50，100]为男性，越接近0和100表示置信度越高。NeedFaceAttributes 不为 1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "document": "性别。\n- 取值说明：[0~49]为女性，[50，100]为男性，越接近0和100表示置信度越高。\n- NeedFaceAttributes 不为 1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "example": "40",
           "member": "int64",
           "name": "Gender",
           "output_required": true,
@@ -1960,8 +1964,8 @@
         },
         {
           "disabled": false,
-          "document": "年龄 [0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "document": "年龄 。\n- 取值范围：[0~100]。\n- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "example": "39",
           "member": "int64",
           "name": "Age",
           "output_required": true,
@@ -1970,8 +1974,8 @@
         },
         {
           "disabled": false,
-          "document": "微笑[0(normal，正常)~100(laugh，大笑)]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "document": "微笑。\n- 取值说明：[0(normal，正常)~100(laugh，大笑)]。\n- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "example": "13",
           "member": "int64",
           "name": "Expression",
           "output_required": true,
@@ -1980,8 +1984,8 @@
         },
         {
           "disabled": false,
-          "document": "是否有眼镜 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "document": "是否有眼镜。\n- 取值范围： [true,false]。\n- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "example": "true",
           "member": "bool",
           "name": "Glass",
           "output_required": true,
@@ -1990,8 +1994,8 @@
         },
         {
           "disabled": false,
-          "document": "上下偏移[-30,30]，单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。 \n建议：人脸入库选择[-10,10]的图片。",
-          "example": "无",
+          "document": "上下偏移。\n- 取值范围：[-30,30]，单位角度。\n- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。 \n- 建议：人脸入库选择[-10,10]的图片。",
+          "example": "13",
           "member": "int64",
           "name": "Pitch",
           "output_required": true,
@@ -2000,8 +2004,8 @@
         },
         {
           "disabled": false,
-          "document": "左右偏移[-30,30]，单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。 \n建议：人脸入库选择[-10,10]的图片。",
-          "example": "无",
+          "document": "左右偏移。\n- 取值范围：[-30,30]，单位角度。 \n- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。 \n- 建议：人脸入库选择[-10,10]的图片。",
+          "example": "21",
           "member": "int64",
           "name": "Yaw",
           "output_required": true,
@@ -2010,8 +2014,8 @@
         },
         {
           "disabled": false,
-          "document": "平面旋转[-180,180]，单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。  \n建议：人脸入库选择[-20,20]的图片。",
-          "example": "无",
+          "document": "平面旋转。\n- 取值范围：[-180,180]，单位角度。 \n- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。  \n- 建议：人脸入库选择[-20,20]的图片。",
+          "example": "54",
           "member": "int64",
           "name": "Roll",
           "output_required": true,
@@ -2020,8 +2024,8 @@
         },
         {
           "disabled": false,
-          "document": "魅力[0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "document": "魅力。\n- 取值范围：[0~100]。\n- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "example": "50",
           "member": "int64",
           "name": "Beauty",
           "output_required": true,
@@ -2030,8 +2034,8 @@
         },
         {
           "disabled": false,
-          "document": "是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "无",
+          "document": "是否有帽子。\n- 取值范围： [true,false]。\n- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "true",
           "member": "bool",
           "name": "Hat",
           "output_required": true,
@@ -2040,8 +2044,8 @@
         },
         {
           "disabled": false,
-          "document": "是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "无",
+          "document": "是否有口罩。\n- 取值范围： [true,false]。\n- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "false",
           "member": "bool",
           "name": "Mask",
           "output_required": true,
@@ -2050,7 +2054,7 @@
         },
         {
           "disabled": false,
-          "document": "头发信息，包含头发长度（length）、有无刘海（bang）、头发颜色（color）。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "document": "头发信息，包含头发长度（length）、有无刘海（bang）、头发颜色（color）。\n- NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。\n注意：此字段可能返回 null，表示取不到有效值。",
           "example": "无",
           "member": "FaceHairAttributesInfo",
           "name": "Hair",
@@ -2060,8 +2064,8 @@
         },
         {
           "disabled": false,
-          "document": "双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼，就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "无",
+          "document": "双眼是否睁开。\n- 取值范围： [true,false]。\n- 只要有超过一只眼睛闭眼，就返回false。\n-  NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "true",
           "member": "bool",
           "name": "EyeOpen",
           "output_required": true,
@@ -2076,8 +2080,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "年龄 [0,65]，其中65代表“65岁及以上”。 \nFaceAttributesType 不含Age 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "document": "年龄。\n- 取值范围： [0,65]，其中65代表“65岁及以上”。 \n- FaceAttributesType 不含Age 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "example": "30",
           "member": "int64",
           "name": "Age",
           "output_required": true,
@@ -2086,7 +2090,7 @@
         },
         {
           "disabled": false,
-          "document": "美丑打分[0,100]。 \nFaceAttributesType 不含 Beauty 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "美丑打分。\n- 取值范围：[0,100]。 \n- FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "int64",
           "name": "Beauty",
@@ -2096,7 +2100,7 @@
         },
         {
           "disabled": false,
-          "document": "情绪，可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。 \nAttributeItem对应的Type为 —— 0：自然，1：高兴，2：惊讶，3：生气，4：悲伤，5：厌恶，6：害怕\nFaceAttributesType 不含Emotion 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "情绪，可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。 \n- AttributeItem对应的Type为 —— 0：自然，1：高兴，2：惊讶，3：生气，4：悲伤，5：厌恶，6：害怕。\n- FaceAttributesType 不含Emotion 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "AttributeItem",
           "name": "Emotion",
@@ -2106,7 +2110,7 @@
         },
         {
           "disabled": false,
-          "document": "眼睛相关信息，可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。 \nFaceAttributesType 不含Eye 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "眼睛相关信息，可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。 \n- FaceAttributesType 不含Eye 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "Eye",
           "name": "Eye",
@@ -2126,7 +2130,7 @@
         },
         {
           "disabled": false,
-          "document": "性别信息。 \nAttributeItem对应的Type为 —— \t0：男性，1：女性。\nFaceAttributesType 不含Gender 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "性别信息。 \n- AttributeItem对应的Type为 —— \t0：男性，1：女性。\n- FaceAttributesType 不含Gender 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "AttributeItem",
           "name": "Gender",
@@ -2136,7 +2140,7 @@
         },
         {
           "disabled": false,
-          "document": "头发信息，包含头发长度、有无刘海、头发颜色。 \nFaceAttributesType 不含Hair 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "头发信息，包含头发长度、有无刘海、头发颜色。 \n- FaceAttributesType 不含Hair 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "Hair",
           "name": "Hair",
@@ -2146,7 +2150,7 @@
         },
         {
           "disabled": false,
-          "document": "帽子信息，可识别是否佩戴帽子、帽子款式、帽子颜色。 \nFaceAttributesType 不含Hat 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "帽子信息，可识别是否佩戴帽子、帽子款式、帽子颜色。 \n- FaceAttributesType 不含Hat 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "Hat",
           "name": "Hat",
@@ -2156,7 +2160,7 @@
         },
         {
           "disabled": false,
-          "document": "姿态信息，包含人脸的上下偏移、左右偏移、平面旋转信息。 \nFaceAttributesType 不含Headpose 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "姿态信息，包含人脸的上下偏移、左右偏移、平面旋转信息。 \n- FaceAttributesType 不含Headpose 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "HeadPose",
           "name": "HeadPose",
@@ -2166,7 +2170,7 @@
         },
         {
           "disabled": false,
-          "document": "口罩佩戴信息。 \nAttributeItem对应的Type为 —— 0: 无口罩， 1: 有口罩不遮脸，2: 有口罩遮下巴，3: 有口罩遮嘴，4: 正确佩戴口罩。\nFaceAttributesType 不含Mask 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "口罩佩戴信息。 \n- AttributeItem对应的Type为 —— 0: 无口罩， 1: 有口罩不遮脸，2: 有口罩遮下巴，3: 有口罩遮嘴，4: 正确佩戴口罩。\n- FaceAttributesType 不含Mask 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "AttributeItem",
           "name": "Mask",
@@ -2176,7 +2180,7 @@
         },
         {
           "disabled": false,
-          "document": "嘴巴信息，可识别是否张嘴、嘴唇厚度。 \nFaceAttributesType 不含 Mouth 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "嘴巴信息，可识别是否张嘴、嘴唇厚度。 \n- FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "Mouth",
           "name": "Mouth",
@@ -2186,7 +2190,7 @@
         },
         {
           "disabled": false,
-          "document": "胡子信息。\nAttributeItem对应的Type为 —— 0：无胡子，1：有胡子。 \nFaceAttributesType 不含 Moustache 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "胡子信息。\n- AttributeItem对应的Type为 —— 0：无胡子，1：有胡子。 \n- FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "AttributeItem",
           "name": "Moustache",
@@ -2196,7 +2200,7 @@
         },
         {
           "disabled": false,
-          "document": "鼻子信息。 \nAttributeItem对应的Type为 —— 0：朝天鼻，1：鹰钩鼻，2：普通，3：圆鼻头\nFaceAttributesType 不含 Nose 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "鼻子信息。 \n- AttributeItem对应的Type为 —— 0：朝天鼻，1：鹰钩鼻，2：普通，3：圆鼻头\n- FaceAttributesType 不含 Nose 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "AttributeItem",
           "name": "Nose",
@@ -2206,7 +2210,7 @@
         },
         {
           "disabled": false,
-          "document": "脸型信息。 \nAttributeItem对应的Type为 —— 0：方脸，1：三角脸，2：鹅蛋脸，3：心形脸，4：圆脸。\nFaceAttributesType 不含 Shape 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "脸型信息。 \n- AttributeItem对应的Type为 —— 0：方脸，1：三角脸，2：鹅蛋脸，3：心形脸，4：圆脸。\n- FaceAttributesType 不含 Shape 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "AttributeItem",
           "name": "Shape",
@@ -2216,7 +2220,7 @@
         },
         {
           "disabled": false,
-          "document": "肤色信息。 \nAttributeItem对应的Type为 —— 0：黄色皮肤，1：棕色皮肤，2：黑色皮肤，3：白色皮肤。\nFaceAttributesType 不含 Skin 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "document": "肤色信息。 \n- AttributeItem对应的Type为 —— 0：黄色皮肤，1：棕色皮肤，2：黑色皮肤，3：白色皮肤。\n- FaceAttributesType 不含 Skin 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
           "example": "无",
           "member": "AttributeItem",
           "name": "Skin",
@@ -2226,8 +2230,8 @@
         },
         {
           "disabled": false,
-          "document": "微笑程度，[0,100]。 \nFaceAttributesType 不含 Smile 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "document": "微笑程度\n- 取值范围：[0,100]。 \n- FaceAttributesType 不含 Smile 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
+          "example": "20",
           "member": "int64",
           "name": "Smile",
           "output_required": true,
@@ -2252,7 +2256,7 @@
         },
         {
           "disabled": false,
-          "document": "人脸属性信息，根据 FaceAttributesType 输入的类型，返回年龄（Age）、颜值（Beauty） \n情绪（Emotion）、眼睛信息（Eye）、眉毛（Eyebrow）、性别（Gender） \n头发（Hair）、帽子（Hat）、姿态（Headpose）、口罩（Mask）、嘴巴（Mouth）、胡子（Moustache） \n鼻子（Nose）、脸型（Shape）、肤色（Skin）、微笑（Smile）等人脸属性信息。  \n若 FaceAttributesType 没有输入相关类型，则FaceDetaiAttributesInfo返回的细项不具备参考意义。",
+          "document": "人脸属性信息。\n- 根据 FaceAttributesType 输入的类型，返回年龄（Age）、颜值（Beauty）、情绪（Emotion）、眼睛信息（Eye）、眉毛（Eyebrow）、性别（Gender）、头发（Hair）、帽子（Hat）、姿态（Headpose）、口罩（Mask）、嘴巴（Mouth）、胡子（Moustache） 、鼻子（Nose）、脸型（Shape）、肤色（Skin）、微笑（Smile）等人脸属性信息。  \n- 若 FaceAttributesType 没有输入相关类型，则FaceDetaiAttributesInfo返回的细项不具备参考意义。",
           "example": "无",
           "member": "FaceDetailAttributesInfo",
           "name": "FaceDetailAttributesInfo",
@@ -2268,31 +2272,31 @@
       "members": [
         {
           "disabled": false,
-          "document": "0：光头，1：短发，2：中发，3：长发，4：绑发\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "取值范围：0：光头，1：短发，2：中发，3：长发，4：绑发。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "1",
           "member": "int64",
           "name": "Length",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "0：有刘海，1：无刘海\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "取值范围：0：有刘海，1：无刘海。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "0",
           "member": "int64",
           "name": "Bang",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "0：黑色，1：金色，2：棕色，3：灰白色\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "取值范围：0：黑色，1：金色，2：棕色，3：灰白色。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "1",
           "member": "int64",
           "name": "Color",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         }
@@ -2304,61 +2308,61 @@
       "members": [
         {
           "disabled": false,
-          "document": "人脸框左上角横坐标。\n人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 \n若需截取完整人脸，可以在完整分completeness满足需求的情况下，将负值坐标取0。",
-          "example": "",
+          "document": "人脸框左上角横坐标。\n- 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 \n- 若需截取完整人脸，可以在完整分completeness满足需求的情况下，将负值坐标取0。",
+          "example": "35",
           "member": "int64",
           "name": "X",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人脸框左上角纵坐标。 \n人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 \n若需截取完整人脸，可以在完整分completeness满足需求的情况下，将负值坐标取0。",
-          "example": "",
+          "document": "人脸框左上角纵坐标。 \n- 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 \n- 若需截取完整人脸，可以在完整分completeness满足需求的情况下，将负值坐标取0。",
+          "example": "61",
           "member": "int64",
           "name": "Y",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人脸框宽度。",
-          "example": "",
+          "example": "10",
           "member": "int64",
           "name": "Width",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人脸框高度。",
-          "example": "",
+          "example": "8",
           "member": "int64",
           "name": "Height",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人脸属性信息，包含性别( gender )、年龄( age )、表情( expression )、 \n魅力( beauty )、眼镜( glass )、口罩（mask）、头发（hair）和姿态 (pitch，roll，yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。",
-          "example": "",
+          "document": "人脸属性信息。\n- 包含性别( gender )、年龄( age )、表情( expression )、魅力( beauty )、眼镜( glass )、口罩（mask）、头发（hair）和姿态 (pitch，roll，yaw )。\n- 只有当 NeedFaceAttributes 设为 1 时才返回有效信息。",
+          "example": "无",
           "member": "FaceAttributesInfo",
           "name": "FaceAttributesInfo",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人脸质量信息，包含质量分（score）、模糊分（sharpness）、光照分（brightness）、遮挡分（completeness）。只有当NeedFaceDetection设为1时才返回有效信息。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "人脸质量信息。\n- 包含质量分（score）、模糊分（sharpness）、光照分（brightness）、遮挡分（completeness）。\n- 只有当NeedFaceDetection设为1时才返回有效信息。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "无",
           "member": "FaceQualityInfo",
           "name": "FaceQualityInfo",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": true
         }
@@ -2370,61 +2374,61 @@
       "members": [
         {
           "disabled": false,
-          "document": "眉毛的遮挡分数[0,100]，分数越高遮挡越少。 \n参考范围：[0,80]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "眉毛的遮挡分数。\n- 取值范围：[0,100]，分数越高遮挡越少。 \n- 参考范围：[0,80]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "70",
           "member": "int64",
           "name": "Eyebrow",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "眼睛的遮挡分数[0,100],分数越高遮挡越少。 \n参考范围：[0,80]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "眼睛的遮挡分数。\n- 取值范围：[0,100],分数越高遮挡越少。 \n- 参考范围：[0,80]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "60",
           "member": "int64",
           "name": "Eye",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "鼻子的遮挡分数[0,100],分数越高遮挡越少。 \n参考范围：[0,60]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "鼻子的遮挡分数。\n- 取值范围：[0,100],分数越高遮挡越少。 \n- 参考范围：[0,60]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "30",
           "member": "int64",
           "name": "Nose",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "脸颊的遮挡分数[0,100],分数越高遮挡越少。 \n参考范围：[0,70]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "脸颊的遮挡分数。\n- 取值范围：[0,100],分数越高遮挡越少。 \n- 参考范围：[0,70]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "10",
           "member": "int64",
           "name": "Cheek",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "嘴巴的遮挡分数[0,100],分数越高遮挡越少。 \n参考范围：[0,50]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "嘴巴的遮挡分数。\n- 取值范围：[0,100],分数越高遮挡越少。 \n- 参考范围：[0,50]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "10",
           "member": "int64",
           "name": "Mouth",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "下巴的遮挡分数[0,100],分数越高遮挡越少。 \n参考范围：[0,70]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "下巴的遮挡分数。\n- 取值范围：[0,100],分数越高遮挡越少。 \n- 参考范围：[0,70]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "80",
           "member": "int64",
           "name": "Chin",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         }
@@ -2436,41 +2440,41 @@
       "members": [
         {
           "disabled": false,
-          "document": "质量分: [0,100]，综合评价图像质量是否适合人脸识别，分数越高质量越好。 \n正常情况，只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。\n参考范围：[0,40]较差，[40,60] 一般，[60,80]较好，[80,100]很好。 \n建议：人脸入库选取70以上的图片。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "质量分。\n- 取值范围：[0,100]，综合评价图像质量是否适合人脸识别，分数越高质量越好。 \n- 正常情况，只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。\n- 参考范围：[0,40]较差，[40,60] 一般，[60,80]较好，[80,100]很好。 \n- 建议：人脸入库选取70以上的图片。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "80",
           "member": "int64",
           "name": "Score",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "清晰分：[0,100]，评价图片清晰程度，分数越高越清晰。 \n参考范围：[0,40]特别模糊，[40,60]模糊，[60,80]一般，[80,100]清晰。 \n建议：人脸入库选取80以上的图片。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "清晰分。\n- 取值范围：[0,100]，评价图片清晰程度，分数越高越清晰。 \n- 参考范围：[0,40]特别模糊，[40,60]模糊，[60,80]一般，[80,100]清晰。 \n- 建议：人脸入库选取80以上的图片。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "100",
           "member": "int64",
           "name": "Sharpness",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "光照分：[0,100]，评价图片光照程度，分数越高越亮。 \n参考范围： [0,30]偏暗，[30,70]光照正常，[70,100]偏亮。 \n建议：人脸入库选取[30,70]的图片。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "光照分。\n- 取值范围：[0,100]，评价图片光照程度，分数越高越亮。 \n- 参考范围： [0,30]偏暗，[30,70]光照正常，[70,100]偏亮。 \n- 建议：人脸入库选取[30,70]的图片。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "30",
           "member": "int64",
           "name": "Brightness",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
           "document": "五官遮挡分，评价眉毛（Eyebrow）、眼睛（Eye）、鼻子（Nose）、脸颊（Cheek）、嘴巴（Mouth）、下巴（Chin）的被遮挡程度。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "example": "无",
           "member": "FaceQualityCompleteness",
           "name": "Completeness",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": true
         }
@@ -2482,46 +2486,50 @@
       "members": [
         {
           "disabled": false,
-          "document": "人脸框左上角横坐标。 \n人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 \n若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。",
-          "example": "",
+          "document": "人脸框左上角横坐标。 \n- 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 \n- 若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。",
+          "example": "253",
           "member": "int64",
           "name": "X",
-          "required": true,
+          "output_required": true,
+          "required": false,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人脸框左上角纵坐标。 \n人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 \n若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。",
-          "example": "",
+          "document": "人脸框左上角纵坐标。 \n- 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 \n- 若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。",
+          "example": "414",
           "member": "int64",
           "name": "Y",
-          "required": true,
+          "output_required": true,
+          "required": false,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人脸宽度",
-          "example": "",
+          "document": "人脸宽度。",
+          "example": "180",
           "member": "uint64",
           "name": "Width",
-          "required": true,
+          "output_required": true,
+          "required": false,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人脸高度",
-          "example": "",
+          "document": "人脸高度。",
+          "example": "90",
           "member": "uint64",
           "name": "Height",
-          "required": true,
+          "output_required": true,
+          "required": false,
           "type": "int",
           "value_allowed_null": false
         }
       ],
-      "usage": "out"
+      "usage": "both"
     },
     "FaceShape": {
       "document": "五官定位（人脸关键点）具体信息。",
@@ -2624,8 +2632,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员库 ID，取值为创建人员库接口中的GroupId",
-          "example": "ABC",
+          "document": "人员库 ID，取值为创建人员库接口中的GroupId。",
+          "example": "32",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -2639,8 +2647,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员库名称",
-          "example": "ABC",
+          "document": "人员库名称。",
+          "example": "正式人员名单",
           "member": "string",
           "name": "GroupName",
           "output_required": true,
@@ -2649,8 +2657,8 @@
         },
         {
           "disabled": false,
-          "document": "人员库ID",
-          "example": "ABC",
+          "document": "人员库ID。",
+          "example": "31",
           "member": "string",
           "name": "GroupId",
           "output_required": true,
@@ -2659,8 +2667,8 @@
         },
         {
           "disabled": false,
-          "document": "人员库自定义描述字段",
-          "example": "ABC",
+          "document": "人员库自定义描述字段。",
+          "example": "[\"年龄\"]",
           "member": "string",
           "name": "GroupExDescriptions",
           "output_required": true,
@@ -2669,8 +2677,8 @@
         },
         {
           "disabled": false,
-          "document": "人员库信息备注",
-          "example": "ABC",
+          "document": "人员库信息备注。",
+          "example": "无实习生",
           "member": "string",
           "name": "Tag",
           "output_required": true,
@@ -2767,8 +2775,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员ID，创建人员接口中的PersonId",
-          "example": "",
+          "document": "人员ID，创建人员接口中的PersonId。",
+          "example": "1002",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -2782,28 +2790,31 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员名称",
-          "example": "",
+          "document": "人员名称。",
+          "example": "韦小宝",
           "member": "string",
           "name": "PersonName",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人员性别，0代表未填写，1代表男性，2代表女性",
-          "example": "",
+          "document": "人员性别。\n- 取值范围：0代表未填写，1代表男性，2代表女性。",
+          "example": "2",
           "member": "int64",
           "name": "Gender",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "包含的人脸 ID 列表",
-          "example": "",
+          "document": "包含的人脸 ID 列表。",
+          "example": "[ \"287364080202264488\"]",
           "member": "string",
           "name": "FaceIds",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
@@ -2821,8 +2832,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员ID，取值为创建人员接口中的PersonId",
-          "example": "",
+          "document": "人员ID，取值为创建人员接口中的PersonId。",
+          "example": "1002",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -2830,8 +2841,8 @@
         },
         {
           "disabled": false,
-          "document": "起始序号，默认值为0",
-          "example": "",
+          "document": "起始序号，默认值为0。",
+          "example": "0",
           "member": "uint64",
           "name": "Offset",
           "required": false,
@@ -2839,8 +2850,8 @@
         },
         {
           "disabled": false,
-          "document": "返回数量，默认值为10，最大值为100",
-          "example": "",
+          "document": "返回数量，默认值为10，最大值为100。",
+          "example": "10",
           "member": "uint64",
           "name": "Limit",
           "required": false,
@@ -2854,28 +2865,31 @@
       "members": [
         {
           "disabled": false,
-          "document": "包含此人员的人员库及描述字段内容列表",
-          "example": "",
+          "document": "包含此人员的人员库及描述字段内容列表。",
+          "example": "无",
           "member": "PersonGroupInfo",
           "name": "PersonGroupInfos",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人员库总数量\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "人员库总数量。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "30",
           "member": "uint64",
           "name": "GroupNum",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
           "document": "人脸识别服务所用的算法模型版本。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "example": "3.0",
           "member": "string",
           "name": "FaceModelVersion",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": true
         },
@@ -2893,8 +2907,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员库ID，取值为创建人员库接口中的GroupId",
-          "example": "",
+          "document": "人员库ID，取值为创建人员库接口中的GroupId。",
+          "example": "TencentShenZhenEmployee",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -2908,19 +2922,21 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员数量",
-          "example": "",
+          "document": "人员数量。",
+          "example": "10",
           "member": "uint64",
           "name": "PersonNum",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人脸数量",
-          "example": "",
+          "document": "人脸数量。",
+          "example": "10",
           "member": "uint64",
           "name": "FaceNum",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -2938,8 +2954,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员库ID，取值为创建人员库接口中的GroupId",
-          "example": "",
+          "document": "人员库ID，取值为创建人员库接口中的GroupId。",
+          "example": "ZhuYuanDormitory",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -2947,8 +2963,8 @@
         },
         {
           "disabled": false,
-          "document": "起始序号，默认值为0",
-          "example": "",
+          "document": "起始序号，默认值为0。",
+          "example": "0",
           "member": "uint64",
           "name": "Offset",
           "required": false,
@@ -2956,8 +2972,8 @@
         },
         {
           "disabled": false,
-          "document": "返回数量，默认值为10，最大值为1000",
-          "example": "",
+          "document": "返回数量，默认值为10，最大值为1000。",
+          "example": "10",
           "member": "uint64",
           "name": "Limit",
           "required": false,
@@ -2971,37 +2987,41 @@
       "members": [
         {
           "disabled": false,
-          "document": "返回的人员信息",
-          "example": "",
+          "document": "返回的人员信息。",
+          "example": "无",
           "member": "PersonInfo",
           "name": "PersonInfos",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "该人员库的人员数量\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "该人员库的人员数量。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "20",
           "member": "uint64",
           "name": "PersonNum",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "该人员库的人脸数量\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "该人员库的人脸数量。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "20",
           "member": "uint64",
           "name": "FaceNum",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
           "document": "人脸识别所用的算法模型版本。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "example": "3.0",
           "member": "string",
           "name": "FaceModelVersion",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": true
         },
@@ -3181,10 +3201,10 @@
         {
           "disabled": false,
           "document": "人员库ID 。",
-          "example": "无",
+          "example": "1001",
           "member": "string",
           "name": "GroupId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
@@ -3194,7 +3214,7 @@
           "example": "无",
           "member": "Candidate",
           "name": "Candidates",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         }
@@ -3206,23 +3226,21 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员库自定义描述字段Index，从0开始",
-          "example": "",
+          "document": "人员库自定义描述字段Index，从0开始。",
+          "example": "无",
           "member": "uint64",
           "name": "GroupExDescriptionIndex",
           "required": true,
-          "type": "int",
-          "value_allowed_null": true
+          "type": "int"
         },
         {
           "disabled": false,
-          "document": "需要更新的人员库自定义描述字段内容",
-          "example": "",
+          "document": "需要更新的人员库自定义描述字段内容。",
+          "example": "年龄",
           "member": "string",
           "name": "GroupExDescription",
           "required": true,
-          "type": "string",
-          "value_allowed_null": false
+          "type": "string"
         }
       ],
       "usage": "in"
@@ -3232,61 +3250,61 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员库名称",
-          "example": "",
+          "document": "人员库名称。",
+          "example": "人员库",
           "member": "string",
           "name": "GroupName",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人员库ID",
-          "example": "",
+          "document": "人员库ID。",
+          "example": "13",
           "member": "string",
           "name": "GroupId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人员库自定义描述字段\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "人员库自定义描述字段。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "[\"年龄\"]",
           "member": "string",
           "name": "GroupExDescriptions",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "人员库信息备注\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "人员库信息备注。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "无实习生",
           "member": "string",
           "name": "Tag",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": true
         },
         {
           "disabled": false,
           "document": "人脸识别所用的算法模型版本。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "example": "3.0",
           "member": "string",
           "name": "FaceModelVersion",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。 \nUnix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。有关更多信息，请参阅 Unix 时间。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "document": "Group的创建时间和日期 CreationTimestamp。\n- CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。 \n- Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。\n- 有关更多信息，请参阅 Unix 时间。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "1694139227378",
           "member": "uint64",
           "name": "CreationTimestamp",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         }
@@ -3361,30 +3379,30 @@
         {
           "disabled": false,
           "document": "上下偏移[-30,30]。",
-          "example": "",
+          "example": "28",
           "member": "int64",
           "name": "Pitch",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "左右偏移[-30,30]。",
-          "example": "",
+          "example": "10",
           "member": "int64",
           "name": "Yaw",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "平面旋转[-180,180]。",
-          "example": "",
+          "example": "23",
           "member": "int64",
           "name": "Roll",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         }
@@ -3396,8 +3414,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员库ID，取值为创建人员库接口中的GroupId",
-          "example": "",
+          "document": "人员库ID，取值为创建人员库接口中的GroupId。",
+          "example": "32",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -3405,8 +3423,8 @@
         },
         {
           "disabled": false,
-          "document": "人员库名称",
-          "example": "",
+          "document": "人员库名称。",
+          "example": "人员库名单",
           "member": "string",
           "name": "GroupName",
           "required": false,
@@ -3414,8 +3432,8 @@
         },
         {
           "disabled": false,
-          "document": "需要修改的人员库自定义描述字段，key-value",
-          "example": "",
+          "document": "需要修改的人员库自定义描述字段，key-value。",
+          "example": "无",
           "member": "GroupExDescriptionInfo",
           "name": "GroupExDescriptionInfos",
           "required": false,
@@ -3423,8 +3441,8 @@
         },
         {
           "disabled": false,
-          "document": "人员库信息备注",
-          "example": "",
+          "document": "人员库信息备注。",
+          "example": "无实习生",
           "member": "string",
           "name": "Tag",
           "required": false,
@@ -3450,7 +3468,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员ID，取值为创建人员接口中的PersonId",
+          "document": "人员ID，取值为创建人员接口中的PersonId。",
           "example": "2001",
           "member": "string",
           "name": "PersonId",
@@ -3459,8 +3477,8 @@
         },
         {
           "disabled": false,
-          "document": "需要修改的人员名称",
-          "example": "JunlyWang",
+          "document": "需要修改的人员名称。",
+          "example": "韦小宝",
           "member": "string",
           "name": "PersonName",
           "required": false,
@@ -3468,7 +3486,7 @@
         },
         {
           "disabled": false,
-          "document": "需要修改的人员性别，1代表男性，2代表女性",
+          "document": "需要修改的人员性别，1代表男性，2代表女性。",
           "example": "1",
           "member": "int64",
           "name": "Gender",
@@ -3495,8 +3513,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员库ID，取值为创建人员库接口中的GroupId",
-          "example": "",
+          "document": "人员库ID，取值为创建人员库接口中的GroupId。",
+          "example": "TencentShenZhenEmployee",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -3504,8 +3522,8 @@
         },
         {
           "disabled": false,
-          "document": "人员ID，取值为创建人员接口中的PersonId",
-          "example": "",
+          "document": "人员ID，取值为创建人员接口中的PersonId。",
+          "example": "1001",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -3513,8 +3531,8 @@
         },
         {
           "disabled": false,
-          "document": "需要修改的人员描述字段内容，key-value",
-          "example": "",
+          "document": "需要修改的人员描述字段内容，key-value。",
+          "example": "无",
           "member": "PersonExDescriptionInfo",
           "name": "PersonExDescriptionInfos",
           "required": true,
@@ -3556,23 +3574,21 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员描述字段Index，从0开始",
-          "example": "",
+          "document": "人员描述字段Index，从0开始。",
+          "example": "0",
           "member": "uint64",
           "name": "PersonExDescriptionIndex",
           "required": true,
-          "type": "int",
-          "value_allowed_null": true
+          "type": "int"
         },
         {
           "disabled": false,
-          "document": "需要更新的人员描述字段内容",
-          "example": "",
+          "document": "需要更新的人员描述字段内容。",
+          "example": "年龄",
           "member": "string",
           "name": "PersonExDescription",
           "required": true,
-          "type": "string",
-          "value_allowed_null": false
+          "type": "string"
         }
       ],
       "usage": "in"
@@ -3582,21 +3598,21 @@
       "members": [
         {
           "disabled": false,
-          "document": "包含此人员的人员库ID",
-          "example": "",
+          "document": "包含此人员的人员库ID。",
+          "example": "1001",
           "member": "string",
           "name": "GroupId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人员描述字段内容",
-          "example": "",
+          "document": "人员描述字段内容。",
+          "example": "[\"年龄\"]",
           "member": "string",
           "name": "PersonExDescriptions",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         }
@@ -3608,61 +3624,61 @@
       "members": [
         {
           "disabled": false,
-          "document": "人员名称",
-          "example": "",
+          "document": "人员名称。",
+          "example": "韦小宝",
           "member": "string",
           "name": "PersonName",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人员Id",
-          "example": "",
+          "document": "人员Id。",
+          "example": "1001",
           "member": "string",
           "name": "PersonId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人员性别",
-          "example": "",
+          "document": "人员性别。",
+          "example": "0",
           "member": "int64",
           "name": "Gender",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人员描述字段内容",
-          "example": "",
+          "document": "人员描述字段内容。",
+          "example": "[\"年龄\"]",
           "member": "string",
           "name": "PersonExDescriptions",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "包含的人脸照片列表",
-          "example": "",
+          "document": "包含的人脸照片列表。",
+          "example": "[\"2877244861637985315\"]",
           "member": "string",
           "name": "FaceIds",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。 \nUnix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。有关更多信息，请参阅 Unix 时间。",
-          "example": "",
+          "document": "人员的创建时间和日期 CreationTimestamp。\n- CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。 \n- Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。\n- 有关更多信息，请参阅 Unix 时间。",
+          "example": "1594642823572",
           "member": "uint64",
           "name": "CreationTimestamp",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         }
@@ -3674,21 +3690,21 @@
       "members": [
         {
           "disabled": false,
-          "document": "x坐标",
-          "example": "",
+          "document": "x坐标。",
+          "example": "294",
           "member": "int64",
           "name": "X",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Y坐标",
-          "example": "",
+          "document": "Y坐标。",
+          "example": "137",
           "member": "int64",
           "name": "Y",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         }
@@ -3700,31 +3716,31 @@
       "members": [
         {
           "disabled": false,
-          "document": "识别出的最相似候选人",
-          "example": "",
+          "document": "识别出的最相似候选人。",
+          "example": "无",
           "member": "Candidate",
           "name": "Candidates",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "检测出的人脸框位置",
-          "example": "",
+          "document": "检测出的人脸框位置。",
+          "example": "无",
           "member": "FaceRect",
           "name": "FaceRect",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "检测出的人脸图片状态返回码。0 表示正常。 \n-1601代表不符合图片质量控制要求，此时Candidate内容为空。",
-          "example": "",
+          "document": "检测出的人脸图片状态返回码。\n- 0 表示正常。 \n- -1601代表不符合图片质量控制要求，此时Candidate内容为空。",
+          "example": "0",
           "member": "int64",
           "name": "RetCode",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         }
@@ -3732,35 +3748,35 @@
       "usage": "out"
     },
     "ResultsReturnsByGroup": {
-      "document": "识别结果。\n",
+      "document": "识别结果。",
       "members": [
         {
           "disabled": false,
           "document": "检测出的人脸框位置。",
-          "example": "",
+          "example": "无",
           "member": "FaceRect",
           "name": "FaceRect",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "识别结果。",
-          "example": "",
+          "example": "无",
           "member": "GroupCandidate",
           "name": "GroupCandidates",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "检测出的人脸图片状态返回码。0 表示正常。 \n-1601代表不符合图片质量控制要求，此时Candidate内容为空。",
-          "example": "",
+          "document": "检测出的人脸图片状态返回码。\n- 0 表示正常。 \n- -1601代表不符合图片质量控制要求，此时Candidate内容为空。",
+          "example": "无",
           "member": "int64",
           "name": "RetCode",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         }
@@ -3799,7 +3815,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "希望搜索的人员库列表，上限100个。数组元素取值为创建人员库接口中的GroupId。\n不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。",
+          "document": "希望搜索的人员库列表，上限100个。\n- 数组元素取值为创建人员库接口中的GroupId。\n- 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。",
           "example": "[\"TencentShenZhenEmployee\"]",
           "member": "string",
           "name": "GroupIds",
@@ -3808,8 +3824,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -3817,7 +3833,7 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nUrl、Image必须提供一个，如果都提供，只使用 Url。  \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- Url、Image必须提供一个，如果都提供，只使用 Url。  \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "Url",
@@ -3826,7 +3842,7 @@
         },
         {
           "disabled": false,
-          "document": "最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 \nMaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 \n例如：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
+          "document": "最多识别的人脸数目。\n- 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 \n- MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 \n- 例如：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
           "example": "1",
           "member": "uint64",
           "name": "MaxFaceNum",
@@ -3835,7 +3851,7 @@
         },
         {
           "disabled": false,
-          "document": "人脸长和宽的最小尺寸，单位为像素。默认为34。低于34的人脸图片无法被识别。建议设置为80。",
+          "document": "人脸长和宽的最小尺寸，单位为像素。\n- 默认为34。\n- 低于34的人脸图片无法被识别。\n- 建议设置为80。",
           "example": "40",
           "member": "uint64",
           "name": "MinFaceSize",
@@ -3844,7 +3860,7 @@
         },
         {
           "disabled": false,
-          "document": "单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。 \n例如，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。\n值越大，需要处理的时间越长。建议不要超过10。",
+          "document": "单张被识别的人脸返回的最相似人员数量。\n- 默认值为5，最大值为100。 \n- 例如，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。\n- 值越大，需要处理的时间越长。\n- 建议不要超过10。",
           "example": "5",
           "member": "uint64",
           "name": "MaxPersonNum",
@@ -3853,7 +3869,7 @@
         },
         {
           "disabled": false,
-          "document": "是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0",
+          "document": "是否返回人员具体信息。\n- 取值范围：0 为关闭，1 为开启。\n- 默认为 0。\n- 其他非0非1值默认为0。",
           "example": "0",
           "member": "int64",
           "name": "NeedPersonInfo",
@@ -3862,7 +3878,7 @@
         },
         {
           "disabled": false,
-          "document": "图片质量控制。 \n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
+          "document": "图片质量控制。 \n- 取值范围：\n0: 不进行控制。\n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。\n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。\n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。\n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。\n- 默认 0。 \n- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
           "example": "0",
           "member": "uint64",
           "name": "QualityControl",
@@ -3880,7 +3896,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 取值范围：0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
@@ -3937,7 +3953,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "希望搜索的人员库列表，上限60个。数组元素取值为创建人员库接口中的GroupId。\n不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。",
+          "document": "希望搜索的人员库列表，上限60个。\n- 数组元素取值为创建人员库接口中的GroupId。\n- 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。",
           "example": "[\"TencentShenZhenEmployee\\n\"]",
           "member": "string",
           "name": "GroupIds",
@@ -3946,8 +3962,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -3955,7 +3971,7 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nUrl、Image必须提供一个，如果都提供，只使用 Url。\n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。\n非腾讯云存储的Url速度和稳定性可能受一定影响。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- Url、Image必须提供一个，如果都提供，只使用 Url。\n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。\n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "Url",
@@ -3964,7 +3980,7 @@
         },
         {
           "disabled": false,
-          "document": "最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。\nMaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。\n例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
+          "document": "最多识别的人脸数目。\n- 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。\n- MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。\n- 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
           "example": "1",
           "member": "uint64",
           "name": "MaxFaceNum",
@@ -3973,7 +3989,7 @@
         },
         {
           "disabled": false,
-          "document": "人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。",
+          "document": "人脸长和宽的最小尺寸，单位为像素。\n- 默认为34。\n- 低于34将影响搜索精度。\n- 建议设置为80。",
           "example": "40",
           "member": "uint64",
           "name": "MinFaceSize",
@@ -3982,7 +3998,7 @@
         },
         {
           "disabled": false,
-          "document": "被检测到的人脸，对应最多返回的最相似人员数目。默认值为5，最大值为10。  \n例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。",
+          "document": "被检测到的人脸，对应最多返回的最相似人员数目。\n- 默认值为5，最大值为10。  \n- 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。",
           "example": "5",
           "member": "uint64",
           "name": "MaxPersonNumPerGroup",
@@ -3991,7 +4007,7 @@
         },
         {
           "disabled": false,
-          "document": "是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0",
+          "document": "是否返回人员具体信息。\n- 取值范围：0 为关闭，1 为开启。\n- 默认为 0。\n- 其他非0非1值默认为0",
           "example": "0",
           "member": "int64",
           "name": "NeedPersonInfo",
@@ -4000,7 +4016,7 @@
         },
         {
           "disabled": false,
-          "document": "图片质量控制。 \n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
+          "document": "图片质量控制。 \n- 取值范围：\n0: 不进行控制。\n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。\n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。\n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。\n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。\n- 默认 0。 \n- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
           "example": "0",
           "member": "uint64",
           "name": "QualityControl",
@@ -4009,7 +4025,7 @@
         },
         {
           "disabled": false,
-          "document": "出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。\n默认为0。\n取值范围[0.0,100.0) 。",
+          "document": "出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。\n- 默认为0。\n- 取值范围：[0.0,100.0) 。",
           "example": "0",
           "member": "float",
           "name": "FaceMatchThreshold",
@@ -4018,7 +4034,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 取值范围：0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
@@ -4075,8 +4091,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "希望搜索的人员库列表，上限100个。数组元素取值为创建人员库接口中的GroupId",
-          "example": "[\"TencentShenZhenEmployee\\r\\n\"]",
+          "document": "希望搜索的人员库列表，上限100个。数组元素取值为创建人员库接口中的GroupId。",
+          "example": "[\"TencentShenZhenEmployee\"]",
           "member": "string",
           "name": "GroupIds",
           "required": true,
@@ -4084,8 +4100,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -4093,7 +4109,7 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nUrl、Image必须提供一个，如果都提供，只使用 Url。\n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。\n非腾讯云存储的Url速度和稳定性可能受一定影响。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- Url、Image必须提供一个，如果都提供，只使用 Url。\n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。\n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "Url",
@@ -4102,7 +4118,7 @@
         },
         {
           "disabled": false,
-          "document": "最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。\nMaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。\n例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
+          "document": "最多识别的人脸数目。\n- 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。\n- MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。\n- 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
           "example": "1",
           "member": "uint64",
           "name": "MaxFaceNum",
@@ -4111,7 +4127,7 @@
         },
         {
           "disabled": false,
-          "document": "人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。",
+          "document": "人脸长和宽的最小尺寸，单位为像素。\n- 默认为34。\n- 低于34将影响搜索精度。\n- 建议设置为80。",
           "example": "40",
           "member": "uint64",
           "name": "MinFaceSize",
@@ -4120,7 +4136,7 @@
         },
         {
           "disabled": false,
-          "document": "单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。\n例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。\n值越大，需要处理的时间越长。建议不要超过10。",
+          "document": "单张被识别的人脸返回的最相似人员数量。\n- 默认值为5，最大值为100。\n- 例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。\n- 值越大，需要处理的时间越长。建议不要超过10。",
           "example": "3",
           "member": "uint64",
           "name": "MaxPersonNum",
@@ -4129,7 +4145,7 @@
         },
         {
           "disabled": false,
-          "document": "图片质量控制。 \n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
+          "document": "图片质量控制。 \n- 取值范围：\n0: 不进行控制。\n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。\n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。\n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。\n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。\n- 默认 0。 \n- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
           "example": "0",
           "member": "uint64",
           "name": "QualityControl",
@@ -4138,7 +4154,7 @@
         },
         {
           "disabled": false,
-          "document": "出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。",
+          "document": "出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。\n- 默认为0。\n- 取值范围：[0.0,100.0) 。",
           "example": "0",
           "member": "float",
           "name": "FaceMatchThreshold",
@@ -4147,7 +4163,7 @@
         },
         {
           "disabled": false,
-          "document": "是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0",
+          "document": "是否返回人员具体信息。\n- 取值范围：0 为关闭，1 为开启。\n- 默认为 0。\n- 其他非0非1值默认为0",
           "example": "0",
           "member": "int64",
           "name": "NeedPersonInfo",
@@ -4156,7 +4172,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 取值范围：0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
@@ -4213,8 +4229,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "希望搜索的人员库列表，上限60个。数组元素取值为创建人员库接口中的GroupId",
-          "example": "TencentShenZhenEmployee",
+          "document": "希望搜索的人员库列表，上限60个。数组元素取值为创建人员库接口中的GroupId。",
+          "example": "[\"TencentShenZhenEmployee\"]",
           "member": "string",
           "name": "GroupIds",
           "required": true,
@@ -4222,8 +4238,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "http://test.image.myqcloud.com/testB.jpg",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -4231,7 +4247,7 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。\nUrl、Image必须提供一个，如果都提供，只使用 Url。\n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。\n非腾讯云存储的Url速度和稳定性可能受一定影响。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- Url、Image必须提供一个，如果都提供，只使用 Url。\n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。\n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testB.jpg",
           "member": "string",
           "name": "Url",
@@ -4240,7 +4256,7 @@
         },
         {
           "disabled": false,
-          "document": "最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。\nMaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。\n例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
+          "document": "最多识别的人脸数目。\n- 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。\n- MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。\n- 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
           "example": "1",
           "member": "uint64",
           "name": "MaxFaceNum",
@@ -4249,7 +4265,7 @@
         },
         {
           "disabled": false,
-          "document": "人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。",
+          "document": "人脸长和宽的最小尺寸，单位为像素。\n- 默认为34。\n- 低于34将影响搜索精度。\n- 建议设置为80。",
           "example": "80",
           "member": "uint64",
           "name": "MinFaceSize",
@@ -4258,7 +4274,7 @@
         },
         {
           "disabled": false,
-          "document": "被检测到的人脸，对应最多返回的最相似人员数目。默认值为5，最大值为10。  \n例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。",
+          "document": "被检测到的人脸，对应最多返回的最相似人员数目。\n- 默认值为5，最大值为10。  \n- 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。",
           "example": "5",
           "member": "uint64",
           "name": "MaxPersonNumPerGroup",
@@ -4267,7 +4283,7 @@
         },
         {
           "disabled": false,
-          "document": "图片质量控制。 \n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
+          "document": "图片质量控制。 \n- 取值范围：\n0: 不进行控制。\n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。\n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。\n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。\n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。\n- 默认 0。 \n- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
           "example": "0",
           "member": "uint64",
           "name": "QualityControl",
@@ -4285,7 +4301,7 @@
         },
         {
           "disabled": false,
-          "document": "是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0",
+          "document": "是否返回人员具体信息。\n- 取值范围：0 为关闭，1 为开启。\n- 默认为 0。\n- 其他非0非1值默认为0。",
           "example": "0",
           "member": "int64",
           "name": "NeedPersonInfo",
@@ -4294,7 +4310,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 取值范围：0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
@@ -4464,7 +4480,7 @@
         {
           "disabled": false,
           "document": "待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。",
-          "example": "11111111",
+          "example": "1001",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -4472,8 +4488,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据，base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "document": "图片 base64 数据。\n- base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -4481,7 +4497,7 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\nUrl、Image必须提供一个，如果都提供，只使用 Url。  \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "document": "图片的 Url 。\n- 对应图片 base64 编码后大小不可超过5M。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- Url、Image必须提供一个，如果都提供，只使用 Url。  \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
           "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "Url",
@@ -4490,7 +4506,7 @@
         },
         {
           "disabled": false,
-          "document": "图片质量控制。 \n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
+          "document": "图片质量控制。 \n- 取值范围：\n0: 不进行控制。\n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。\n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。\n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。\n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。\n- 默认 0。 \n- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
           "example": "0",
           "member": "uint64",
           "name": "QualityControl",
@@ -4499,7 +4515,7 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "document": "是否开启图片旋转识别支持。\n- 取值范围：0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
           "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
@@ -4514,31 +4530,31 @@
       "members": [
         {
           "disabled": false,
-          "document": "给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸（Face），返回相似度最大的分数。\n\n不同算法版本返回的相似度分数不同。\n若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。\n2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。",
+          "document": "给定的人脸图片与 PersonId 对应人脸的相似度。\n- 若 PersonId 下有多张人脸（Face），返回相似度最大的分数。\n- 不同算法版本返回的相似度分数不同。\n- 若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。\n- 2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。",
           "example": "100",
           "member": "float",
           "name": "Score",
-          "required": true,
+          "output_required": true,
           "type": "float",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "是否为同一人判断，固定阈值分数为60分，若想更灵活地调整阈值可取Score参数返回进行判断",
+          "document": "是否为同一人判断，固定阈值分数为60分，若想更灵活地调整阈值可取Score参数返回进行判断。",
           "example": "1",
           "member": "bool",
           "name": "IsMatch",
-          "required": true,
+          "output_required": true,
           "type": "bool",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人脸识别所用的算法模型版本，是该 Person 所在的人员库的算法模型版本。在创建人员库时设置，详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)",
+          "document": "人脸识别所用的算法模型版本，是该 Person 所在的人员库的算法模型版本。\n- 在创建人员库时设置，详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)",
           "example": "3.0",
           "member": "string",
           "name": "FaceModelVersion",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
@@ -4557,7 +4573,7 @@
         {
           "disabled": false,
           "document": "待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。",
-          "example": "",
+          "example": "2001",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -4565,8 +4581,8 @@
         },
         {
           "disabled": false,
-          "document": "图片 base64 数据。\njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "",
+          "document": "图片 base64 数据。\n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -4574,8 +4590,8 @@
         },
         {
           "disabled": false,
-          "document": "图片的 Url \njpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。。\n 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "",
+          "document": "图片的 Url \n- jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。\n- 所有格式的图片短边像素不小于64。\n-  图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 \n- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n- 非腾讯云存储的Url速度和稳定性可能受一定影响。\n- 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
+          "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "Url",
           "required": false,
@@ -4583,8 +4599,8 @@
         },
         {
           "disabled": false,
-          "document": "图片质量控制。 \n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
-          "example": "",
+          "document": "图片质量控制。 \n- 取值范围：\n0: 不进行控制。\n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。\n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。\n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。\n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。\n- 默认 0。 \n- 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
+          "example": "0",
           "member": "uint64",
           "name": "QualityControl",
           "required": false,
@@ -4592,8 +4608,8 @@
         },
         {
           "disabled": false,
-          "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
-          "example": "",
+          "document": "是否开启图片旋转识别支持。\n- 取值范围：0为不开启，1为开启。\n- 默认为0。\n- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。\n- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
+          "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
           "required": false,
@@ -4608,27 +4624,30 @@
         {
           "disabled": false,
           "document": "给定的人脸照片与 PersonId 对应的相似度。若 PersonId 下有多张人脸（Face），会融合多张人脸信息进行验证。",
-          "example": "",
+          "example": "100",
           "member": "float",
           "name": "Score",
+          "output_required": true,
           "type": "float",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "是否为同一人的判断。",
-          "example": "",
+          "example": "false",
           "member": "bool",
           "name": "IsMatch",
+          "output_required": true,
           "type": "bool",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "人脸识别所用的算法模型版本，是该 Person 所在的人员库的算法模型版本。在创建人员库时设置，详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)",
-          "example": "",
+          "document": "人脸识别所用的算法模型版本，是该 Person 所在的人员库的算法模型版本。\n- 在创建人员库时设置，详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)",
+          "example": "3.0",
           "member": "string",
           "name": "FaceModelVersion",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },