本文介紹人臉人體（facebody）類目下的公眾人物識別RecognizePublicFace的語法及示例。

功能描述

公眾人物識別能力可以識別圖片中的一個或多個公眾人物信息。

公眾人物是指在一定范圍內具有重要影響力、擁有一定的社會地位、被大眾廣泛關注、且能因此從社會中得到巨大利益、與社會公共利益密切相關的人物，如領導人、科學家、企業家或社會活動家等。

說明
  • 在同時檢測多個Task的情況下，將按照Task的個數進行累計計費。
  • 您可以進入在線咨詢獲取在線人工幫助。
  • 當前能力可在視覺智能開放平臺有完整的免費產品體驗，您可以單擊立即試用對該能力進行更直觀試用以及在線購買。
  • 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等，請通過釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢群聯系我們。

應用場景

  • 用戶內容審核：檢查識別用戶提交的圖片和視頻中是否存在公眾人物，識別是否存在法律風險。
  • 視頻圖片檢索：對公眾人物有關的視頻圖片內容進行識別并設置標簽，用戶可以通過公眾人物姓名等檢索查找出與其有關的視頻和圖片。

特色優勢

能夠準確識別出圖像中的一個或多個公眾人物信息。

接入指引

1. 注冊阿里云賬號：打開阿里云官網，在阿里云官網右上角，單擊立即注冊，按照操作提示完成賬號注冊。

2. 開通能力：

重要

本能力僅限企業認證用戶開通。更多實名認證操作信息，請參見實名認證。

3. 創建AccessKey：請確保您已創建AccessKey，如果您使用的是子賬號AccessKey，您需要給子賬號賦予AliyunVIAPIFullAccess權限，具體操作，請參見RAM授權。

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

5. 開發接入步驟：

  • 在SDK總覽中選擇您要接入使用的SDK語言。
  • 在對應語言的SDK文檔中找到AI類目為人臉人體（facebody）的SDK包進行安裝。
  • 參考文檔中提供的示例代碼進行適當修改后調用。

6. 示例代碼：該能力常用語言的示例代碼，請參見公眾人物識別示例代碼。

7. 客戶端直接調用：該能力常用的客戶端調用方式包括以下幾種。

輸入限制

  • 圖像格式：PNG、JPG、JPEG、BMP、GIF、WEBP。
  • 圖像大小：不超過10 MB。如您有大圖需求，請通過釘釘群（23109592）聯系我們。
  • 圖像分辨率：建議不低于256×256像素，像素過低可能會影響識別效果。
  • URL地址中不能包含中文字符。
說明 當圖像分辨率超過最大限制時，請先將圖片進行縮放，調整圖片大小，具體請參見圖片縮放。

檢測說明

  • 最長檢測時間是6秒，如果在該時間限制內沒有完成檢測，系統會返回超時錯誤碼。
  • 圖像下載時間限制為3秒，如果下載時間超過3秒，系統返回下載超時。
  • 圖像檢測接口響應時間依賴圖片的下載時間。請保證被檢測圖像所在的存儲服務穩定可靠，建議您使用阿里云OSS存儲或者CDN緩存。
  • 最多可檢測10張圖像。

計費說明

關于公眾人物識別的計費方式及報價，請參見計費介紹。

說明 下方調試接口為付費接口，如需免費體驗調試請前往體驗中心。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 RecognizePublicFace

系統規定參數。取值：RecognizePublicFace。
Task.N.ImageURL String 否 https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg

待檢測的圖像URL地址。JSON數組中的每個元素是一個圖片檢測任務結構體（image表）。最多支持10個元素，即最多同時對10張圖片進行檢測。推薦使用上海地域的OSS鏈接，對于文件在本地或者非上海地域OSS鏈接的情況，請參見文件URL處理。

說明 對于該接口，系統會自動將OSS鏈接地址轉成內網地址然后再下載文件，所以調用該接口并不會產生OSS流量計費。
Task.N.ImageData String 否 /9j/4AAQSkZJRgABAQAAAQABAAD/2****9j/4AAQSkZJRgABAQAAAQABAAD/2****

圖像Base64編碼字符串。當與URL方式共存時，URL方式優先。

文件的Base64編碼處理操作，請參見文件Base64處理。

返回數據

名稱 類型 示例值 描述
RequestId String AC4D107C-29E3-4873-A719-0D2217EA28A8

請求ID。
Data Object

返回的結果數據內容。
Elements Array of Element

返回識別的元素。
ImageURL String https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg

對應請求中的圖像URL地址。
TaskId String img3dhYqt1e4wO77Wnf2y@t@E-1tYAEt

該檢測任務的ID。
Results Array of Result

返回結果。調用成功時返回結果中包含一個或多個元素。
Suggestion String review

建議您執行的操作，取值包括：

  • pass：圖片正常，無需進行其余操作。
  • review：檢測結果不確定，需要進行人工審核。
  • block：圖片違規，建議執行進一步操作（如直接刪除或做限制處理）。
Label String sface

檢測結果的分類，取值包括：

  • normal：正常圖片，不包含敏感人臉。
  • sface：圖片中包含敏感人臉。
SubResults Array of SubResult

識別出來的人臉信息列表。
W Float 132

人臉區域寬度。
Faces Array of Face

識別出的人臉信息。
Name String 張三

識別出的相似人物名稱。
Id String AliFace_0006272

人臉ID。
Rate Float 98.35

相似概率。
H Float 153

人臉區域高度。
Y Float 153

以圖片左上角為坐標原點，人臉區域左上角到y軸距離。
X Float 182

以圖片左上角為坐標原點，人臉區域左上角到x軸距離。
Rate Float 98.35

檢測結果的置信度，取值范圍為[0.00,100.00]。值越高，表示屬于該分類的概率越大。

SDK參考

阿里云視覺AI人臉人體類目下的公眾人物識別能力推薦使用SDK調用，支持多種編程語言，調用時請選擇AI類目為人臉人體（facebody）的SDK包，文件參數通過SDK調用可支持本地文件及任意URL，具體可參見SDK總覽。

示例代碼

該能力常用語言的示例代碼，請參見公眾人物識別示例代碼。

示例

請求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=RecognizePublicFace        //更多關于訪問域名（Endpoint）信息，請參見：http://m.bestwisewords.com/document_detail/143103.html
&Task=[{"ImageURL":"https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg","ImageData":"/9j/4AAQSkZJRgABAQAAAQABAAD/2****"}]
&公共請求參數

正常返回示例

XML格式

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

<RecognizePublicFaceResponse>
    <RequestId>AC4D107C-29E3-4873-A719-0D2217EA28A8</RequestId>
    <Data>
        <Elements>
            <ImageURL>https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg</ImageURL>
            <TaskId>img3dhYqt1e4wO77Wnf2y@t@E-1tYAEt</TaskId>
            <Results>
                <Suggestion>review</Suggestion>
                <Label>sface</Label>
                <SubResults>
                    <W>132</W>
                    <Faces>
                        <Name>張三</Name>
                        <Id>AliFace_0006272</Id>
                        <Rate>98.35</Rate>
                    </Faces>
                    <H>153</H>
                    <Y>153</Y>
                    <X>182</X>
                </SubResults>
                <Rate>98.35</Rate>
            </Results>
        </Elements>
    </Data>
</RecognizePublicFaceResponse>

JSON格式

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

{
  "RequestId" : "AC4D107C-29E3-4873-A719-0D2217EA28A8",
  "Data" : {
    "Elements" : [ {
      "ImageURL" : "https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/xxx.jpg",
      "TaskId" : "img3dhYqt1e4wO77Wnf2y@t@E-1tYAEt",
      "Results" : [ {
        "Suggestion" : "review",
        "Label" : "sface",
        "SubResults" : [ {
          "W" : 132,
          "Faces" : [ {
            "Name" : "張三",
            "Id" : "AliFace_0006272",
            "Rate" : 98.35
          } ],
          "H" : 153,
          "Y" : 153,
          "X" : 182
        } ],
        "Rate" : 98.35
      } ]
    } ]
  }
}

錯誤碼

關于公眾人物識別的錯誤碼，詳情請參見常見錯誤碼。

開源模型體驗

更多開源免費模型體驗及下載，詳見魔搭社區：人臉識別OOD模型、ArcFace人臉識別模型、IR人臉識別模型FRIR、口罩人臉識別模型FRFM-large、口罩人臉識別模型FaceMask。

安全聲明

  • 請確保上傳的圖片或文件來源符合相應的法律法規。
  • 通過體驗調試上傳的臨時文件有效期為1小時，在24小時后會被系統自動清理刪除。
  • 平臺不存儲用戶在使用服務過程中涉及的原始人臉圖片或文件信息。