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

注意事项

  • 同一时间一个媒体集中只能进行一个聚类任务(包括CreateMergeFaceGroupsJob和CreateGroupFacesJob),因此调用对应接口时,请确保上一次调用已执行完成。您可以使用通知机制,传入NotifyTopicName和NotifyEndpoint,及时获取任务执行结果的通知。具体操作,请参见消息服务MNS快速入门
  • 每个合并人脸分组任务的最长执行时间为3分钟。
说明 接口公测中,如有任何使用问题请加入钉钉用户群(钉钉群号:21714099)实时交流。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
RegionId String cn-hangzhou

项目所在地域的ID。

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

Action String CreateMergeFaceGroupsJob

操作接口名称,固定取值为CreateMergeFaceGroupsJob。

Project String immimagetest

项目名称。

SetId String set001

媒体集的唯一标识。

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对应分组中的人脸。

CustomMessage String abc

用户自定义信息,在通知时回原样返回。最长1024个字符。

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",
                "CustomMessage": "abc",
                "GroupIdFrom": "Group-c1f55987-360b-4640-9e2c-f5c29f930a3b",
                "GroupIdTo": "Group-c5fdad70-fd60-4c2a-8a08-ed86aca21f09"
            }
        }
    ]
}

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

名称

类型

描述

eventName

String

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

imm.JobId

String

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

imm.SetId

String

媒体集的唯一标识。

imm.UpdateFaceCount

String

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

imm.CustomMessage

String

用户自定义信息。

imm.GroupIdFrom

String

待合并的分组的GroupId,该分组中的人脸将被合并到GroupIdTo对应分组中。

imm.GroupIdTo

String

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

返回数据

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

待合并的分组的GroupId,该分组中的人脸将被合并到GroupIdTo对应分组中。

JobType String MergeFaceGroupsJob

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

RequestId String 3FF344BF-87A9-4AC3-A3DE-9E1FAED7D1FE

当次请求的Request ID。

SetId String set001

媒体集的唯一标识。

GroupIdTo String Group-c5fdad70-fd60-4c2a-8a08-ed86aca21f09

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

JobId String MergeFaceGroupsJob-055995ef-9c5e-4db4-a99a-0900d1e31d26

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

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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格式

HTTP/1.1 200 OK
Content-Type:application/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"
}