本文介绍公众人物识别RecognizePublicFace的语法及示例。

功能描述

公众人物识别可以识别图片中的一个或多个公众人物信息。

应用场景

  • 用户内容审核:检查识别用户提交的图片和视频中是否存在公众人物,识别是否存在法律风险。
  • 视频图片检索:对公众人物有关的视频图片内容进行识别并设置标签,用户可以通过公众人物姓名等检索查找出与其有关的视频和图片。

特色优势

能够准确识别出图像中的一个或多个公众人物信息。

前提条件

请确保您已开通人脸人体服务,若未开通服务请立即开通

输入限制

  • 图像格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
  • 图像大小:不超过10MB。如您有大图需求,请提工单申请。
  • 图像分辨率:建议不低于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/alimay.jpg

待检测的图像URL地址。JSON数组中的每个元素是一个图片检测任务结构体(image表)。最多支持10个元素,即最多同时对10张图片进行检测。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

说明 对于该接口,系统会自动将OSS链接地址转成内网地址然后再下载文件,所以调用该接口并不会产生OSS流量计费。
Task.N.ImageData String 9j/4AAQSkZJRgABAQAAAQABAAD/2****

图像Base64编码字符串。当与URL方式共存时,URL方式优先。

返回数据

名称 类型 示例值 描述
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/alimay.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]。值越高,表示属于该分类的概率越大。

示例

请求示例

http(s)://[Endpoint]/?Action=RecognizePublicFace
&Task.1.ImageURL=https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/facebody/alimay.jpg
&<公共请求参数>

正常返回示例

XML格式

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

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

JSON格式

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

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

错误码

关于公众人物识别的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。