全部产品
Search
文档中心

ID Verification:删除人脸库中的人脸图片

更新时间:Jul 06, 2026

FACE_IDU 支持人脸检索模式,并提供人脸库管理功能。您可以通过 ID Verification 控制台(使用用户 ID)或调用本接口,删除指定的人脸图片。

接口信息

  • 接口名:DeleteFaceRecordV2

  • 请求方法:POST

  • 传输协议:HTTPS

  • QPS 限制:该 API 对单个租户的请求速率上限为 50 QPS。

  • 服务地址:

    说明
    • 内网指的是阿里云同地域产品之间的内部通信网络,如果您的业务服务器部署在阿里云的对应地域,可以通过内网域名访问 ID Verification 服务,以获得更安全、稳定的网络通信质量。

    • ID Verification不同产品方案支持的Region不同,数据之间相互隔离,您需要选择数据所在Reigon下的接口域名,才能成功访问数据。

    新加坡

    • 公网:cloudauth-intl.ap-southeast-1.aliyuncs.com

    • 内网:cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    印度尼西亚

    • 公网:cloudauth-intl.ap-southeast-5.aliyuncs.com

    • 内网:cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

    中国香港

    • 公网:cloudauth-intl.cn-hongkong.aliyuncs.com

    • 内网:cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    马来西亚(吉隆坡)

    • 公网:cloudauth-intl.ap-southeast-3.aliyuncs.com

    • 内网:cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com

在线调试和集成

说明

在调试和集成前,请确保您已完整阅读使用OpenAPI文档,充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。

您可以在OpenAPI Explorer中直接运行本接口进行调试,并生成本接口的SDK代码示例

请求参数

名称

类型

描述

是否必填

MerchantUserId

String

用户唯一标识,与 AddFaceRecord 入库时保持一致;若入库时未传入,可使用默认图片名。

FaceGroupCode

String

指定人脸库编码;不传则删除该用户在所有人脸库中的人脸数据。

返回参数

名称

类型

描述

示例值

HTTP Status Code

integer

HTTP状态码。

200

HTTP Body

RequestId

String

请求唯一标识,用于问题排查。

130A2C10-B9EE-4D84-88E3-5384FF03****

Code

String

返回Code,具体信息请参见服务端返回HTTP状态码说明

Success

Message

String

返回Code的详细描述。

请求成功

Result.Deleted

String

删除结果。

  • Y:删除成功

  • N:删除失败

Y

Result.DeletedGroupCodes

String

实际执行删除的人脸库编码列表(以逗号分隔);未传 FaceGroupCode 时返回所有已删除的库。

10001