找不到 API ? 点击 反馈吧
- 服务地域
- 项目管理
- 元数据管理
- 图片处理
- 媒体处理
- 文档处理
- 文件处理
- 内容安全
- 任务管理
- 其它
CreateFigureClusteringTask
创建一个人物人脸聚类任务,通过智能算法,可以在您已索引到数据集的图片中,将属于不同人物的人脸进行聚类分组
服务地址:
华北2(北京)
参数配置
高级配置
输入参数
只看必填
注意事项
ProjectName项目名称
DatasetName数据集名称
UserData用户自定义信息
Tags自定义标签
Notification消息通知对象
MNS轻量消息队列(原 MNS)消息通知参数
TopicName轻量消息队列SMQ(原 MNS)主题名称
RocketMQRocketMQ消息通知参数
TopicNameRocketMQ Topic名称
InstanceIdRocketMQ实例Id
ExtendedMessageURI使用OSS文件接受任务消息通知
文档
调用结果
SDK 示例
CLI示例
相关示例
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
接口说明
-
请确保在使用该接口前,已充分了解智能媒体管理产品的收费方式和价格。
注意 异步任务不保证时效。 -
调用该接口前,请确保您已通过绑定方式( CreateBinding )或者主动索引( IndexFileMeta 或者 BatchIndexFileMeta )方式将文件索引到数据集( CreateDataset )中。
-
每次调用该接口,会增量对数据集( CreateDataset )内的文件进行处理。您可以根据新增文件情况,定期调用该接口对新文件进行处理。
-
聚类完成后,您可以通过 GetFigureCluster 或者 BatchGetFigureCluster 接口获取特定的分组信息,也可通过 QueryFigureClusters 查询和列出数据集下的分组。
-
从数据集中删除文件,会导致人脸聚类发生变化。当一个聚类中所有人脸所在的图片都被删除时,该聚类分组就会被删除。
-
该接口为异步接口,获取任务开始执行后,任务信息只保存 7 天,超过 7 天则无法再获取。调用 GetTask 或 ListTasks 接口获取返回的 TaskId,查看任务信息。也可以通过设置 Notification 消息通知参数,通过消息通知获取任务信息。
请求参数
字段名称 | 字段详情 |
---|---|
ProjectNamestring | 项目名称,获取方式请参见创建项目。 示例值:immtest参考取值来源: CreateProject UpdateProject ListProjects |
DatasetNamestring | 数据集名称,获取方式请参见创建数据集。 示例值:dataset001参考取值来源: UpdateDataset CreateDataset ListDatasets |
UserDatastring | 用户自定义信息,在异步消息通知中会为您返回,用于方便您系统内对消息通知进行关联处理。最大长度为 2048 字节。 示例值:{"ID": "user1","Name": "test-user1","Avatar": "http://example.com?id=user1"} |
Tagsobject | 自定义标签,用于对异步任务进行搜索、过滤。 示例值:{"test": "val1"} |
消息通知配置,详细内容请单击 Notification 查看,异步通知消息格式请参见异步通知消息格式。 |
返回参数
字段名称 | 字段详情 |
---|---|
RequestIdstring | 当次请求的 Request ID。 示例值:1B3D5E0A-D8B8-4DA0-8127-ED32C851**** |
TaskIdstring | 任务 ID。 示例值:formatconvert-00bec802-073a-4b61-ba3b-39bc**** |
EventIdstring | 事件 ID。 示例值:0ED-1Bz8z71k5TtsUejT4UJ16**** |
变更历史
变更时间 | 变更内容概要 | 操作 | |
---|---|---|---|
2023-04-03 | 删除请求参数NotifyTopicName 删除返回参数 | ||
2023-03-09 | 新增请求参数Notification 新增返回参数 | ||
2022-08-16 | 删除请求参数NotifyEndpoint | ||
2021-12-31 | 新增请求参数Tags |