跳到主要内容

自定义人物名单管理接口

信息

客户创建好自定义名单后，送审 敏感人物 等人脸搜索任务 时优先搜索自定义名单中关联的特征，当命中自定义名单中的特征时，返回该特征关联的 人物 name 作为 faceId, 该特征关联 的 人物名单 name 作为 typeName

客户可以通过接口管理自定义人物相关数据，用于在人脸匹配类型的审核任务中，作为自己的数据集使用。创建自定义名单 并发起审核的基础流程如下：

提示

  1. 通过图普识别接口送审，只会搜索 当前接口使用的 secretId 关联的人物名单

  2. 创建人物名单默认只关联当前接口使用的 secretId, 可以通过 更新人物名单属性 ，修改人物名单关联的 secretId

  3. 特征支持上线，下线操作。搜索人物只会搜索上线状态的特征。修改特征状态后一般 10 分钟左右生效

  4. 特征支持修改关联的人物名单；当命中的特征关联了多个人物名单，结果会按照 人物名单 priority 排序 取最高优先级

  5. 删除人物 会删除人物关联所有特征

简介​

该类接口服务可以对自定义人物名单进行操作管理，功能接口包括：

  1. 新建人物

    支持新建自定义人物

  2. 删除人物

    支持删除自定义人物

  3. 更新人物属性

    支持更新自定义人物属性

  4. 查询人物

    支持查询自定义人物

  5. 新建人物名单

    支持新建自定义人物名单

  6. 删除人物名单

支持删除自定义人物名单

  1. 更新人物名单属性

支持更新自定义人物名单属性, 关联的 sid

  1. 应用关联的名单信息查询

支持查询当前 sid 关联的自定义人物名单

  1. 查询人物名单中的人物和特征

支持查询指定人物名单中的人物和特征

  1. 指定人物添加图片特征

支持通过传 URL 以及 base64 方式批量添加图片到指定人物名单

  1. 删除图片特征

支持删除图片特征

  1. 指定特征关联人物名单

指定特征图片关联到 人物库

  1. 指定特征取消关联人物名单

支持指定特征取消关联人物名单

名词解释​

  • 应用 ID：即 secretId，可在登录控制台后，在 “我的应用” 页面查看
  • 自定义人物： 即 person, 用于表示 脸部特征图片 所属的人。字段 name 用于区分不同人物。例如：小明，小美，4302XXXX20230901XXXX
  • 自定义人物名单：即 personLibrary，用于表示 人物的分组。字段 name 用于区分不同人物分组名单。例如： 自定义人物，国外政治人物，头部主播
  • 自定义人物特征：即 feature，用于表示 人物特征，通常由人脸图片计算特征值得到。

关联关系示例