{
  "name": "iai",
  "display_name": "人脸识别",
  "description": "腾讯云神图·人脸识别（Face Recognition）基于腾讯优图强大的面部分析技术，提供包括人脸检测与分析、比对、搜索、验证、五官定位、活体检测等多种功能，为开发者和企业提供高性能高可用的人脸识别服务。 本章节主要介绍介绍API调用方式、以及如何通过API 接入人脸检测与分析相、五官定位、人员库管理、人脸搜索、人脸验证、人脸静态活体检测（高精度版）等产品。",
  "domain": "ai",
  "api_version": "2020-03-03",
  "endpoint": "iai.tencentcloudapi.com",
  "actions": [
    {
      "name": "AnalyzeDenseLandmarks",
      "description": "对请求图片进行五官定位（也称人脸关键点定位），获得人脸的精准信息，返回多达888点关键信息，对五官和脸部轮廓进行精确定位。",
      "status": "online",
      "parameters": [
        {
          "name": "Mode",
          "type": "integer",
          "required": false,
          "description": "检测模式。 - 取值范围：0 为检测所有出现的人脸， 1 为检测面积最大的人脸。 - 默认为 0。 - 最多返回 5 张人脸的五官定位（人脸关键点）具体信息。",
          "example": "0"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持 GI...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "FaceModelVersion",
          "type": "string",
          "required": false,
          "description": "人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。",
          "example": "3.0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        }
      ],
      "required": []
    },
    {
      "name": "AnalyzeFace",
      "description": "对请求图片进行五官定位（也称人脸关键点定位），计算构成人脸轮廓的 90 个点，包括眉毛（左右各 8 点）、眼睛（左右各 8 点）、鼻子（13 点）、嘴巴（22 点）、脸型轮廓（21 点）、眼珠[或瞳孔]（2点）。 \u003e - 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。",
      "status": "online",
      "parameters": [
        {
          "name": "Mode",
          "type": "integer",
          "required": false,
          "description": "检测模式。 - 取值范围： 0 为检测所有出现的人脸。 1 为检测面积最大的人脸。 - 默认为 0。 - 最多返回 10 张人脸的五官定位（人脸关键点）具体信息。",
          "example": "0"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持 GI...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "FaceModelVersion",
          "type": "string",
          "required": false,
          "description": "人脸识别服务所用的算法模型版本。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
          "example": "3.0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        }
      ],
      "required": []
    },
    {
      "name": "CompareFace",
      "description": "对两张图片中的人脸进行相似度比对，返回人脸相似度分数。 若您需要判断 “此人是否是某人”，即验证某张图片中的人是否是已知身份的某人，如常见的人脸登录场景，建议使用[人脸验证](https://cloud.tencent.com/document/product/867/44983)或[人员验证](https://cloud.tencent.com/document/product/867/44982)接口。 \u003e - 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。",
      "status": "online",
      "parameters": [
        {
          "name": "ImageA",
          "type": "string",
          "required": false,
          "description": "A 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - 若图片中包含多张人脸，只选取其中置信度最高的人脸。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "ImageB",
          "type": "string",
          "required": false,
          "description": "B 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - 若图片中包含多张人脸，只选取其中置信度最高的人脸。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "UrlA",
          "type": "string",
          "required": false,
          "description": "A 图片的 Url。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - A 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 若图片中包含多张人脸...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "UrlB",
          "type": "string",
          "required": false,
          "description": "B 图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - B 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 若图片中包含多张人\ufffd\ufffd...",
          "example": "http://test.image.myqcloud.com/testB.jpg"
        },
        {
          "name": "FaceModelVersion",
          "type": "string",
          "required": false,
          "description": "人脸识别服务所用的算法模型版本。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
          "example": "3.0"
        },
        {
          "name": "QualityControl",
          "type": "integer",
          "required": false,
          "description": "图片质量控制。 - 取值范围： 0: 不进行控制； 1: 较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质...",
          "example": "0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        },
        {
          "name": "FaceMatchingStrategy",
          "type": "integer",
          "required": false,
          "description": "若图片中包含多张人脸，指定选取策略，默认为0。 - 0：选取其中置信度最高的人脸 - 1：选取其中面积最大的人脸。",
          "example": "0"
        }
      ],
      "required": []
    },
    {
      "name": "CompareMaskFace",
      "description": "对两张图片中的人脸进行相似度比对，返回人脸相似度分数。 防疫场景人脸比对接口可在人脸戴口罩情况下使用，口罩遮挡程度最高可以遮挡鼻尖。 如图片人脸不存在防疫场景下戴口罩的情况，建议使用人脸比对服务。",
      "status": "online",
      "parameters": [
        {
          "name": "ImageA",
          "type": "string",
          "required": false,
          "description": "A 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "ImageB",
          "type": "string",
          "required": false,
          "description": "B 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "UrlA",
          "type": "string",
          "required": false,
          "description": "A 图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - A 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 若图片中包含多张人\ufffd\ufffd...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "UrlB",
          "type": "string",
          "required": false,
          "description": "B 图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - B 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 若图片中包含多张人\ufffd\ufffd...",
          "example": "http://test.image.myqcloud.com/testB.jpg"
        },
        {
          "name": "FaceModelVersion",
          "type": "string",
          "required": false,
          "description": "人脸识别服务所用的算法模型版本。该接口只支持\"3.0\"",
          "example": "3.0"
        },
        {
          "name": "QualityControl",
          "type": "integer",
          "required": false,
          "description": "图片质量控制。 - 取值范围： 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质\ufffd...",
          "example": "0"
        }
      ],
      "required": []
    },
    {
      "name": "CopyPerson",
      "description": "将已存在于某人员库的人员复制到其他人员库，该人员的描述信息不会被复制。单个人员最多只能同时存在100个人员库中。 \u003e - 注：若该人员创建时算法模型版本为2.0，复制到非2.0算法模型版本的Group中时，复制操作将会失败。",
      "status": "online",
      "parameters": [
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "人员ID，取值为创建人员接口中的PersonId。",
          "example": "1001"
        },
        {
          "name": "GroupIds",
          "type": "array",
          "required": true,
          "description": "待加入的人员库列表，数组元素取值为创建人员库接口中的GroupId。",
          "example": "[\"TencentShenZhenEmployee\"]",
          "item_type": "string"
        }
      ],
      "required": [
        "PersonId",
        "GroupIds"
      ]
    },
    {
      "name": "CreateFace",
      "description": "将一组人脸图片添加到一个人员中。一个人员最多允许包含 5 张图片。若该人员存在多个人员库中，所有人员库中该人员图片均会增加。 \u003e - 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。",
      "status": "online",
      "parameters": [
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "人员ID，取值为创建人员接口中的PersonId。",
          "example": "1001"
        },
        {
          "name": "Images",
          "type": "array",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - 人员人脸总数量不可超过5张。 - 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q==",
          "item_type": "string"
        },
        {
          "name": "Urls",
          "type": "array",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持 GI...",
          "example": "[\"http://test.image.myqcloud.com/testA.jpg\"]",
          "item_type": "string"
        },
        {
          "name": "FaceMatchThreshold",
          "type": "float",
          "required": false,
          "description": "只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸，才能增加人脸成功。 - 默认值60分。 - 取值范围：[0,100] 。",
          "example": "60"
        },
        {
          "name": "QualityControl",
          "type": "integer",
          "required": false,
          "description": "图片质量控制。 - 取值范围： 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质\ufffd...",
          "example": "0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        }
      ],
      "required": [
        "PersonId"
      ]
    },
    {
      "name": "CreateGroup",
      "description": "用于创建一个空的人员库，如果人员库已存在返回错误。 可根据需要创建自定义描述字段，用于辅助描述该人员库下的人员信息。 1个APPID下最多创建10万个人员库（Group）、最多包含5000万张人脸（Face）。 不同算法模型版本（FaceModelVersion）的人员库（Group）最多可包含人脸（Face）数不同。算法模型版本为2.0的人员库最多包含100万张人脸，算法模型版本为3.0的人员库最多可包含3...",
      "status": "online",
      "parameters": [
        {
          "name": "GroupName",
          "type": "string",
          "required": true,
          "description": "人员库名称，[1,60]个字符，可修改，不可重复。",
          "example": "腾讯深圳员工库"
        },
        {
          "name": "GroupId",
          "type": "string",
          "required": true,
          "description": "人员库 ID，不可修改，不可重复。支持英文、数字、-%@#\u0026_，长度限制64B。",
          "example": "TencentShenZhenEmployee"
        },
        {
          "name": "GroupExDescriptions",
          "type": "array",
          "required": false,
          "description": "人员库自定义描述字段，用于描述人员库中人员属性，该人员库下所有人员将拥有此描述字段。 - 最多可以创建5个。 - 每个自定义描述字段支持[1,30]个字符。 - 在同一人员库中自定义描述字段不可重复。 - 例： 设置某人员库“自定义描述字段”为[\"学号\",\"工号\",\"手机号\"]， 则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段， 可在对应人员描述字段...",
          "example": "[\"学号\",\"工号\",\"手机号\"]",
          "item_type": "string"
        },
        {
          "name": "Tag",
          "type": "string",
          "required": false,
          "description": "人员库信息备注，[0，40]个字符。",
          "example": "不含实习生"
        },
        {
          "name": "FaceModelVersion",
          "type": "string",
          "required": false,
          "description": "人脸识别服务所用的算法模型版本。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
          "example": "3.0"
        }
      ],
      "required": [
        "GroupName",
        "GroupId"
      ]
    },
    {
      "name": "CreatePerson",
      "description": "创建人员，添加人脸、姓名、性别及其他相关信息。 \u003e - 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。",
      "status": "online",
      "parameters": [
        {
          "name": "GroupId",
          "type": "string",
          "required": true,
          "description": "待加入的人员库ID，取值为创建人员库接口中的GroupId。",
          "example": "78"
        },
        {
          "name": "PersonName",
          "type": "string",
          "required": true,
          "description": "人员名称。[1，60]个字符，可修改，可重复。",
          "example": "韦小宝"
        },
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "人员ID。 - 单个腾讯云账号下不可修改，不可重复。 - 支持英文、数字、-%@#\u0026_，长度限制64B。",
          "example": "2001"
        },
        {
          "name": "Gender",
          "type": "integer",
          "required": false,
          "description": "性别。 - 取值范围：0代表未填写，1代表男性，2代表女性。",
          "example": "1"
        },
        {
          "name": "PersonExDescriptionInfos",
          "type": "array",
          "required": false,
          "description": "人员描述字段内容，key-value。[0，60]个字符，可修改，可重复。",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "PersonExDescriptionIndex",
              "type": "integer",
              "required": true,
              "description": "人员描述字段Index，从0开始。",
              "example": "0"
            },
            {
              "name": "PersonExDescription",
              "type": "string",
              "required": true,
              "description": "需要更新的人员描述字段内容。",
              "example": "年龄"
            }
          ]
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持 GI...",
          "example": "http://test.image.myqcloud.com/testB.jpg"
        },
        {
          "name": "UniquePersonControl",
          "type": "integer",
          "required": false,
          "description": "此参数用于控制判断 Image 或 Url 中图片包含的人脸，是否在人员库中已有疑似的同一人。 - 如果判断为已有相同人在人员库中，则不会创建新的人员，返回疑似同一人的人员信息。 - 如果判断没有，则完成创建人员。 - 取值范围： 0: 不进行判断，无论是否有疑似同一人在库中均完成入库； 1:较低的同一人判断要求（百一误识别率）； 2: 一般的同一人判断要求（千一误识别率）...",
          "example": "0"
        },
        {
          "name": "QualityControl",
          "type": "integer",
          "required": false,
          "description": "图片质量控制。 - 取值范围： 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质\ufffd...",
          "example": "0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        }
      ],
      "required": [
        "GroupId",
        "PersonName",
        "PersonId"
      ]
    },
    {
      "name": "DeleteFace",
      "description": "删除一个人员下的人脸图片。如果该人员只有一张人脸图片，则返回错误。",
      "status": "online",
      "parameters": [
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "人员ID，取值为创建人员接口中的PersonId。",
          "example": "5001"
        },
        {
          "name": "FaceIds",
          "type": "array",
          "required": true,
          "description": "待删除的人脸ID列表，数组元素取值为增加人脸接口返回的FaceId。",
          "example": "[\"2875186538564559728\"]",
          "item_type": "string"
        }
      ],
      "required": [
        "PersonId",
        "FaceIds"
      ]
    },
    {
      "name": "DeleteGroup",
      "description": "删除该人员库及包含的所有的人员。同时，人员对应的所有人脸信息将被删除。若某人员同时存在多个人员库中，该人员不会被删除，但属于该人员库中的自定义描述字段信息会被删除，属于其他人员库的自定义描述字段信息不受影响。",
      "status": "online",
      "parameters": [
        {
          "name": "GroupId",
          "type": "string",
          "required": true,
          "description": "人员库ID，取值为创建人员库接口中的GroupId。",
          "example": "21"
        }
      ],
      "required": [
        "GroupId"
      ]
    },
    {
      "name": "DeletePerson",
      "description": "删除该人员信息，此操作会导致所有人员库均删除此人员。同时，该人员的所有人脸信息将被删除。",
      "status": "online",
      "parameters": [
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "人员ID，取值为创建人员接口中的PersonId。",
          "example": "3001"
        }
      ],
      "required": [
        "PersonId"
      ]
    },
    {
      "name": "DeletePersonFromGroup",
      "description": "从某人员库中删除人员，此操作仅影响该人员库。若该人员仅存在于指定的人员库中，该人员将被删除，其所有的人脸信息也将被删除。",
      "status": "online",
      "parameters": [
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "人员ID，取值为创建人员接口中的PersonId。",
          "example": "3001"
        },
        {
          "name": "GroupId",
          "type": "string",
          "required": true,
          "description": "人员库ID，取值为创建人员库接口中的GroupId。",
          "example": "ZhuYuanDormitoryNo1"
        }
      ],
      "required": [
        "PersonId",
        "GroupId"
      ]
    },
    {
      "name": "DetectFace",
      "description": "检测给定图片中的人脸（Face）的位置、相应的面部属性和人脸质量信息，位置包括 (x，y，w，h)，面部属性包括性别（gender）、年龄（age）、表情（expression）、魅力（beauty）、眼镜（glass）、发型（hair）、口罩（mask）和姿态 (pitch，roll，yaw)，人脸质量信息包括整体质量分（score）、模糊分（sharpness）、光照分（brightness）和五官遮挡分（completeness）。 其中，人脸质量信息主要用...",
      "status": "online",
      "parameters": [
        {
          "name": "MaxFaceNum",
          "type": "integer",
          "required": false,
          "description": "最多处理的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。",
          "example": "1"
        },
        {
          "name": "MinFaceSize",
          "type": "integer",
          "required": false,
          "description": "人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。 - 只支持设置34和20，建议使用34。",
          "example": "34"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持...",
          "example": "https://test.image.myqcloud.com/testB.jpg"
        },
        {
          "name": "NeedFaceAttributes",
          "type": "integer",
          "required": false,
          "description": "是否需要返回人脸属性信息（FaceAttributesInfo）。 - 0 为不需要返回，1 为需要返回。 - 默认为 0。 - 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。 - 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。",
          "example": "0"
        },
        {
          "name": "NeedQualityDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启质量检测。 - 0 为关闭，1 为开启。 - 默认为 0。 - 非 1 值均视为不进行质量检测。 - 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。 - 建议：人脸入库操作建议开启此功能。",
          "example": "0"
        },
        {
          "name": "FaceModelVersion",
          "type": "string",
          "required": false,
          "description": "人脸识别服务所用的算法模型版本。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。",
          "example": "3.0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        }
      ],
      "required": []
    },
    {
      "name": "DetectFaceAttributes",
      "description": "检测给定图片中的人脸（Face）的位置、相应的面部属性和人脸质量信息，位置包括 (x，y，w，h)，面部属性包括性别（gender）、年龄（age）、表情（expression）、魅力（beauty）、眼镜（glass）、发型（hair）、口罩（mask）和姿态 (pitch，roll，yaw)。 其中，人脸质量信息主要用于评价输入的人脸图片的质量。在使用人脸识别服务时，建议您对输入的人脸图片进行质量检测，提升后续业...",
      "status": "online",
      "parameters": [
        {
          "name": "MaxFaceNum",
          "type": "integer",
          "required": false,
          "description": "最多处理的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。",
          "example": "1"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持 GI...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "FaceAttributesType",
          "type": "string",
          "required": false,
          "description": "是否返回年龄、性别、情绪等属性。 - 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。 - None为不需要返回。 - 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。 - 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。 - 关于各属性的详细描述，参见下文出参。 - 最\ufffd...",
          "example": "eye"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        },
        {
          "name": "FaceModelVersion",
          "type": "string",
          "required": false,
          "description": "人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入",
          "example": "3.0"
        }
      ],
      "required": []
    },
    {
      "name": "DetectFaceSimilarity",
      "description": "对两张图片中的人脸进行相似度比对，返回人脸相似度分数。 若您需要判断 “此人是否是某人”，即验证某张图片中的人是否是已知身份的某人，如常见的人脸登录场景，建议使用[人脸验证](https://cloud.tencent.com/document/product/867/44983)或[人员验证](https://cloud.tencent.com/document/product/867/44982)接口。 \u003e - 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。",
      "status": "online",
      "parameters": [
        {
          "name": "ImageA",
          "type": "string",
          "required": false,
          "description": "A 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - 若图片中包含多张人脸，只选取其中置信度最高的人脸。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "ImageB",
          "type": "string",
          "required": false,
          "description": "B 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - 若图片中包含多张人脸，只选取其中置信度最高的人脸。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "UrlA",
          "type": "string",
          "required": false,
          "description": "A 图片的 Url。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - A 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 若图片中包含多张人脸...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "UrlB",
          "type": "string",
          "required": false,
          "description": "B 图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - B 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 若图片中包含多张人\ufffd\ufffd...",
          "example": "http://test.image.myqcloud.com/testB.jpg"
        },
        {
          "name": "QualityControl",
          "type": "integer",
          "required": false,
          "description": "图片质量控制。 - 取值范围： 0: 不进行控制； 1: 较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质...",
          "example": "0"
        }
      ],
      "required": []
    },
    {
      "name": "DetectLiveFaceAccurate",
      "description": "人脸静态活体检测（高精度版）可用于对用户上传的静态图片进行防翻拍活体检测，以判断是否是翻拍图片。 相比现有静态活体检测服务，高精度版在维持高真人通过率的前提下，增强了对高清屏幕、裁剪纸片、3D面具等攻击的防御能力，攻击拦截率约为业内同类型产品形态4-5倍。同时支持多场景人脸核验，满足移动端、PC端各类型场景的图片活体检验需求，适用于各个行业不...",
      "status": "online",
      "parameters": [
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 图片的宽高比请接近 3:4，手机拍摄比例最佳。 - 人脸尺寸大于100X100像素。 - 图片格式支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片的宽高比请接近 3:4，手机拍摄比例最佳。 - 人脸尺寸大于100X100像素。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影\ufffd...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "FaceModelVersion",
          "type": "string",
          "required": false,
          "description": "人脸识别服务所用的算法模型版本。目前入参支持“3.0“。",
          "example": "3.0"
        }
      ],
      "required": []
    },
    {
      "name": "GetGroupInfo",
      "description": "获取人员库信息。",
      "status": "online",
      "parameters": [
        {
          "name": "GroupId",
          "type": "string",
          "required": true,
          "description": "人员库 ID，取值为创建人员库接口中的GroupId。",
          "example": "32"
        }
      ],
      "required": [
        "GroupId"
      ]
    },
    {
      "name": "GetGroupList",
      "description": "获取人员库列表。",
      "status": "online",
      "parameters": [
        {
          "name": "Offset",
          "type": "integer",
          "required": false,
          "description": "起始序号，默认值为0",
          "example": "0"
        },
        {
          "name": "Limit",
          "type": "integer",
          "required": false,
          "description": "返回数量，默认值为10，最大值为1000",
          "example": "10"
        }
      ],
      "required": []
    },
    {
      "name": "GetPersonBaseInfo",
      "description": "获取指定人员的信息，包括姓名、性别、人脸等。",
      "status": "online",
      "parameters": [
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "人员ID，创建人员接口中的PersonId。",
          "example": "1002"
        }
      ],
      "required": [
        "PersonId"
      ]
    },
    {
      "name": "GetPersonGroupInfo",
      "description": "获取指定人员的信息，包括加入的人员库、描述内容等。",
      "status": "online",
      "parameters": [
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "人员ID，取值为创建人员接口中的PersonId。",
          "example": "1002"
        },
        {
          "name": "Offset",
          "type": "integer",
          "required": false,
          "description": "起始序号，默认值为0。",
          "example": "0"
        },
        {
          "name": "Limit",
          "type": "integer",
          "required": false,
          "description": "返回数量，默认值为10，最大值为100。",
          "example": "10"
        }
      ],
      "required": [
        "PersonId"
      ]
    },
    {
      "name": "GetPersonList",
      "description": "获取指定人员库中的人员列表。",
      "status": "online",
      "parameters": [
        {
          "name": "GroupId",
          "type": "string",
          "required": true,
          "description": "人员库ID，取值为创建人员库接口中的GroupId。",
          "example": "ZhuYuanDormitory"
        },
        {
          "name": "Offset",
          "type": "integer",
          "required": false,
          "description": "起始序号，默认值为0。",
          "example": "0"
        },
        {
          "name": "Limit",
          "type": "integer",
          "required": false,
          "description": "返回数量，默认值为10，最大值为1000。",
          "example": "10"
        }
      ],
      "required": [
        "GroupId"
      ]
    },
    {
      "name": "GetPersonListNum",
      "description": "获取指定人员库中人员数量。",
      "status": "online",
      "parameters": [
        {
          "name": "GroupId",
          "type": "string",
          "required": true,
          "description": "人员库ID，取值为创建人员库接口中的GroupId。",
          "example": "TencentShenZhenEmployee"
        }
      ],
      "required": [
        "GroupId"
      ]
    },
    {
      "name": "GetUpgradeGroupFaceModelVersionJobList",
      "description": "避免官网歧义 获取人员库升级任务列表",
      "status": "deprecated",
      "parameters": [
        {
          "name": "Offset",
          "type": "integer",
          "required": false,
          "description": "起始序号，默认值为0。"
        },
        {
          "name": "Limit",
          "type": "integer",
          "required": false,
          "description": "返回数量，默认值为10，最大值为1000。"
        }
      ],
      "required": []
    },
    {
      "name": "GetUpgradeGroupFaceModelVersionResult",
      "description": "避免官网歧义 人员库升级结果查询",
      "status": "deprecated",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": true,
          "description": "升级任务ID，用于查询、获取人员库升级的进度和结果。",
          "example": "251007453_upgrade_group_qta_1596529493_gjwh07X7"
        }
      ],
      "required": [
        "JobId"
      ]
    },
    {
      "name": "ModifyGroup",
      "description": "修改人员库名称、备注、自定义描述字段名称。",
      "status": "online",
      "parameters": [
        {
          "name": "GroupId",
          "type": "string",
          "required": true,
          "description": "人员库ID，取值为创建人员库接口中的GroupId。",
          "example": "32"
        },
        {
          "name": "GroupName",
          "type": "string",
          "required": false,
          "description": "人员库名称。",
          "example": "人员库名单"
        },
        {
          "name": "GroupExDescriptionInfos",
          "type": "array",
          "required": false,
          "description": "需要修改的人员库自定义描述字段，key-value。",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "GroupExDescriptionIndex",
              "type": "integer",
              "required": true,
              "description": "人员库自定义描述字段Index，从0开始。",
              "example": "3"
            },
            {
              "name": "GroupExDescription",
              "type": "string",
              "required": true,
              "description": "需要更新的人员库自定义描述字段内容。",
              "example": "年龄"
            }
          ]
        },
        {
          "name": "Tag",
          "type": "string",
          "required": false,
          "description": "人员库信息备注。",
          "example": "无实习生"
        }
      ],
      "required": [
        "GroupId"
      ]
    },
    {
      "name": "ModifyPersonBaseInfo",
      "description": "修改人员信息，包括名称、性别等。人员名称和性别修改会同步到包含该人员的所有人员库。",
      "status": "online",
      "parameters": [
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "人员ID，取值为创建人员接口中的PersonId。",
          "example": "2001"
        },
        {
          "name": "PersonName",
          "type": "string",
          "required": false,
          "description": "需要修改的人员名称。",
          "example": "韦小宝"
        },
        {
          "name": "Gender",
          "type": "integer",
          "required": false,
          "description": "需要修改的人员性别，1代表男性，2代表女性。",
          "example": "1"
        }
      ],
      "required": [
        "PersonId"
      ]
    },
    {
      "name": "ModifyPersonGroupInfo",
      "description": "修改指定人员库人员描述内容。",
      "status": "online",
      "parameters": [
        {
          "name": "GroupId",
          "type": "string",
          "required": true,
          "description": "人员库ID，取值为创建人员库接口中的GroupId。",
          "example": "TencentShenZhenEmployee"
        },
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "人员ID，取值为创建人员接口中的PersonId。",
          "example": "1001"
        },
        {
          "name": "PersonExDescriptionInfos",
          "type": "array",
          "required": true,
          "description": "需要修改的人员描述字段内容，key-value。",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "PersonExDescriptionIndex",
              "type": "integer",
              "required": true,
              "description": "人员描述字段Index，从0开始。",
              "example": "0"
            },
            {
              "name": "PersonExDescription",
              "type": "string",
              "required": true,
              "description": "需要更新的人员描述字段内容。",
              "example": "年龄"
            }
          ]
        }
      ],
      "required": [
        "GroupId",
        "PersonId",
        "PersonExDescriptionInfos"
      ]
    },
    {
      "name": "RevertGroupFaceModelVersion",
      "description": "同理 本接口用于回滚人员库的人脸识别算法模型版本。单个人员库有且仅有一次回滚机会。 回滚操作会在10s内生效，回滚操作中，您对人员库的操作可能会失效。",
      "status": "deprecated",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": true,
          "description": "需要回滚的升级任务ID。"
        }
      ],
      "required": [
        "JobId"
      ]
    },
    {
      "name": "SearchFaces",
      "description": "用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopK 人员，识别结果按照相似度从大到小排序。 支持一次性识别图片中的最多 10 张人脸，支持一次性跨 100 个人员库（Group）搜索。 单次搜索的人员库人脸总数量和人员库的算法模型版本（FaceModelVersion）相关。算法模型版本为2.0的人员库，单次搜索人员库人脸总数量不得超过 100 万张；算法模型版本为3.0的\ufffd...",
      "status": "online",
      "parameters": [
        {
          "name": "GroupIds",
          "type": "array",
          "required": true,
          "description": "希望搜索的人员库列表，上限100个。 - 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。",
          "example": "[\"TencentShenZhenEmployee\"]",
          "item_type": "string"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "MaxFaceNum",
          "type": "integer",
          "required": false,
          "description": "最多识别的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例如：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
          "example": "1"
        },
        {
          "name": "MinFaceSize",
          "type": "integer",
          "required": false,
          "description": "人脸长和宽的最小尺寸，单位为像素。 - 默认为34。 - 低于34的人脸图片无法被识别。 - 建议设置为80。",
          "example": "40"
        },
        {
          "name": "MaxPersonNum",
          "type": "integer",
          "required": false,
          "description": "单张被识别的人脸返回的最相似人员数量。 - 默认值为5，最大值为100。 - 例如，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。 - 值越大，需要处理的时间越长。 - 建议不要超过10。",
          "example": "5"
        },
        {
          "name": "NeedPersonInfo",
          "type": "integer",
          "required": false,
          "description": "是否返回人员具体信息。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0。",
          "example": "0"
        },
        {
          "name": "QualityControl",
          "type": "integer",
          "required": false,
          "description": "图片质量控制。 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质\ufffd...",
          "example": "0"
        },
        {
          "name": "FaceMatchThreshold",
          "type": "float",
          "required": false,
          "description": "出参Score中，只有超过FaceMatchThreshold值的结果才会返回。默认为0。",
          "example": "0.0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        }
      ],
      "required": [
        "GroupIds"
      ]
    },
    {
      "name": "SearchFacesReturnsByGroup",
      "description": "用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopK 人员，按照**人员库的维度**以人员相似度从大到小顺序排列。 支持一次性识别图片中的最多 10 张人脸，支持跨人员库（Group）搜索。 单次搜索的人员库人脸总数量和人员库的算法模型版本（FaceModelVersion）相关。算法模型版本为2.0的人员库，单次搜索人员库人脸总数量不得超过 100 万张；算法模型版本\ufffd\ufffd...",
      "status": "online",
      "parameters": [
        {
          "name": "GroupIds",
          "type": "array",
          "required": true,
          "description": "希望搜索的人员库列表，上限60个。 - 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。",
          "example": "[\"TencentShenZhenEmployee\\n\"]",
          "item_type": "string"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "MaxFaceNum",
          "type": "integer",
          "required": false,
          "description": "最多识别的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
          "example": "1"
        },
        {
          "name": "MinFaceSize",
          "type": "integer",
          "required": false,
          "description": "人脸长和宽的最小尺寸，单位为像素。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。",
          "example": "40"
        },
        {
          "name": "MaxPersonNumPerGroup",
          "type": "integer",
          "required": false,
          "description": "被检测到的人脸，对应最多返回的最相似人员数目。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。",
          "example": "5"
        },
        {
          "name": "NeedPersonInfo",
          "type": "integer",
          "required": false,
          "description": "是否返回人员具体信息。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0",
          "example": "0"
        },
        {
          "name": "QualityControl",
          "type": "integer",
          "required": false,
          "description": "图片质量控制。 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质\ufffd...",
          "example": "0"
        },
        {
          "name": "FaceMatchThreshold",
          "type": "float",
          "required": false,
          "description": "出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。 - 默认为0。 - 取值范围：[0.0,100.0) 。",
          "example": "0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        }
      ],
      "required": [
        "GroupIds"
      ]
    },
    {
      "name": "SearchPersons",
      "description": "用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopK 人员，按照相似度从大到小排列。 支持一次性识别图片中的最多 10 张人脸，支持一次性跨 100 个人员库（Group）搜索。 单次搜索的人员库人脸总数量和人员库的算法模型版本（FaceModelVersion）相关。算法模型版本为2.0的人员库，单次搜索人员库人脸总数量不得超过 100 万张；算法模型版本为3.0的人员库，\ufffd...",
      "status": "online",
      "parameters": [
        {
          "name": "GroupIds",
          "type": "array",
          "required": true,
          "description": "希望搜索的人员库列表，上限100个。数组元素取值为创建人员库接口中的GroupId。",
          "example": "[\"TencentShenZhenEmployee\"]",
          "item_type": "string"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "MaxFaceNum",
          "type": "integer",
          "required": false,
          "description": "最多识别的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
          "example": "1"
        },
        {
          "name": "MinFaceSize",
          "type": "integer",
          "required": false,
          "description": "人脸长和宽的最小尺寸，单位为像素。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。",
          "example": "40"
        },
        {
          "name": "MaxPersonNum",
          "type": "integer",
          "required": false,
          "description": "单张被识别的人脸返回的最相似人员数量。 - 默认值为5，最大值为100。 - 例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。 - 值越大，需要处理的时间越长。建议不要超过10。",
          "example": "3"
        },
        {
          "name": "QualityControl",
          "type": "integer",
          "required": false,
          "description": "图片质量控制。 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质\ufffd...",
          "example": "0"
        },
        {
          "name": "FaceMatchThreshold",
          "type": "float",
          "required": false,
          "description": "出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。 - 默认为0。 - 取值范围：[0.0,100.0) 。",
          "example": "0"
        },
        {
          "name": "NeedPersonInfo",
          "type": "integer",
          "required": false,
          "description": "是否返回人员具体信息。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0",
          "example": "0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        }
      ],
      "required": [
        "GroupIds"
      ]
    },
    {
      "name": "SearchPersonsReturnsByGroup",
      "description": "用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopK 人员，按照**人员库的维度**以人员相似度从大到小顺序排列。 支持一次性识别图片中的最多 10 张人脸，支持跨人员库（Group）搜索。 单次搜索的人员库人脸总数量和人员库的算法模型版本（FaceModelVersion）相关。算法模型版本为2.0的人员库，单次搜索人员库人脸总数量不得超过 100 万张；算法模型版本\ufffd\ufffd...",
      "status": "online",
      "parameters": [
        {
          "name": "GroupIds",
          "type": "array",
          "required": true,
          "description": "希望搜索的人员库列表，上限60个。数组元素取值为创建人员库接口中的GroupId。",
          "example": "[\"TencentShenZhenEmployee\"]",
          "item_type": "string"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持...",
          "example": "http://test.image.myqcloud.com/testB.jpg"
        },
        {
          "name": "MaxFaceNum",
          "type": "integer",
          "required": false,
          "description": "最多识别的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。",
          "example": "1"
        },
        {
          "name": "MinFaceSize",
          "type": "integer",
          "required": false,
          "description": "人脸长和宽的最小尺寸，单位为像素。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。",
          "example": "80"
        },
        {
          "name": "MaxPersonNumPerGroup",
          "type": "integer",
          "required": false,
          "description": "被检测到的人脸，对应最多返回的最相似人员数目。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。",
          "example": "5"
        },
        {
          "name": "QualityControl",
          "type": "integer",
          "required": false,
          "description": "图片质量控制。 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质\ufffd...",
          "example": "0"
        },
        {
          "name": "FaceMatchThreshold",
          "type": "float",
          "required": false,
          "description": "出参Score中，只有超过FaceMatchThreshold值的结果才会返回。默认为0。",
          "example": "0"
        },
        {
          "name": "NeedPersonInfo",
          "type": "integer",
          "required": false,
          "description": "是否返回人员具体信息。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0。",
          "example": "0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        }
      ],
      "required": [
        "GroupIds"
      ]
    },
    {
      "name": "UpgradeGroupFaceModelVersion",
      "description": "避免官网歧义 升级人员库。升级过程中，人员库仍然为原算法版本，人员库相关操作仍然支持。升级完成后，人员库为新算法版本。 单个人员库有且仅支持一次回滚操作。 升级是一个耗时的操作，执行时间与人员库的人脸数相关，升级的人员库中的人脸数越多，升级的耗时越长。升级接口是个异步任务，调用成功后返回JobId，通过GetUpgradeGroupFaceModelVersionResult查询升级进度和\ufffd\ufffd...",
      "status": "deprecated",
      "parameters": [
        {
          "name": "GroupId",
          "type": "string",
          "required": true,
          "description": "需要升级的人员库ID。",
          "example": "1001"
        },
        {
          "name": "FaceModelVersion",
          "type": "string",
          "required": true,
          "description": "需要升级至的算法模型版本。默认为最新版本。不可逆向升级",
          "example": "3.0"
        }
      ],
      "required": [
        "GroupId",
        "FaceModelVersion"
      ]
    },
    {
      "name": "VerifyFace",
      "description": "给定一张人脸图片和一个 PersonId，判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。 与[人脸比对](https://cloud.tencent.com/document/product/867/44987)接口不同的是，人脸验证用于判断 “此人是否是此人”，“此人”的信息已存于人员库中，“此人”可能存在多张人脸图片；而[人脸比对](https://cloud.tencent.com/do...",
      "status": "online",
      "parameters": [
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。",
          "example": "1001"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 若图片中包含多张人脸，只选\ufffd...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "QualityControl",
          "type": "integer",
          "required": false,
          "description": "图片质量控制。 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质\ufffd...",
          "example": "0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        }
      ],
      "required": [
        "PersonId"
      ]
    },
    {
      "name": "VerifyPerson",
      "description": "给定一张人脸图片和一个 PersonId，判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。 本接口会将该人员（Person）下的所有人脸（Face）进行融合特征处理，即若某个Person下有4张 Face，本接口会将4张 Face 的特征进行融合处理，生成对应这个 Person 的特征，使人员验证（确定待识别的人脸图片是某人员）...",
      "status": "online",
      "parameters": [
        {
          "name": "PersonId",
          "type": "string",
          "required": true,
          "description": "待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。",
          "example": "2001"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRg.....s97n//2Q=="
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 - 支持PN...",
          "example": "http://test.image.myqcloud.com/testA.jpg"
        },
        {
          "name": "QualityControl",
          "type": "integer",
          "required": false,
          "description": "图片质量控制。 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质\ufffd...",
          "example": "0"
        },
        {
          "name": "NeedRotateDetection",
          "type": "integer",
          "required": false,
          "description": "是否开启图片旋转识别支持。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。",
          "example": "0"
        }
      ],
      "required": [
        "PersonId"
      ]
    }
  ]
}