调用CreateMergeFaceGroupsJob接口合并媒体集中的两个人脸分组。

注意事项

  • 同一时间一个媒体集中只能进行一个聚类任务（包括CreateMergeFaceGroupsJob和CreateGroupFacesJob），因此调用对应接口时，请确保上一次调用已执行完成。您可以使用通知机制，传入NotifyTopicName和NotifyEndpoint，及时获取任务执行结果的通知。具体操作，请参见消息服务MNS快速入门。
  • 每个合并人脸分组任务的最长执行时间为3分钟，单次最多能处理5100张图片中的人脸。如果媒体集中添加的图片个数超过限制数量，则需要多次调用该接口。
说明 接口公测中，如有任何使用问题请加入钉钉用户群（钉钉群号：21714099）实时交流。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateMergeFaceGroupsJob

操作接口名称，固定取值为CreateMergeFaceGroupsJob。
Project String 是 immimagetest

项目名称。
SetId String 是 set001

媒体集的唯一标识。
RegionId String 否 cn-hangzhou

项目所在地域的ID。

地域Endpoint格式为imm.RegionId.aliyuncs.com，例如当RegionId为cn-hangzhou时，地域Endpoint为imm.cn-hangzhou.aliyuncs.com。

NotifyTopicName String 否 topic1

异步反向通知的TopicName。
NotifyEndpoint String 否 http://1111111111.mns.cn-hangzhou.aliyuncs.com

异步反向通知的Endpoint，文档转换状态可以通过该Endpoint异步通知给调用者。使用此功能需要先开通MNS服务，新建topic和queue，并配置订阅关系。具体操作，请参见消息服务MNS快速入门。

说明 MNS服务和智能媒体管理必须处于同一地域。
GroupIdFrom String 否 Group-c1f55987-360b-4640-9e2c-f5c29f930a3b

待合并的分组的GroupId，该分组中的人脸将被合并到GroupIdTo对应分组中。
GroupIdTo String 否 Group-c5fdad70-fd60-4c2a-8a08-ed86aca21f09

待合并的分组的GroupId，该分组中将加入GroupIdFrom对应分组中的人脸。

MNS通知

请求参数中如果设置了NotifyTopicName和NotifyEndpoint支持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": "set001",
                "Success": "true",
                "UpdateFaceCount": "10",
            }
        }
    ]
}

MNS通知的返回参数说明请参见下表。

名称

类型

描述

eventName

String

任务类型，返回值固定为MergeFaceGroupsJob。

imm.JobId

String

合并人脸分组任务的唯一标识。

imm.SetId

String

媒体集的唯一标识。

imm.UpdateFaceCount

String

更新人脸分组的人脸数量，包括新增图片和原有未分组图片中被分组的人脸。

返回数据

名称 类型 示例值 描述
GroupIdFrom String Group-c1f55987-360b-4640-9e2c-f5c29f930a3b

待合并的分组的GroupId，该分组中的人脸将被合并到GroupIdTo对应分组中。
GroupIdTo String Group-c5fdad70-fd60-4c2a-8a08-ed86aca21f09

待合并的分组的GroupId，该分组中将加入GroupIdFrom对应分组中的人脸。
JobId String MergeFaceGroupsJob-055995ef-9c5e-4db4-a99a-0900d1e31d26

合并人脸分组任务的唯一标识。
JobType String MergeFaceGroupsJob

任务类型，返回值固定为MergeFaceGroupsJob。
RequestId String 3FF344BF-87A9-4AC3-A3DE-9E1FAED7D1FE

当次请求的Request ID。
SetId String set001

媒体集的唯一标识。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateMergeFaceGroupsJob
&Project=immimagetest
&SetId=set001
&<公共请求参数>

正常返回示例

XML 格式 

<GroupIdFrom>Group-c1f55987-360b-4640-9e2c-f5c29f930a3b</GroupIdFrom>
<JobType>MergeFaceGroupsJob</JobType>
<RequestId>3FF344BF-87A9-4AC3-A3DE-9E1FAED7D1FE</RequestId>
<SetId>set001</SetId>
<GroupIdTo>Group-c5fdad70-fd60-4c2a-8a08-ed86aca21f09</GroupIdTo>
<JobId>MergeFaceGroupsJob-055995ef-9c5e-4db4-a99a-0900d1e31d26</JobId>

JSON 格式 

{
    "GroupIdFrom": "Group-c1f55987-360b-4640-9e2c-f5c29f930a3b",
    "JobType": "MergeFaceGroupsJob",
    "RequestId": "3FF344BF-87A9-4AC3-A3DE-9E1FAED7D1FE",
    "SetId": "set001",
    "GroupIdTo": "Group-c5fdad70-fd60-4c2a-8a08-ed86aca21f09",
    "JobId": "MergeFaceGroupsJob-055995ef-9c5e-4db4-a99a-0900d1e31d26"
}