功能描述

人臉?biāo)阉髂芰梢愿鶕?jù)輸入圖片，在數(shù)據(jù)庫(kù)中搜索并返回相似的人臉圖片數(shù)據(jù)。單次搜索的人臉總數(shù)最多20萬(wàn)張，單次搜索最多可支持10個(gè)人臉數(shù)據(jù)庫(kù)的同時(shí)搜索（跨庫(kù)搜索）。該能力根據(jù)人臉特征來(lái)進(jìn)行識(shí)別，通過(guò)把人臉圖像特征化，然后比較人臉特征的相似程度。

特色優(yōu)勢(shì)

• 識(shí)別精度高：人臉檢測(cè)識(shí)別等算法精度處于業(yè)內(nèi)領(lǐng)先水平。
• 識(shí)別效率高：毫秒級(jí)響應(yīng)，支持實(shí)時(shí)識(shí)別。

接入指引

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)通。

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ù)名稱(chēng)（DbName）。
• 已通過(guò)添加人臉樣本（AddFaceEntity）接口創(chuàng)建了實(shí)體ID（EntityId）。
• 已通過(guò)添加人臉數(shù)據(jù)（AddFace）接口給數(shù)據(jù)庫(kù)（DbName）下的實(shí)體ID（EntityId）添加了人臉圖片。

5. 在線調(diào)試（可選）：您可以通過(guò)OpenAPI Explorer在線調(diào)試能力，查看完整的調(diào)用示例代碼及SDK依賴信息，也可以下載完整的工程。

6. 開(kāi)發(fā)接入步驟：

• 在SDK總覽中選擇您要接入使用的SDK語(yǔ)言。
• 在對(duì)應(yīng)語(yǔ)言的SDK文檔中找到AI類(lèi)目為人臉人體（facebody）的SDK包進(jìn)行安裝。
• 參考文檔中提供的示例代碼進(jìn)行適當(dāng)修改后調(diào)用。

7. 示例代碼：該能力常用語(yǔ)言的示例代碼，請(qǐng)參見(jiàn)人臉?biāo)阉魇纠a。

8. 客戶端直接調(diào)用：該能力常用的客戶端調(diào)用方式包括以下幾種。

• Web前端直接調(diào)用
• 小程序場(chǎng)景下直接調(diào)用
• Android端直接調(diào)用
• iOS端直接調(diào)用

輸入限制

• 圖像格式：JPG、JPEG、PNG。
• 圖像大小：不超過(guò)5 MB。
• 圖像分辨率：大于32×32像素，小于4096×4096像素。人臉占比不低于64×64像素。
• URL地址中不能包含中文字符。

• 支持圖片中包含最多10個(gè)人臉，超過(guò)部分會(huì)被忽略。

  說(shuō)明 當(dāng)圖像分辨率超過(guò)最大限制時(shí)，請(qǐng)先將圖片進(jìn)行縮放，調(diào)整圖片大小，具體請(qǐng)參見(jiàn)圖片縮放。

計(jì)費(fèi)說(shuō)明

關(guān)于人臉?biāo)阉?:N的計(jì)費(fèi)方式及報(bào)價(jià)，請(qǐng)參見(jiàn)計(jì)費(fèi)介紹。人臉?biāo)阉?:N能力中僅本接口（SearchFace）收費(fèi)，其他接口可免費(fèi)調(diào)用。

請(qǐng)求參數(shù)

返回?cái)?shù)據(jù)

SDK參考

阿里云視覺(jué)AI人臉人體類(lèi)目下的人臉?biāo)阉髂芰ν扑]使用SDK調(diào)用，支持多種編程語(yǔ)言，調(diào)用時(shí)請(qǐng)選擇AI類(lèi)目為人臉人體（facebody）的SDK包，文件參數(shù)通過(guò)SDK調(diào)用可支持本地文件及任意URL，具體可參見(jiàn)SDK總覽。

示例代碼

該能力常用語(yǔ)言的示例代碼，請(qǐng)參見(jiàn)人臉?biāo)阉魇纠a。

示例

請(qǐng)求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=SearchFace      //更多關(guān)于訪問(wèn)域名（Endpoint）信息，請(qǐng)參見(jiàn)：http://bestwisewords.com/document_detail/143103.html
&DbName=default
&ImageUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/SearchFace/SearchFace1.png
&Limit=2
&DbNames=test1,test2,test3
&QualityScoreThreshold=50.0
&MaxFaceNum=5
&公共請(qǐng)求參數(shù)

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SearchFaceResponse>
    <RequestId>4159e64a-0fe8-436c-a8de-ee531555db3c</RequestId>
    <Data>
        <MatchList>
            <FaceItems>
                <EntityId>U1</EntityId>
                <FaceId>001</FaceId>
                <Score>0.892133</Score>
                <ExtraData>王小二</ExtraData>
                <DbName>default</DbName>
                <Confidence>36.820168</Confidence>
            </FaceItems>
            <Location>
                <Width>200</Width>
                <Height>200</Height>
                <Y>6</Y>
                <X>5</X>
            </Location>
            <QualitieScore>71.7349</QualitieScore>
        </MatchList>
    </Data>
</SearchFaceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4159e64a-0fe8-436c-a8de-ee531555db3c",
  "Data" : {
    "MatchList" : [ {
      "FaceItems" : [ {
        "EntityId" : "U1",
        "FaceId" : "001",
        "Score" : 0.892133,
        "ExtraData" : "王小二",
        "DbName" : "default",
        "Confidence" : 36.820168
      } ],
      "Location" : {
        "Width" : 200,
        "Height" : 200,
        "Y" : 6,
        "X" : 5
      },
      "QualitieScore" : 71.7349
    } ]
  }
}

錯(cuò)誤碼

關(guān)于人臉?biāo)阉鞯腻e(cuò)誤碼，詳情請(qǐng)參見(jiàn)常見(jiàn)錯(cuò)誤碼。

開(kāi)源模型體驗(yàn)

更多開(kāi)源免費(fèi)模型體驗(yàn)及下載，詳見(jiàn)魔搭社區(qū)：人臉識(shí)別OOD模型、ArcFace人臉識(shí)別模型、IR人臉識(shí)別模型FRIR、口罩人臉識(shí)別模型FRFM-large、口罩人臉識(shí)別模型FaceMask。

安全聲明

• 請(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)系我們。