全部产品
云市场

CreateMergeFaceGroupsJob 合并人脸分组

更新时间:2019-05-14 11:16:14

描述

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

将媒体集 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 组中的人脸。

示例

请求示例

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

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

成功返回示例

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

订阅消息返回示例

返回参数

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

MNS 返回的消息格式如:

  1. {
  2. "events": [
  3. {
  4. "eventName": "MergeFaceGroupsJob",
  5. "eventSource": "acs:imm",
  6. "eventTime": "2019-02-20T11:06:25.264Z",
  7. "eventVersion": "1.0",
  8. "imm": {
  9. "ErrorCode": "",
  10. "JobId": "MergeFaceGroupsJob-73a65fd7-cabd-4e19-a110-a159d113c6b6",
  11. "SetId": "cluster-runner",
  12. "Success": "true",
  13. "UpdateFaceCount": "10",
  14. }
  15. }
  16. ]
  17. }

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