识别出的最相似候选人
被如下接口引用：SearchFaces, SearchPersons。
| 名称 | 类型 | 描述 |
|---|---|---|
| PersonId | String | 人员ID。 |
| FaceId | String | 人脸ID。 - 仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。 - 人员搜索类接口采用融合特征方式检索，该字段无意义。 |
| Score | Float | 候选者的匹配得分。 - 1万大小人脸底库下，误识率百分之一对应分数为70分，误识率千分之一对应分数为80分，误识率万分之一对应分数为90分。 - 10万大小人脸底库下，误识率百分之一对应分数为80分，误识率千分之一对应分数为90分，误识率万分之一对应分数为100分。 - 30万大小人脸底库下，误识率百分之一对应分数为85分，误识率千分之一对应分数为95分。 - 一般80分左右可适用大部分场景，建议分数不要超过90分。您可以根据实际情况选择合适的分数。 |
| PersonName | String | 人员名称。 |
| Gender | Integer | 人员性别。 |
| PersonGroupInfos | Array of PersonGroupInfo | 包含此人员的人员库及描述字段内容列表。 |
敏感数据加密
被如下接口引用：CreateFace, CreatePerson, SearchFaces, SearchPersons。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| EncryptList | Array of String | 是 | 在使用加密服务时，填入要被加密的字段。本接口中可填入加密后的一个或多个字段 |
| CiphertextBlob | String | 是 | 加密后的对称密钥，关于密钥的生成和使用请查阅数据加密 文档。 |
| Iv | String | 否 | 有加密需求的用户，传入CBC加密的初始向量（客户自定义字符串，长度16字符）。 |
| Algorithm | String | 否 | 加密使用的算法（支持'AES-256-CBC'），不传默认为'AES-256-CBC' |
| TagList | Array of String | 否 | SM4-GCM算法生成的消息摘要（校验消息完整性时使用），暂不支持。 |
检测出的人脸框的位置
被如下接口引用：CreateFace, CreatePerson, SearchFaces, SearchPersons。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| X | Integer | 否 | 人脸框左上角横坐标。 - 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 - 若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。 |
| Y | Integer | 否 | 人脸框左上角纵坐标。 - 人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 - 若需截取完整人脸，可以在完整分completess满足需求的情况下，将负值坐标取0。 |
| Width | Integer | 否 | 人脸宽度。 |
| Height | Integer | 否 | 人脸高度。 |
需要修改的人员描述字段内容，key-value
被如下接口引用：CreatePerson。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| PersonExDescriptionIndex | Integer | 是 | 人员描述字段Index，从0开始。 |
| PersonExDescription | String | 是 | 需要更新的人员描述字段内容。 |
包含此人员的人员库及描述字段内容列表
被如下接口引用：SearchFaces, SearchPersons。
| 名称 | 类型 | 描述 |
|---|---|---|
| GroupId | String | 包含此人员的人员库ID。 |
| PersonExDescriptions | Array of String | 人员描述字段内容。 |
人脸的识别结果
被如下接口引用：SearchFaces, SearchPersons。
| 名称 | 类型 | 描述 |
|---|---|---|
| Candidates | Array of Candidate | 识别出的最相似候选人。 |
| FaceRect | FaceRect | 检测出的人脸框位置。 |
| RetCode | Integer | 检测出的人脸图片状态返回码。 - 0 表示正常。 - -1601代表不符合图片质量控制要求，此时Candidate内容为空。 |
文档反馈