查詢?nèi)四槝颖玖斜?/h1>更新時(shí)間：
本文介紹人臉人體（facebody）類目下的查詢?nèi)四槝颖玖斜鞮istFaceEntities的語(yǔ)法及示例。
功能描述
查詢?nèi)四槝颖玖斜砟芰τ糜诓樵內(nèi)四様?shù)據(jù)庫(kù)中的人臉樣本列表。
- 您可以進(jìn)入在線咨詢獲取在線人工幫助。
- 阿里云視覺(jué)智能開放平臺(tái)視覺(jué)AI能力API接入、接口使用或問(wèn)題咨詢等，請(qǐng)通過(guò)釘釘群（23109592）加入阿里云視覺(jué)智能開放平臺(tái)咨詢?nèi)郝?lián)系我們。
接入指引
1. 注冊(cè)阿里云賬號(hào)：打開阿里云官網(wǎng)，在阿里云官網(wǎng)右上角，單擊立即注冊(cè)，按照操作提示完成賬號(hào)注冊(cè)。
2. 開通能力：請(qǐng)確保您已開通人臉人體服務(wù)，若未開通服務(wù)請(qǐng)立即開通。
本能力支持企業(yè)或個(gè)人認(rèn)證用戶開通。更多實(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. 在線調(diào)試（可選）：您可以通過(guò)OpenAPI Explorer在線調(diào)試能力，查看完整的調(diào)用示例代碼及SDK依賴信息，也可以下載完整的工程。
5. 開發(fā)接入步驟：
- 在SDK總覽中選擇您要接入使用的SDK語(yǔ)言。
- 在對(duì)應(yīng)語(yǔ)言的SDK文檔中找到AI類目為人臉人體（facebody）的SDK包進(jìn)行安裝。
- 參考文檔中提供的示例代碼進(jìn)行適當(dāng)修改后調(diào)用。
6. 客戶端直接調(diào)用：該能力常用的客戶端調(diào)用方式包括以下幾種。
限制說(shuō)明
查詢?nèi)四槝颖玖斜斫涌谔峤蝗蝿?wù)并發(fā)默認(rèn)為2QPS。
計(jì)費(fèi)說(shuō)明
查詢?nèi)四槝颖玖斜砟芰擅赓M(fèi)調(diào)用。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
|
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
| Action | String | 是 | ListFaceEntities | 系統(tǒng)規(guī)定參數(shù)。取值：ListFaceEntities。 |
| DbName | String | 是 | default | 數(shù)據(jù)庫(kù)名稱。 |
| Offset | Integer | 否 | 1 | 起始記錄，取值范圍0~2000。 |
| Limit | Integer | 否 | 50 | 每頁(yè)最多顯示的樣本數(shù)目，取值范圍1~200。 |
| Token | String | 否 | 2 | 當(dāng)查詢結(jié)果超過(guò)2000條時(shí)，需要使用上一次請(qǐng)求返回的Token作為請(qǐng)求下一頁(yè)的參數(shù)。 |
| Labels | String | 否 | 鹿班 | 標(biāo)簽，最多支持10個(gè)標(biāo)簽，多個(gè)標(biāo)簽以英文逗號(hào)（,）分割。 |
| EntityIdPrefix | String | 否 | U1 | 樣本ID前綴，包含數(shù)字、字母和下劃線。 |
| Order | String | 否 | asc | 排列方式。包括asc（升序）和desc（降序）。 |
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
| RequestId | String | DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2 | 請(qǐng)求ID。 |
| Data | Object | 返回的結(jié)果數(shù)據(jù)內(nèi)容。 |
|
| Token | String | 2 | 當(dāng)查詢結(jié)果超過(guò)2000條時(shí)，可以使用Token來(lái)查詢下一頁(yè)的數(shù)據(jù)。 |
| TotalCount | Integer | 200 | 人臉樣本的總數(shù)量。 |
| Entities | Array of Entity | 查詢到的實(shí)體數(shù)據(jù)。 |
|
| DbName | String | default | 人臉樣本所在的數(shù)據(jù)庫(kù)名稱。 |
| EntityId | String | 222 | 實(shí)體ID，如員工編號(hào)。 |
| Labels | String | 鹿班 | 查詢到的人臉數(shù)據(jù)標(biāo)簽。 |
| CreatedAt | Long | 1589203871832 | 人臉樣本的創(chuàng)建時(shí)間。 |
| FaceCount | Integer | 3 | 人臉樣本包含的人臉數(shù)量。 |
| UpdatedAt | Long | 1589203871832 | 人臉樣本的更新時(shí)間。 |
SDK參考
阿里云視覺(jué)AI人臉人體類目下的查詢?nèi)四槝颖玖斜砟芰ν扑]使用SDK調(diào)用，支持多種編程語(yǔ)言，調(diào)用時(shí)請(qǐng)選擇AI類目為人臉人體（facebody）的SDK包，文件參數(shù)通過(guò)SDK調(diào)用可支持本地文件及任意URL，具體可參見(jiàn)SDK總覽。
示例
請(qǐng)求示例
http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=ListFaceEntities //更多關(guān)于訪問(wèn)域名（Endpoint）信息，請(qǐng)參見(jiàn)：http://bestwisewords.com/document_detail/143103.html
&DbName=default
&Offset=1
&<公共請(qǐng)求參數(shù)>正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2</RequestId>
<Data>
<Token>2</Token>
<TotalCount>200</TotalCount>
<Entities>
<DbName>default</DbName>
<EntityId>222</EntityId>
<FaceCount>3</FaceCount>
<Labels>鹿班</Labels>
<CreatedAt>1589203871832</CreatedAt>
<UpdatedAt>1589203871832</UpdatedAt>
</Entities>
</Data>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "DA7CAFEB-0A37-4496-9CDF-E3DBB6309CB2",
"Data" : {
"Token" : "2",
"TotalCount" : "200",
"Entities" : [ {
"DbName" : "default",
"EntityId" : "222",
"FaceCount" : "3",
"Labels" : "鹿班",
"CreatedAt" : "1589203871832",
"UpdatedAt" : "1589203871832"
} ]
}
}錯(cuò)誤碼
關(guān)于查詢?nèi)四槝颖玖斜淼腻e(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)系我們。