CreateMergeFaceGroupsJob 合并人脸分组_SetFaceGroups 人脸聚类_图片管理类操作_API手册_智能媒体管理
CreateMergeFaceGroupsJob 合并人脸分组
描述
接口公测中,如有任何使用问题请 联系我们
将媒体集 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",
}
}
]
}
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论