CreateMergeFaceGroupsJob 合并人脸分组_SetFaceGroups 人脸聚类_图片管理类操作_API手册_智能媒体管理_阿里云技术文档

描述

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

将媒体集 Set 内的两个人脸分组合并。

一些原则

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

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

请求参数

Parameter	Type	Required	Comment
Project	string	Y	Project
SetId	string	Y	媒体集 SetId
GroupIdFrom	string	Y	待合并的分组的 GroupId ，该分组将被并入 GroupIdTo 所代表的分组。
GroupIdTo	string	Y	待合并的分组的 GroupId ，该分组将加入 GroupIdFrom 组中的人脸。
NotifyTopicName	string	N	MNS 订阅的 Topic 主题名称
NotifyEndpoint	string	N	MNS 订阅的 Endpoint

返回参数

Parameter	Type	Comment
JobType	string	任务类型，返回固定值 `MergeFaceGroupsJob` 。
JobId	string	任务唯一 ID
SetId	string	媒体集 ID
GroupIdFrom	string	待合并的分组的 GroupId ，该分组将被并入 GroupIdTo 所代表的分组。
GroupIdTo	string	待合并的分组的 GroupId ，该分组将加入 GroupIdFrom 组中的人脸。

示例

请求示例

POST https://imm.cn-shanghai.aliyuncs.com
?Action=CreateMergeFaceGroupsJob
&Project=test-project
&SetId=test-set
&GroupIdFrom=Group-353ede7d-136c-4ae0-979b-f36cc901f679
&GroupIdTo=Group-1f41e198-9b06-48bd-9b9c-f9ef58a992df
...

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

成功返回示例

{
  "JobType": "MergeFaceGroupsJob",
  "GroupIdFrom": "Group-353ede7d-136c-4ae0-979b-f36cc901f679",
  "GroupIdTo": "Group-1f41e198-9b06-48bd-9b9c-f9ef58a992df",
  "JobId": "MergeFaceGroupsJob-73a65fd7-cabd-4e19-a110-a159d113c6b6",
  "RequestId": "10B8D055-5481-4A71-AB7C-E47991D5DAF0",
  "SetId": "cluster-runner"
}

订阅消息返回示例

返回参数

Parameter	Type	Comment
eventName	string	任务类型，返回固定值 `MergeFaceGroupsJob` 。
imm.JobId	string	任务唯一 ID
imm.SetId	string	媒体集 ID
imm.UpdateFaceCount	string	更新人脸分组的人脸数量，包括新增图片，和旧有图片被分组

MNS 返回的消息格式如：

{
    "events": [
        {
            "eventName": "MergeFaceGroupsJob",
            "eventSource": "acs:imm",
            "eventTime": "2019-02-20T11:06:25.264Z",
            "eventVersion": "1.0",
            "imm": {
                "ErrorCode": "",
                "JobId": "MergeFaceGroupsJob-73a65fd7-cabd-4e19-a110-a159d113c6b6",
                "SetId": "cluster-runner",
                "Success": "true",
                "UpdateFaceCount": "10",
            }
        }
    ]
}

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

CreateMergeFaceGroupsJob 合并人脸分组_SetFaceGroups 人脸聚类_图片管理类操作_API手册_智能媒体管理

CreateMergeFaceGroupsJob 合并人脸分组

描述

一些原则

请求参数

返回参数

示例

请求示例

成功返回示例

订阅消息返回示例

返回参数

版权声明

评论