文档

CreateFigureClustersMergingTask - 合并人物聚类

更新时间:

将两个或两个以上人物聚类分组合并为一个人物聚类分组。

接口说明

  • 请确保在使用该接口前,已充分了解智能媒体管理产品的收费方式和价格
  • 调用该接口前,请确保您已通过创建人物人脸聚类任务( CreateFigureClusteringTask )将数据集中的所有人脸都进行过聚类。
  • 将无关的分组进行合并,合并后会影响目标分组的特征值,导致创建人物人脸聚类任务对增量数据可能出现分组不准确的情况。
  • 该接口为异步接口,获取任务开始执行后,任务信息只保存 7 天,超过 7 天则无法再获取。调用 GetTaskListTasks 接口获取返回的TaskId,查看任务信息。也可以通过设置 Notification 消息通知参数,通过消息通知获取任务信息。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ProjectNamestring

项目名称,获取方式请参见创建项目

immtest
DatasetNamestring

数据集名称, 获取方式请参见创建数据集

dataset001
Fromstring

源聚类分组 ID,From 和 Froms 至少有一个有值,并且不允许同时有值。

Cluster-2ab85905-23ba-4632-b2d8-1c21cfe****
Tostring

目的聚类分组 ID。

Cluster-4a3a71c1-c092-4788-8826-2f65d17****
UserDatastring

用户自定义信息,在异步消息通知中会为您返回,用于方便您系统内对消息通知进行关联处理。最大长度为 2048 字节。

{"ID": "user1","Name": "test-user1","Avatar": "http://example.com?id=user1"}
Tagsobject

自定义标签,用于对异步任务进行搜索、过滤。

{"key":"val"}
Fromsarray

源聚类分组 ID 列表,From 和 Froms 至少有一个有值,并且不允许同时有值。长度不超过 100。

string

单个源聚类分组 ID。

Cluster-2ab85905-23ba-4632-b2d8-1c21cfe****
NotificationNotification

消息通知配置,详细内容请单击 Notification 查看,异步通知消息格式请参见异步通知消息格式

返回参数

名称类型描述示例值
object

响应结构体。

RequestIdstring

当次请求的 Request ID。

CA995EFD-083D-4F40-BE8A-BDF75FF****
TaskIdstring

任务 ID。

92376fbb-171f-4259-913f-705f7ee0****
EventIdstring

事件 ID。

0ED-1Bz8z71k5TtsUejT4UJ16E****

示例

正常返回示例

JSON格式

{
  "RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FF****",
  "TaskId": "92376fbb-171f-4259-913f-705f7ee0****",
  "EventId": "0ED-1Bz8z71k5TtsUejT4UJ16E****"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-04-03OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    删除入参:NotifyTopicName
2023-03-09OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:Froms
    新增入参:Notification
2022-08-16OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    删除入参:NotifyEndpoint
2022-08-16OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    删除入参:NotifyEndpoint
  • 本页导读 (1)