CreateFacesSearchingTask
从媒体集中搜索与指定图片或人脸ID最相似的前N张图片，并返回相应人脸ID及边界框，返回结果按照相似度降序排列
服务地址：
华东1（杭州）
输入参数
只看必填
ProjectName项目名称
DatasetName数据集名称, 获取方式请参见创建数据集
UserData用户自定义信息
Sources图片列表
0图片对象
URI图片的OSS地址
添加
MaxResult最相似的N个人脸
Notification消息通知对象
MNS轻量消息队列（原 MNS）消息通知参数
TopicName轻量消息队列SMQ（原 MNS）主题名称
RocketMQRocketMQ消息通知参数
TopicNameRocketMQ Topic名称
InstanceIdRocketMQ实例Id
ExtendedMessageURI使用OSS文件接受任务消息通知
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
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 插件
安装插件之前，确保已安装 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.
安 装

接口说明

  • 请确保在使用该接口前，已充分了解智能媒体管理产品的收费方式和价格。
    注意 异步任务不保证时效。
  • 对于每一个输入的图片，只会选取图片中人脸框范围最大的人脸进行人脸搜索。
  • 该接口为异步接口，获取任务开始执行后，任务信息只保存 7 天，超过 7 天则无法再获取。调用 GetTask 或 ListTasks 接口获取返回的TaskId，查看任务信息。也可以通过设置 Notification 消息通知参数，通过消息通知获取任务信息。

请求参数

字段名称字段详情
ProjectNamestring

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

示例值:test-project参考取值来源:
    UpdateProject
    CreateProject
    ListProjects
DatasetNamestring

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

示例值:test-dataset参考取值来源:
    CreateDataset
    UpdateDataset
    ListDatasets
UserDatastring

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

示例值:{"ID": "testuid","Name": "test-user","Avatar": "http://test.com/testuid"}
Sourcesarray<object>

图片列表。

MaxResultinteger<int64>

最相似的 N 个人脸，取值范围为 0~100，默认值为 5。

注意 该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。
示例值:100
Notificationobject

消息通知对象，支持多种消息中间件，消息格式详情请见异步通知消息格式，请选择其中一种方式接收消息，使用方式如下所示：展开详情

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:B1E79399-05F7-06D8-95FE-EBE17BA*****
TaskIdstring

任务 ID。

示例值:CreateFacesSearchingTask-00bec802-073a-4b61-ba*****
EventIdstring

事件 ID。

示例值:0ED-1Bz8z71k5TtsUejT4UJ16****
变更历史
变更时间变更内容概要操作
2023-08-21
删除请求参数TopK
变更请求参数MaxResult
2023-04-03
删除请求参数NotifyTopicName
删除返回参数
2023-03-09
新增请求参数Notification
新增返回参数