tccli 3.0.1391.1__py2.py3-none-any.whl → 3.0.1414.1__py2.py3-none-any.whl

tccli/services/iai/v20180301/api.json

@@ -57,9 +57,9 @@
       "status": "online"
     },
     "DeleteGroup": {
-      "document": "删除该人员库及包含的所有的人员。同时，人员对应的所有人脸信息将被删除。若某人员同时存在多个人员库中，该人员不会被删除，但属于该人员库中的自定义描述字段信息会被删除，属于其他人员库的自定义描述字段信息不受影响。\n",
+      "document": "删除该人员库及包含的所有的人员。同时，人员对应的所有人脸信息将被删除。若某人员同时存在多个人员库中，该人员不会被删除，但属于该人员库中的自定义描述字段信息会被删除，属于其他人员库的自定义描述字段信息不受影响。",
       "input": "DeleteGroupRequest",
-      "name": "删除人员库",
+      "name": "人员库删除",
       "output": "DeleteGroupResponse",
       "status": "online"
     },
@@ -129,7 +129,7 @@
     "GetPersonList": {
       "document": "获取指定人员库中的人员列表。",
       "input": "GetPersonListRequest",
-      "name": "获取人员列表",
+      "name": "人员列表",
       "output": "GetPersonListResponse",
       "status": "online"
     },
