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

功能描述

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

前提条件

请确保您已开通人脸人体服务,详情请参见服务开通

输入限制

  • 图片格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
  • 图片大小:大小不超过10MB。如您有大图需求,请提工单申请。
  • 图片像素:建议不低于256×256,像素过低可能会影响识别效果。
  • URL地址中不能包含中文字符。

检测说明

  • 最长检测时间是6秒,如果在该时间限制内没有完成检测,系统会返回超时错误码。
  • 图片下载时间限制为3秒,如果下载时间超过3秒,系统返回下载超时。
  • 图片检测接口响应时间依赖图片的下载时间。请保证被检测图片所在的存储服务稳定可靠,建议您使用阿里云OSS存储或者CDN缓存。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String RecognizePublicFace

要执行的操作。取值:RecognizePublicFace。

Task.N.ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/facebody/RecognizePublicFace/u%3D2802364678%2C591996814%26fm%3D26%26gp%3D0.jpg

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

说明 对于该接口,系统会自动将OSS链接地址转成内网地址然后再下载文件,所以调用该接口并不会产生OSS流量计费。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

Elements Array

返回识别的元素。

ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/facebody/RecognizePublicFace/u%3D2802364678%2C591996814%26fm%3D26%26gp%3D0.jpg

对应请求中的图像URL地址。

Results Array

返回结果。调用成功时返回结果中包含一个或多个元素。

Label String sface

检测结果的分类,取值包括:

  • normal:正常图片,不包含敏感人脸。
  • sface:图片中包含敏感人脸。
Rate Float 82.83

检测结果的置信度,取值范围为[0.00-100.00]。值越高,表示属于该分类的概率越大。

SubResults Array

识别出来的人脸信息列表。

Faces Array

识别出的人脸信息。

Id String AliFace_0018407

人脸ID。

Name String 唐纳德·特朗普

识别出的相似人物名称。

Rate Float 82.83

相似概率。

H Float 149

人脸区域高度。

W Float 149

人脸区域宽度。

X Float 209

以图片左上角为坐标原点,人脸区域左上角到x轴距离。

Y Float 149

以图片左上角为坐标原点,人脸区域左上角到y轴距离。

Suggestion String review

建议您执行的操作,取值包括:

  • pass:图片正常,无需进行其余操作。
  • review:检测结果不确定,需要进行人工审核。
  • block:图片违规,建议执行进一步操作(如直接删除或做限制处理)。
TaskId String img3Isx9s$hX7b4GvSz@@zsef-1s81Qx

该检测任务的ID。

RequestId String 9915EE74-718B-494D-A702-7355ACD07939

请求ID。

示例

请求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=RecognizePublicFace
&Task.1.ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/facebody/RecognizePublicFace/u%3D2802364678%2C591996814%26fm%3D26%26gp%3D0.jpg
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>9915EE74-718B-494D-A702-7355ACD07939</RequestId>
<Data>
    <Elements>
        <TaskId>img3Isx9s$hX7b4GvSz@@zsef-1s81Qx</TaskId>
        <Suggestion>review</Suggestion>
        <Results>
            <Rate>82.83</Rate>
            <Label>sface</Label>
            <SubResults>
                <W>149</W>
                <H>149</H>
                <X>209</X>
                <Y>149</Y>
                <Faces>
                    <Rate>82.83</Rate>
                    <Id>AliFace_0018407</Id>
                    <Name>唐纳德·特朗普</Name>
                </Faces>
            </SubResults>
        </Results>
        <ImageURL>https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/facebody/RecognizePublicFace/u%3D2802364678%2C591996814%26fm%3D26%26gp%3D0.jpg</ImageURL>
    </Elements>
</Data>

JSON 格式

{
    "RequestId": "9915EE74-718B-494D-A702-7355ACD07939",
    "Data": {
        "Elements": [
            {
                "TaskId": "img3Isx9s$hX7b4GvSz@@zsef-1s81Qx",
        "Suggestion": "review",
                "Results": [{
                    "Rate": 82.83,
                    "Label": "sface",
                    "SubResults": [{
                        "W": 149,
                        "H": 149,
                        "X": 209,
                        "Y": 149,
                        "Faces": [{
                            "Rate": 82.83,
                            "Id": "AliFace_0018407",
                            "Name": "唐纳德·特朗普"
                        }]
                    }]
                }],
                "ImageURL": "https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/facebody/RecognizePublicFace/u%3D2802364678%2C591996814%26fm%3D26%26gp%3D0.jpg"
            }
        ]
    }
}

错误码

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

SDK参考

单击SDK简介查看SDK信息。