全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件

GroupFaces

更新时间:2017-12-27 22:07:18

描述

对数据集中的人脸进行全量或者增量的分组操作。
分组之后每一个 FaceId 会带有一个 GroupId,表示分组结果。
当一个人脸未与任何人脸组成一个分组时,GroupID=0 。
增量表示只对 GroupId=-1 和 GroupId=0 的 FaceId 进行分组,不改变已经有分组结果(GroupFace)。

请求参数

名称 类型 是否必填 描述
Project String 项目名
Action String GroupFaces
SetId String 数据集 ID
Operation Integer 人脸分组操作类型,
  • 0, 增量人脸分组操作
  • 1, 全量人脸分组操作
默认值是0,增量人脸分组。
增量操作不会改变 GroupId 不为 0 的人脸分组,且只返回增量,

返回参数

名称 类型 描述
RequestId String 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId 给用户
SetId String 数据集 ID
HasMore Integer 是否还有未聚类的人脸,
  • 1,还有未聚类的人脸,需再次调用增量人脸分许处理
  • 0,则表示所有人脸已经分组完成
Groups Array 人脸分组 Group的数组

数据类型Group

名称 类型 描述
FaceId String 人脸 ID
GroupId String 分组 ID,
如果两个或多个人脸有相同的 GroupId,代表这些人脸被分为一组。
如果某个人脸没有与其他人脸分为一组,则 GroupId = 0。
后续人脸分组操作时,这些人脸可能与新加入的人脸分为一组。
例如,第一次加入10个人脸,8个人脸分组成功返回,剩下 2个人脸不返回。
第二次传入20个新的人脸,与之前2个孤立人脸分组成功,返回 22 个人脸。
UnGroupReason String 当 GroupId为0时,表示未分组的原因,有如下值:
  • FaceLowQuality,人脸图像质量过低。
  • FaceRectangleSmall,人脸图像尺寸过小(高度或宽度)。
  • FacePoseTooLarge,人脸角度过大。
  • FaceTooBlur,人脸图像太模糊。
  • FaceNoSimilar,孤立人脸(无法找到相似人脸)。
  • FaceOtherReasons,其他原因。

示例

请求示例

  1. POST https://imm.cn-shanghai.aliyuncs.com?Action=GroupFaces
  2. &Project=test
  3. &SetId=3b461148-9457-483b-8acc-f487f118603a

成功返回示例

  1. {
  2. "RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF187514",
  3. "SetId": "3b461148-9457-483b-8acc-f487f118603a",
  4. "HasMore": 0,
  5. "Groups": [
  6. {
  7. "FaceId": "ebc90564f97181b4c0aa26af764c94ba",
  8. "GroupId": "0",
  9. "UnGroupReason": "FaceTooBlur"
  10. },
  11. {
  12. "FaceId": "e5aa750e4be8d40870c9c87816024497",
  13. "GroupId": "1",
  14. "UnGroupReason": ""
  15. },
  16. {
  17. "FaceId": "73156a145935cbfdc3ea772a88629d59",
  18. "GroupId": "2",
  19. "UnGroupReason": ""
  20. },
  21. {
  22. "FaceId": "293d1e85c26f8f4900bf6176a00145f7",
  23. "GroupId": "1",
  24. "UnGroupReason": ""
  25. },
  26. {
  27. "FaceId": "a417b1739d3c1295d9af7427739780a9",
  28. "GroupId": "2",
  29. "UnGroupReason": ""
  30. },
  31. {
  32. "FaceId": "cf5db5de05ca580551bcbfb74766ea39",
  33. "GroupId": "2",
  34. "UnGroupReason": ""
  35. },
  36. {
  37. "FaceId": "b2453f151ac479483a71cd28be09c317",
  38. "GroupId": "1",
  39. "UnGroupReason": ""
  40. }
  41. ]
  42. }
本文导读目录