添加人臉數(shù)據(jù)
本文介紹人臉人體(facebody)類目下的添加人臉數(shù)據(jù)AddFace的語(yǔ)法及示例。
功能描述
添加人臉數(shù)據(jù)能力可以為指定數(shù)據(jù)庫(kù)添加人臉數(shù)據(jù),單個(gè)人臉數(shù)據(jù)庫(kù)支持最多5萬(wàn)張人臉照片入庫(kù),人臉數(shù)據(jù)是在已創(chuàng)建好的人臉樣本中添加,每個(gè)人臉樣本最多可以添加5張人臉照片。
人臉照片入庫(kù)量以及每個(gè)人臉樣本最多添加的照片量暫不支持?jǐn)U容。
- 您可以進(jìn)入在線咨詢獲取在線人工幫助。
- 阿里云視覺(jué)智能開(kāi)放平臺(tái)視覺(jué)AI能力API接入、接口使用或問(wèn)題咨詢等,請(qǐng)通過(guò)釘釘群(23109592)加入阿里云視覺(jué)智能開(kāi)放平臺(tái)咨詢?nèi)郝?lián)系我們。
接入指引
1. 注冊(cè)阿里云賬號(hào):打開(kāi)阿里云官網(wǎng),在阿里云官網(wǎng)右上角,單擊立即注冊(cè),按照操作提示完成賬號(hào)注冊(cè)。
2. 開(kāi)通能力:請(qǐng)確保您已開(kāi)通人臉人體服務(wù),若未開(kāi)通服務(wù)請(qǐng)立即開(kāi)通。
本能力支持企業(yè)或個(gè)人認(rèn)證用戶開(kāi)通。更多實(shí)名認(rèn)證操作信息,請(qǐng)參見(jiàn)實(shí)名認(rèn)證。
3. 創(chuàng)建AccessKey:請(qǐng)確保您已創(chuàng)建AccessKey,如果您使用的是子賬號(hào)AccessKey,您需要給子賬號(hào)賦予AliyunVIAPIFullAccess權(quán)限,具體操作,請(qǐng)參見(jiàn)RAM授權(quán)。
4. 前提條件:
- 已通過(guò)創(chuàng)建人臉數(shù)據(jù)庫(kù)(CreateFaceDb)接口創(chuàng)建了數(shù)據(jù)庫(kù)名稱(DbName)。
- 已通過(guò)添加人臉樣本(AddFaceEntity)接口創(chuàng)建了實(shí)體ID(EntityId)。
4. 在線調(diào)試(可選):您可以通過(guò)OpenAPI Explorer在線調(diào)試能力,查看完整的調(diào)用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開(kāi)發(fā)接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語(yǔ)言。
- 在對(duì)應(yīng)語(yǔ)言的SDK文檔中找到AI類目為人臉人體(facebody)的SDK包進(jìn)行安裝。
- 參考文檔中提供的示例代碼進(jìn)行適當(dāng)修改后調(diào)用。
6. 示例代碼:該能力常用語(yǔ)言的示例代碼,請(qǐng)參見(jiàn)添加人臉數(shù)據(jù)示例代碼。
7. 客戶端直接調(diào)用:該能力常用的客戶端調(diào)用方式包括以下幾種。
輸入限制
- 圖像格式:JPG、JPEG、PNG。
- 圖像大?。翰怀^(guò)5 MB。
- 圖像分辨率:大于32×32像素,小于4096×4096像素。人臉占比不低于64×64像素。
- URL地址中不能包含中文字符。
- 圖片中若包含多個(gè)人臉,會(huì)取最大的人臉進(jìn)行添加。
限制說(shuō)明
添加人臉數(shù)據(jù)接口提交任務(wù)并發(fā)默認(rèn)為2QPS。
計(jì)費(fèi)說(shuō)明
添加人臉數(shù)據(jù)能力可免費(fèi)調(diào)用。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | AddFace | 系統(tǒng)規(guī)定參數(shù)。取值:AddFace。 |
DbName | String | 是 | default | 數(shù)據(jù)庫(kù)名稱。支持小寫(xiě)字母、數(shù)字、下劃線的組合,長(zhǎng)度1~64。 |
ImageUrl | String | 是 | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png | 人臉圖片地址,人臉必須是正面無(wú)遮擋人臉(若包含多張人臉則取最大人臉添加)。推薦使用上海地域的OSS鏈接,對(duì)于文件在本地或者非上海地域OSS鏈接的情況,請(qǐng)參見(jiàn)文件URL處理。 |
EntityId | String | 是 | U1 | 實(shí)體ID,用來(lái)標(biāo)識(shí)用戶的唯一性,如用戶ID、員工ID等。每個(gè)實(shí)體可包含多張人臉圖片。支持大小寫(xiě)字母、數(shù)字、下劃線、減號(hào)的組合,長(zhǎng)度為1~64字符。 |
ExtraData | String | 否 | 王小二 | 自定義信息。支持字母、數(shù)字、標(biāo)點(diǎn)符號(hào)和漢字。不超過(guò)512個(gè)字符。 |
QualityScoreThreshold | Float | 否 | 50.0 | 質(zhì)量分閾值。對(duì)新增人臉圖片進(jìn)行質(zhì)量分析判斷,得到的質(zhì)量分小于該閾值則表示新增人臉圖片質(zhì)量不符合要求,添加失敗。取值范圍[0.0,100.0]。0.0或空則表示不做質(zhì)量分判斷邏輯。 |
SimilarityScoreThresholdInEntity | Float | 否 | 50.0 | 類內(nèi)相似度閾值。將新增人臉圖片與EntityId內(nèi)已有人臉進(jìn)行相似比對(duì),小于該閾值則表示與其他人臉圖片差異較大,添加失敗.;若EntityId內(nèi)沒(méi)有人臉存在,則添加成功。取值范圍[0.0,100.0]。0.0或空則表示不做類內(nèi)相似度判斷邏輯。參考值見(jiàn)人臉比對(duì)1:1接口的返回結(jié)果字段Thresholds。 |
SimilarityScoreThresholdBetweenEntity | Float | 否 | 50.0 | 類間相似度閾值。將新增人臉圖片與其他所有EntityId內(nèi)已有人臉進(jìn)行相似比對(duì),大于等于該閾值則表示其他EntityId內(nèi)存在相似人臉,出現(xiàn)重復(fù),添加失敗。取值范圍[0.0,100.0]。0.0或空則表示不做類間相似度判斷邏輯。參考值見(jiàn)人臉比對(duì)1:1接口的返回結(jié)果字段Thresholds。 |
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 2B93C43A-F824-40C8-AF79-844342B0F43A | 請(qǐng)求ID。 |
Data | Object | 返回的結(jié)果數(shù)據(jù)內(nèi)容。 |
|
FaceId | String | 5 | 輸出人臉I(yè)D。 |
QualitieScore | Float | 99.79581 | 輸入圖像中的人臉質(zhì)量分。 |
SDK參考
阿里云視覺(jué)AI人臉人體類目下的添加人臉數(shù)據(jù)能力推薦使用SDK調(diào)用,支持多種編程語(yǔ)言,調(diào)用時(shí)請(qǐng)選擇AI類目為人臉人體(facebody)的SDK包,文件參數(shù)通過(guò)SDK調(diào)用可支持本地文件及任意URL,具體可參見(jiàn)SDK總覽。
示例代碼
該能力常用語(yǔ)言的示例代碼,請(qǐng)參見(jiàn)添加人臉數(shù)據(jù)示例代碼。
示例
請(qǐng)求示例
http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=AddFace //更多關(guān)于訪問(wèn)域名(Endpoint)信息,請(qǐng)參見(jiàn):http://m.bestwisewords.com/document_detail/143103.html
&DbName=default
&ImageUrl=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png
&EntityId=U1
&ExtraData=王小二
&QualityScoreThreshold=50.0
&SimilarityScoreThresholdInEntity=50.0
&SimilarityScoreThresholdBetweenEntity=50.0
&公共請(qǐng)求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<AddFaceResponse>
<RequestId>2B93C43A-F824-40C8-AF79-844342B0F43A</RequestId>
<Data>
<FaceId>5</FaceId>
<QualitieScore>99.79581</QualitieScore>
</Data>
</AddFaceResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "2B93C43A-F824-40C8-AF79-844342B0F43A",
"Data" : {
"FaceId" : "5",
"QualitieScore" : 99.79581
}
}
錯(cuò)誤碼
關(guān)于添加人臉數(shù)據(jù)的錯(cuò)誤碼,詳情請(qǐng)參見(jiàn)常見(jiàn)錯(cuò)誤碼。
安全聲明
- 請(qǐng)確保上傳的圖片或文件來(lái)源符合相應(yīng)的法律法規(guī)。
- 通過(guò)體驗(yàn)調(diào)試上傳的臨時(shí)文件有效期為1小時(shí),在24小時(shí)后會(huì)被系統(tǒng)自動(dòng)清理刪除。
- 平臺(tái)不存儲(chǔ)用戶在使用服務(wù)過(guò)程中涉及的原始人臉圖片或文件信息。
- 平臺(tái)針對(duì)超過(guò)6個(gè)月及以上沒(méi)有API服務(wù)調(diào)用的用戶的人臉特征向量數(shù)據(jù)進(jìn)行凍結(jié),確保無(wú)服務(wù)調(diào)用的客戶信息安全。如需解凍,請(qǐng)通過(guò)釘釘群(23109592)聯(lián)系我們。