@@ -709,7 +709,7 @@
         {
           "disabled": false,
           "document": "图片 base64 数据，base64 编码后大小不可超过5M。\n人员人脸总数量不可超过5张。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "example": "[\"/9j/4AAQSkZJRg.....s97n//2Q==\"]",
           "member": "string",
           "name": "Images",
           "required": false,
@@ -727,7 +727,7 @@
         {
           "disabled": false,
           "document": "只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸，才能增加人脸成功。 \n默认值60分。取值范围[0,100] 。",
-          "example": "60",
+          "example": "60.0",
           "member": "float",
           "name": "FaceMatchThreshold",
           "required": false,
@@ -790,7 +790,7 @@
         {
           "disabled": false,
           "document": "加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。 \n例， Urls 中 有 3 个 url，第二个 url 失败，则 SucIndexes 值为 [0,2] 。",
-          "example": "无",
+          "example": "[0]",
           "member": "uint64",
           "name": "SucIndexes",
           "output_required": true,
@@ -810,7 +810,7 @@
         {
           "disabled": false,
           "document": "人脸识别所用的算法模型版本。",
-          "example": "无",
+          "example": "\"3.0\"",
           "member": "string",
           "name": "FaceModelVersion",
           "output_required": true,
@@ -1109,7 +1109,7 @@
         {
           "disabled": false,
           "document": "人员库ID。",
-          "example": "",
+          "example": "ZhuYuanDormitoryNo1",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -1199,180 +1199,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": "853",
           "member": "int64",
           "name": "Width",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人脸框高度。",
-          "example": "",
+          "example": "468",
           "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
         }
@@ -1784,7 +1784,7 @@
         {
           "disabled": false,
           "document": "性别[0~49]为女性，[50，100]为男性，越接近0和100表示置信度越高。NeedFaceAttributes 不为 1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "example": "40",
           "member": "int64",
           "name": "Gender",
           "output_required": true,
@@ -1794,7 +1794,7 @@
         {
           "disabled": false,
           "document": "年龄 [0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "example": "39",
           "member": "int64",
           "name": "Age",
           "output_required": true,
@@ -1804,7 +1804,7 @@
         {
           "disabled": false,
           "document": "微笑[0(normal，正常))~100(laugh，大笑)]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "example": "13",
           "member": "int64",
           "name": "Expression",
           "output_required": true,
@@ -1814,7 +1814,7 @@
         {
           "disabled": false,
           "document": "是否有眼镜 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "example": "true",
           "member": "bool",
           "name": "Glass",
           "output_required": true,
@@ -1824,7 +1824,7 @@
         {
           "disabled": false,
           "document": "上下偏移[-30,30]，单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。 \n建议：人脸入库选择[-10,10]的图片。",
-          "example": "无",
+          "example": "13",
           "member": "int64",
           "name": "Pitch",
           "output_required": true,
@@ -1834,7 +1834,7 @@
         {
           "disabled": false,
           "document": "左右偏移[-30,30]，单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。 \n建议：人脸入库选择[-10,10]的图片。",
-          "example": "无",
+          "example": "21",
           "member": "int64",
           "name": "Yaw",
           "output_required": true,
@@ -1844,7 +1844,7 @@
         {
           "disabled": false,
           "document": "平面旋转[-180,180]，单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。  \n建议：人脸入库选择[-20,20]的图片。",
-          "example": "无",
+          "example": "54",
           "member": "int64",
           "name": "Roll",
           "output_required": true,
@@ -1854,7 +1854,7 @@
         {
           "disabled": false,
           "document": "魅力[0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。",
-          "example": "无",
+          "example": "50",
           "member": "int64",
           "name": "Beauty",
           "output_required": true,
@@ -1864,7 +1864,7 @@
         {
           "disabled": false,
           "document": "是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "无",
+          "example": "true",
           "member": "bool",
           "name": "Hat",
           "output_required": true,
@@ -1874,7 +1874,7 @@
         {
           "disabled": false,
           "document": "是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "无",
+          "example": "true",
           "member": "bool",
           "name": "Mask",
           "output_required": true,
@@ -1894,7 +1894,7 @@
         {
           "disabled": false,
           "document": "双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼，就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时，此参数仍返回，但不具备参考意义。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "无",
+          "example": "true",
           "member": "bool",
           "name": "EyeOpen",
           "output_required": true,
@@ -2102,30 +2102,30 @@
         {
           "disabled": false,
           "document": "0：光头，1：短发，2：中发，3：长发，4：绑发\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "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": "",
+          "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": "",
+          "example": "1",
           "member": "int64",
           "name": "Color",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         }
@@ -2138,60 +2138,60 @@
         {
           "disabled": false,
           "document": "人脸框左上角横坐标。\n人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 \n若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。",
-          "example": "",
+          "example": "35",
           "member": "int64",
           "name": "X",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人脸框左上角纵坐标。 \n人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 \n若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。",
-          "example": "",
+          "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": "",
+          "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": "",
+          "example": "无",
           "member": "FaceQualityInfo",
           "name": "FaceQualityInfo",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": true
         }
@@ -2204,60 +2204,60 @@
         {
           "disabled": false,
           "document": "眉毛的遮挡分数[0,100]，分数越高遮挡越少。 \n参考范围：[0,80]表示发生遮挡。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "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": "",
+          "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": "",
+          "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": "",
+          "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": "",
+          "example": "20",
           "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": "",
+          "example": "10",
           "member": "int64",
           "name": "Chin",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         }
@@ -2270,40 +2270,40 @@
         {
           "disabled": false,
           "document": "质量分: [0,100]，综合评价图像质量是否适合人脸识别，分数越高质量越好。 \n正常情况，只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。\n参考范围：[0,40]较差，[40,60] 一般，[60,80]较好，[80,100]很好。 \n建议：人脸入库选取70以上的图片。\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "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": "",
+          "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": "",
+          "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
         }
@@ -2462,7 +2462,7 @@
         {
           "disabled": false,
           "document": "人员库 ID。",
-          "example": "",
+          "example": "\"31\"",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -2477,54 +2477,60 @@
         {
           "disabled": false,
           "document": "人员库名称",
-          "example": "",
+          "example": "人员库",
           "member": "string",
           "name": "GroupName",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人员库ID",
-          "example": "",
+          "example": "\"31\"",
           "member": "string",
           "name": "GroupId",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人员库自定义描述字段",
-          "example": "",
+          "example": "[\"年龄\"]",
           "member": "string",
           "name": "GroupExDescriptions",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人员库信息备注",
-          "example": "",
+          "example": "\"不含实习生\"",
           "member": "string",
           "name": "Tag",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人脸识别所用的算法模型版本。",
-          "example": "",
+          "example": "\"3.0\"",
           "member": "string",
           "name": "FaceModelVersion",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。",
-          "example": "",
+          "example": "1559530931613",
           "member": "uint64",
           "name": "CreationTimestamp",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -2599,7 +2605,7 @@
         {
           "disabled": false,
           "document": "人员ID",
-          "example": "",
+          "example": "\"1001\"",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -2614,27 +2620,30 @@
         {
           "disabled": false,
           "document": "人员名称",
-          "example": "",
+          "example": "\"EvanLiao\"",
           "member": "string",
           "name": "PersonName",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人员性别",
-          "example": "",
+          "example": "1",
           "member": "int64",
           "name": "Gender",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "包含的人脸 ID 列表",
-          "example": "",
+          "example": "[\"2873640802022644880\",\"2875186538564559728\"]",
           "member": "string",
           "name": "FaceIds",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
@@ -2653,7 +2662,7 @@
         {
           "disabled": false,
           "document": "人员ID",
-          "example": "",
+          "example": "1002",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -2662,7 +2671,7 @@
         {
           "disabled": false,
           "document": "起始序号，默认值为0",
-          "example": "",
+          "example": "0",
           "member": "uint64",
           "name": "Offset",
           "required": false,
@@ -2671,7 +2680,7 @@
         {
           "disabled": false,
           "document": "返回数量，默认值为10，最大值为100",
-          "example": "",
+          "example": "10",
           "member": "uint64",
           "name": "Limit",
           "required": false,
@@ -2686,27 +2695,30 @@
         {
           "disabled": false,
           "document": "包含此人员的人员库及描述字段内容列表",
-          "example": "",
+          "example": "无",
           "member": "PersonGroupInfo",
           "name": "PersonGroupInfos",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人员库总数量\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "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
         },
@@ -2725,7 +2737,7 @@
         {
           "disabled": false,
           "document": "人员库ID",
-          "example": "",
+          "example": "TencentShenZhenEmployee",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -2740,18 +2752,20 @@
         {
           "disabled": false,
           "document": "人员数量",
-          "example": "",
+          "example": "10",
           "member": "uint64",
           "name": "PersonNum",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人脸数量",
-          "example": "",
+          "example": "10",
           "member": "uint64",
           "name": "FaceNum",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -2770,7 +2784,7 @@
         {
           "disabled": false,
           "document": "人员库ID",
-          "example": "",
+          "example": "ZhuYuanDormitory",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -2779,7 +2793,7 @@
         {
           "disabled": false,
           "document": "起始序号，默认值为0",
-          "example": "",
+          "example": "0",
           "member": "uint64",
           "name": "Offset",
           "required": false,
@@ -2788,7 +2802,7 @@
         {
           "disabled": false,
           "document": "返回数量，默认值为10，最大值为1000",
-          "example": "",
+          "example": "10",
           "member": "uint64",
           "name": "Limit",
           "required": false,
@@ -2803,36 +2817,40 @@
         {
           "disabled": false,
           "document": "返回的人员信息",
-          "example": "",
+          "example": "无",
           "member": "PersonInfo",
           "name": "PersonInfos",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "该人员库的人员数量\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "example": "20",
           "member": "uint64",
           "name": "PersonNum",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         },
         {
           "disabled": false,
           "document": "该人员库的人脸数量\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "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
         },
@@ -3012,20 +3030,20 @@
         {
           "disabled": false,
           "document": "人员库ID 。",
-          "example": "",
+          "example": "1001",
           "member": "string",
           "name": "GroupId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "识别出的最相似候选人。",
-          "example": "",
+          "example": "无",
           "member": "Candidate",
           "name": "Candidates",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         }
@@ -3038,22 +3056,20 @@
         {
           "disabled": false,
           "document": "人员库自定义描述字段Index，从0开始",
-          "example": "",
+          "example": "0",
           "member": "uint64",
           "name": "GroupExDescriptionIndex",
           "required": true,
-          "type": "int",
-          "value_allowed_null": true
+          "type": "int"
         },
         {
           "disabled": false,
           "document": "需要更新的人员库自定义描述字段内容",
-          "example": "",
+          "example": "年龄",
           "member": "string",
           "name": "GroupExDescription",
           "required": true,
-          "type": "string",
-          "value_allowed_null": false
+          "type": "string"
         }
       ],
       "usage": "in"
@@ -3064,60 +3080,60 @@
         {
           "disabled": false,
           "document": "人员库名称",
-          "example": "",
+          "example": "人员库",
           "member": "string",
           "name": "GroupName",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人员库ID",
-          "example": "",
+          "example": "13",
           "member": "string",
           "name": "GroupId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人员库自定义描述字段\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "example": "[\"年龄\"]",
           "member": "string",
           "name": "GroupExDescriptions",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": true
         },
         {
           "disabled": false,
           "document": "人员库信息备注\n注意：此字段可能返回 null，表示取不到有效值。",
-          "example": "",
+          "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": "",
+          "example": "1694139227378",
           "member": "uint64",
           "name": "CreationTimestamp",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": true
         }
@@ -3228,7 +3244,7 @@
         {
           "disabled": false,
           "document": "人员库ID",
-          "example": "",
+          "example": "\"32\"",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -3237,7 +3253,7 @@
         {
           "disabled": false,
           "document": "人员库名称",
-          "example": "",
+          "example": "人员库名单",
           "member": "string",
           "name": "GroupName",
           "required": false,
@@ -3246,7 +3262,7 @@
         {
           "disabled": false,
           "document": "需要修改的人员库自定义描述字段，key-value",
-          "example": "",
+          "example": "无",
           "member": "GroupExDescriptionInfo",
           "name": "GroupExDescriptionInfos",
           "required": false,
@@ -3255,7 +3271,7 @@
         {
           "disabled": false,
           "document": "人员库信息备注",
-          "example": "",
+          "example": "无实习生",
           "member": "string",
           "name": "Tag",
           "required": false,
@@ -3282,7 +3298,7 @@
         {
           "disabled": false,
           "document": "人员ID",
-          "example": "",
+          "example": "2001",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -3291,7 +3307,7 @@
         {
           "disabled": false,
           "document": "需要修改的人员名称",
-          "example": "",
+          "example": "韦小宝",
           "member": "string",
           "name": "PersonName",
           "required": false,
@@ -3300,7 +3316,7 @@
         {
           "disabled": false,
           "document": "需要修改的人员性别",
-          "example": "",
+          "example": "1",
           "member": "int64",
           "name": "Gender",
           "required": false,
@@ -3327,7 +3343,7 @@
         {
           "disabled": false,
           "document": "人员库ID",
-          "example": "",
+          "example": "TencentShenZhenEmployee",
           "member": "string",
           "name": "GroupId",
           "required": true,
@@ -3336,7 +3352,7 @@
         {
           "disabled": false,
           "document": "人员ID",
-          "example": "",
+          "example": "1001",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -3345,7 +3361,7 @@
         {
           "disabled": false,
           "document": "需要修改的人员描述字段内容，key-value",
-          "example": "",
+          "example": "无",
           "member": "PersonExDescriptionInfo",
           "name": "PersonExDescriptionInfos",
           "required": true,
@@ -3388,22 +3404,20 @@
         {
           "disabled": false,
           "document": "人员描述字段Index，从0开始",
-          "example": "",
+          "example": "0",
           "member": "uint64",
           "name": "PersonExDescriptionIndex",
           "required": true,
-          "type": "int",
-          "value_allowed_null": true
+          "type": "int"
         },
         {
           "disabled": false,
           "document": "需要更新的人员描述字段内容",
-          "example": "",
+          "example": "年龄",
           "member": "string",
           "name": "PersonExDescription",
           "required": true,
-          "type": "string",
-          "value_allowed_null": false
+          "type": "string"
         }
       ],
       "usage": "in"
@@ -3440,60 +3454,60 @@
         {
           "disabled": false,
           "document": "人员名称",
-          "example": "",
+          "example": "韦小宝",
           "member": "string",
           "name": "PersonName",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人员Id",
-          "example": "",
+          "example": "1001",
           "member": "string",
           "name": "PersonId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人员性别",
-          "example": "",
+          "example": "0",
           "member": "int64",
           "name": "Gender",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人员描述字段内容",
-          "example": "",
+          "example": "[\"年龄\"]",
           "member": "string",
           "name": "PersonExDescriptions",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "包含的人脸照片列表",
-          "example": "",
+          "example": "[\"2877244861637985315\"]",
           "member": "string",
           "name": "FaceIds",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。 \nUnix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。有关更多信息，请参阅 Unix 时间。",
-          "example": "",
+          "example": "1594642823572",
           "member": "uint64",
           "name": "CreationTimestamp",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         }
@@ -3563,35 +3577,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": "",
+          "example": "0",
           "member": "int64",
           "name": "RetCode",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         }
@@ -3703,7 +3717,7 @@
         {
           "disabled": false,
           "document": "出参Score中，只有超过FaceMatchThreshold值的结果才会返回。默认为0。",
-          "example": "0",
+          "example": "30.0",
           "member": "float",
           "name": "FaceMatchThreshold",
           "required": false,
@@ -3747,7 +3761,7 @@
         {
           "disabled": false,
           "document": "人脸识别所用的算法模型版本。",
-          "example": "无",
+          "example": "\"3.0\"",
           "member": "string",
           "name": "FaceModelVersion",
           "output_required": true,
@@ -4045,7 +4059,7 @@
         {
           "disabled": false,
           "document": "希望搜索的人员库列表，上限60个。",
-          "example": "",
+          "example": "[\"TencentShenZhenEmployee\"]",
           "member": "string",
           "name": "GroupIds",
           "required": true,
@@ -4054,7 +4068,7 @@
         {
           "disabled": false,
           "document": "图片 base64 数据，base64 编码后大小不可超过5M。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -4063,7 +4077,7 @@
         {
           "disabled": false,
           "document": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。\nUrl、Image必须提供一个，如果都提供，只使用 Url。\n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。\n非腾讯云存储的Url速度和稳定性可能受一定影响。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "",
+          "example": "http://test.image.myqcloud.com/testB.jpg",
           "member": "string",
           "name": "Url",
           "required": false,
@@ -4072,7 +4086,7 @@
         {
           "disabled": false,
           "document": "最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。\nMaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。\n例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
-          "example": "",
+          "example": "1",
           "member": "uint64",
           "name": "MaxFaceNum",
           "required": false,
@@ -4081,7 +4095,7 @@
         {
           "disabled": false,
           "document": "人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。",
-          "example": "",
+          "example": "80",
           "member": "uint64",
           "name": "MinFaceSize",
           "required": false,
@@ -4090,7 +4104,7 @@
         {
           "disabled": false,
           "document": "被检测到的人脸，对应最多返回的最相似人员数目。默认值为5，最大值为10。  \n例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。",
-          "example": "",
+          "example": "5",
           "member": "uint64",
           "name": "MaxPersonNumPerGroup",
           "required": false,
@@ -4099,7 +4113,7 @@
         {
           "disabled": false,
           "document": "图片质量控制。 \n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
-          "example": "",
+          "example": "0",
           "member": "uint64",
           "name": "QualityControl",
           "required": false,
@@ -4108,7 +4122,7 @@
         {
           "disabled": false,
           "document": "出参Score中，只有超过FaceMatchThreshold值的结果才会返回。默认为0。",
-          "example": "",
+          "example": "0.0",
           "member": "float",
           "name": "FaceMatchThreshold",
           "required": false,
@@ -4117,7 +4131,7 @@
         {
           "disabled": false,
           "document": "是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0",
-          "example": "",
+          "example": "0",
           "member": "int64",
           "name": "NeedPersonInfo",
           "required": false,
@@ -4126,7 +4140,7 @@
         {
           "disabled": false,
           "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
-          "example": "",
+          "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
           "required": false,
@@ -4141,27 +4155,30 @@
         {
           "disabled": false,
           "document": "搜索的人员库中包含的人员数。若输入图片中所有人脸均不符合质量要求，则返回0。",
-          "example": "",
+          "example": "10",
           "member": "uint64",
           "name": "PersonNum",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "识别结果。",
-          "example": "",
+          "example": "无",
           "member": "ResultsReturnsByGroup",
           "name": "ResultsReturnsByGroup",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "人脸识别所用的算法模型版本。",
-          "example": "",
+          "example": "\"3.0\"",
           "member": "string",
           "name": "FaceModelVersion",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
@@ -4292,7 +4309,7 @@
         {
           "disabled": false,
           "document": "待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。",
-          "example": "11111111",
+          "example": "1001",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -4301,7 +4318,7 @@
         {
           "disabled": false,
           "document": "图片 base64 数据，base64 编码后大小不可超过5M。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "无",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -4343,20 +4360,20 @@
         {
           "disabled": false,
           "document": "给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸（Face），返回相似度最大的分数。\n\n不同算法版本返回的相似度分数不同。\n若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。\n2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。",
-          "example": "100",
+          "example": "100.0",
           "member": "float",
           "name": "Score",
-          "required": true,
+          "output_required": true,
           "type": "float",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "是否为同一人判断，固定阈值分数为60分，若想更灵活地调整阈值可取Score参数返回进行判断",
-          "example": "1",
+          "example": "true",
           "member": "bool",
           "name": "IsMatch",
-          "required": true,
+          "output_required": true,
           "type": "bool",
           "value_allowed_null": false
         },
@@ -4366,7 +4383,7 @@
           "example": "3.0",
           "member": "string",
           "name": "FaceModelVersion",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
@@ -4385,7 +4402,7 @@
         {
           "disabled": false,
           "document": "待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。",
-          "example": "",
+          "example": "2001",
           "member": "string",
           "name": "PersonId",
           "required": true,
@@ -4394,7 +4411,7 @@
         {
           "disabled": false,
           "document": "图片 base64 数据。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "",
+          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
           "member": "string",
           "name": "Image",
           "required": false,
@@ -4403,7 +4420,7 @@
         {
           "disabled": false,
           "document": "图片的 Url 。 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 \n图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 \n非腾讯云存储的Url速度和稳定性可能受一定影响。\n若图片中包含多张人脸，只选取其中人脸面积最大的人脸。\n支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
-          "example": "",
+          "example": "http://test.image.myqcloud.com/testA.jpg",
           "member": "string",
           "name": "Url",
           "required": false,
@@ -4412,7 +4429,7 @@
         {
           "disabled": false,
           "document": "图片质量控制。 \n0: 不进行控制； \n1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； \n2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； \n3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； \n4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； \n默认 0。 \n若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。",
-          "example": "",
+          "example": "0",
           "member": "uint64",
           "name": "QualityControl",
           "required": false,
@@ -4421,7 +4438,7 @@
         {
           "disabled": false,
           "document": "是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
-          "example": "",
+          "example": "0",
           "member": "uint64",
           "name": "NeedRotateDetection",
           "required": false,
@@ -4436,27 +4453,30 @@
         {
           "disabled": false,
           "document": "给定的人脸照片与 PersonId 对应的相似度。若 PersonId 下有多张人脸（Face），会融合多张人脸信息进行验证。",
-          "example": "",
+          "example": "100.0",
           "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": "人脸识别所用的算法模型版本。",
-          "example": "",
+          "example": "\"3.0\"",
           "member": "string",
           "name": "FaceModelVersion",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },