全部產品
Search
文件中心

ID Verification:刪除人臉庫中的人臉圖片

更新時間:Jul 07, 2026

FACE_IDU 支援人臉檢索模式,並提供人臉庫管理功能。您可以通過 ID Verification 控制台(使用使用者識別碼)或調用本介面,刪除指定的人臉圖片。

介面資訊

  • 介面名: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