本文由簡體中文內容自動轉碼而成。阿里雲不保證此自動轉碼的準確性、完整性及時效性。本文内容請以簡體中文版本為準。
首頁Content ModerationAlibaba Content Security Service1.0開發參考API參考（檢測服務）Face Service自訂人臉檢索刪除人臉
搜尋幫助內容

刪除人臉

更新時間：2024-07-06 00:07
產品
社區

調用deleteFaces介面刪除人臉圖片。

QPS限制

本介面的單使用者QPS限制為20次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。

請求文法

POST /green/sface/face/delete HTTPS|HTTP

要求標頭

該介面使用公用要求標頭，無特殊要求標頭。請參見公用要求標頭。

請求參數

名稱

類型

是否必選

樣本值

描述

名稱

類型

是否必選

樣本值

描述

clientInfo

JSONObject

否

{"userId":"120234234","userNick":"Mike","userType":"others"}

用戶端資訊，由ClientInfo結構體通過JSON序列化獲得，包含umid、imei等資訊，具體結構描述，請參見ClientInfo。

RequestBody

RequestBody中還需要填入以下參數，用來指定要刪除的人臉圖片資訊。

名稱類型是否必選樣本值描述
名稱類型是否必選樣本值描述
personIdString是person1人臉圖片關聯的個體ID。
faceIdsStringArray是["1244453323565","1345345466455"]要刪除的人臉圖片ID列表。
說明
您可以調用getPersonInfo介面查詢個體關聯的人臉圖片ID。

返回資料

所有請求均返回JSON格式的資料。關於返回資料中的公用欄位，請參見公用返回參數。返回資料中的data欄位表示與業務相關的資料，一般是一個JSON結構體或數組。

說明

響應出錯的情況下，data欄位可能為空白。

該介面返回的data欄位包含以下參數。

名稱類型樣本值描述
名稱類型樣本值描述
codeInteger200

錯誤碼，和HTTP狀態代碼一致。

更多資訊，請參見公用錯誤碼。

personIdStringperson1個體ID。
faceIdsStringArray["1244453323565","1345345466455"]成功刪除的人臉圖片ID列表。
deleteCountInteger2成功刪除的人臉圖片數目。

樣本

請求樣本 
POST /green/sface/face/delete HTTP/1.1
公用要求標頭
{
    "personId": "person1",
    "faceIds": [
        "1244453323565",
        "1345345466455"
    ]
}
正常返回樣本 
{
    "msg": "OK",
    "code": 200,
    "requestId": "36D384DA-8023-4E84-BCFD-0C5581352C16",
    "data": {
        "code": 200,
        "personId": "person1",
        "faceIds": [
            "1244453323565",
            "1345345466455"
        ],
        "deleteCount": 2
    }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

上一篇：查詢人臉圖片下一篇：擷取組列表
  • 本頁導讀 （0, M）
  • QPS限制
  • 請求文法
  • 要求標頭
  • 請求參數
  • RequestBody
  • 返回資料
  • 樣本
  • 錯誤碼
文檔反饋
phone 聯絡我們

立即和Alibaba Cloud在線服務人員進行交談，獲取您想了解的產品信息以及最新折扣。

alicare alicarealicarealicare