描述

接口公测中，如有任何使用问题请 联系我们

聚类功能仅对 2019.3.12 后使用 IndexImage 接口将图片索引至 媒体集 Set 内的图片有效。历史图片如需使用，请从 Set 中删除并重新索引。

对媒体集 Set 内的人脸进行聚类操作，即将同一人物的人脸分为一组，并将组信息保存至人脸的 GroupId 中。

一些原则

该接口为增量聚类。每次调用会对 Set 内新增图片进行分类，同时已经分好的类，以及尚未能够分类的图片也会参与到该次聚类操作。

对同一个 Set ，同一时间只能有一个人脸聚类任务进行。因此在调用该接口时，应确保上一次调用已经结束。可以通过 Notify 订阅来获得任务执行结果的通知。

每个聚类任务最长执行时间为 2 分钟。单次聚类最多处理 5100 张图片中的人脸。如果在 Set 中添加了超过限制数量的图片，则需要多次调用接口。

一旦人脸已经被分组，本接口就不会修改其分组，即使有更适合的分组出现。

一旦一个组已经形成，则该组也不会被合并到其他分组。

可以通过 ListFaceGroups 接口查看已经有的分组列表，并可以通过 FindImages 接口，根据 GroupId 搜索该组的人脸图片。

GroupId 分组 ID 的命名规则

一个已经形成的分组，通常以 Group-{UUID-v4} 格式命名，即 Group- 后接一个 UUIDv4 格式的字符串。

如下分组为保留的特殊分组命名：

• group-none 该人脸暂时没有合适的分组，未来新增图片后该人脸可能被分入组中
• group-not-grouped 该人脸暂时没有被检测过分组，即新增图片 IndexImage 后未调用 CreateGroupFacesJob API。
• group-none-by-user 由用户手动操作，记录该人脸没有合适的分组，未来新增图片后该人脸 仍不会 被分入组中

请求参数

关于 MNS 的使用方式，参考 消息服务 MNS 概述

返回参数

示例

请求示例

POST https://imm.cn-shanghai.aliyuncs.com
?Action=GroupImageFacesJob
&Project=test-project
&SetId=test-set
...

此处的示例，目的是展示关键参数，还需要其他的公共参数才能正常调用，推荐使用 SDK 来发送 API。

成功返回示例

{
  "JobType": "GroupImageFacesJob",
  "JobId": "GroupImageFacesJob-9bab56e8-e596-421a-b1f5-9ad1ab875fe4",
  "RequestId": "B121940C-9794-4EE3-8D6E-F8EC525F138A",
  "SetId": "t-group-s"
}

订阅消息返回示例

返回参数

MNS 返回的消息格式如：

{
    "events": [
        {
            "eventName": "GroupImageFacesJob",
            "eventSource": "acs:imm",
            "eventTime": "2019-02-20T11:06:25.264Z",
            "eventVersion": "1.0",
            "imm": {
                "ErrorCode": "",
                "JobId": "GroupImageFacesJob-a7c8f7a4-5c22-42df-8615-74a61efc4374",
                "NewGroupCount": "1",
                "SetId": "t-group-s",
                "Success": "true",
                "UpdateFaceCount": "10",
                "UpdateGroupCount": "1"
            }
        }
    ]
}

若在使用中有疑问，请参考 FAQ，或者进入 钉钉用户群 实时交流。