调用DetectImageFaces接口检测图片中的人脸及人脸信息。

接口说明

该接口不依赖媒体集。

调试

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

请求参数

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

操作接口名称,固定取值为DetectImageFaces。

ImageUri String oss://imm-test/testcases/facetest.jpg

图片的OSS URI。

OSS地址规则为oss://bucket/object,其中bucket为和当前项目处于同一区域的OSS Bucket名称,object为文件路径。

Project String immimagetest

项目名称。

RegionId String cn-hangzhou

项目所在地域的ID。

地域Endpoint格式为imm.RegionId.aliyuncs.com,例如当RegionId为cn-hangzhou时,地域Endpoint为imm.cn-hangzhou.aliyuncs.com。

返回数据

名称 类型 示例值 描述
Faces Array of Faces

人脸识别结果列表。

Age Integer 29

年龄。

AgeConfidence Float 0.9321795701980591

当前版本不支持此参数。

年龄置信度。

Attractive Float 0.96

人脸吸引力,分数越高吸引力越强,取值范围为0~1。

AttractiveConfidence Float 0.9321795701980591

当前版本不支持此参数。

人脸吸引力置信度。

Emotion String HAPPY

心情。

EmotionConfidence Float 0.7078456878662109

心情置信度。

EmotionDetails Struct

七种心情对应的置信度。

ANGRY Float 0.000012824941222788766

ANGRY心情置信度。

CALM Float 0.2919808030128479

CALM心情置信度。

DISGUSTED Float 0.00003373104118509218

DISGUSTED心情置信度。

HAPPY Float 0.7078456878662109

HAPPY心情置信度。

SAD Float 0.00001525594689155696

SAD心情置信度。

SCARED Float 0.0000014968593404773856

SCARED心情置信度。

SURPRISED Float 0.00006672900053672493

SURPRISED心情置信度。

FaceAttributes Struct

人脸其他属性。

Beard String NONE

是否有胡子。

BeardConfidence Float 1

是否有胡子置信度。

FaceBoundary Struct

人脸框。

Height Integer 252

人脸框高度。单位为px。

Left Integer 95

顶点X坐标,距离左端距离。单位为px。

Top Integer 191

顶点Y坐标,距离顶端距离。单位为px。

Width Integer 269

人脸框宽度。单位为px。

Glasses String NONE

是否带眼镜。

GlassesConfidence Float 1

是否戴眼镜置信度。

HeadPose Struct

头部朝向。

Pitch Float 18.38559913635254

人脸的俯仰角,取值范围为-180~+180度,可信的范围建议为-30~+30度。

Roll Float 4.204077243804932

内偏转角,取值范围为-180~+180度,可信的建议范围为-45~+45度。

Yaw Float 2.49458646774292

人脸的左右偏转角,取值范围为-180~+180度,可信的范围建议为-80~+80度。

Mask String NONE

是否带口罩。

MaskConfidence Float 1

是否带口罩置信度。

FaceConfidence Float 0.960875928401947

人脸置信度。

FaceId String 59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51

人脸ID。

FaceQuality Float 0.9321795701980591

人脸质量。

Gender String FEMALE

性别,可选项包括MALE和FEMALE。

GenderConfidence Float 1

性别置信度。

ImageUri String oss://imm-test/testcases/facetest.png

图片的OSS URI。

RequestId String D2C628B8-35DF-473C-8A41-757F30202ADC

当次请求的Request ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DetectImageFaces
&ImageUri=oss://imm-test/testcases/facetest.jpg
&Project=immimagetest
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>D2C628B8-35DF-473C-8A41-757F30202ADC</RequestId>
<ImageUri>oss://imm-test/testcases/facetest.png</ImageUri>
<Faces>
    <FaceConfidence>0.960875928401947</FaceConfidence>
    <FaceId>59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51</FaceId>
    <FaceQuality>0.9321795701980591</FaceQuality>
    <Attractive>0.96</Attractive>
    <GenderConfidence>1</GenderConfidence>
    <EmotionConfidence>0.7078456878662109</EmotionConfidence>
    <Emotion>HAPPY</Emotion>
    <Gender>FEMALE</Gender>
    <Age>29</Age>
</Faces>
<Faces>
    <EmotionDetails>
        <CALM>0.2919808030128479</CALM>
        <SCARED>0.0000014968593404773856</SCARED>
        <HAPPY>0.7078456878662109</HAPPY>
        <SURPRISED>0.00006672900053672493</SURPRISED>
        <SAD>0.00001525594689155696</SAD>
        <DISGUSTED>0.00003373104118509218</DISGUSTED>
        <ANGRY>0.000012824941222788766</ANGRY>
    </EmotionDetails>
    <FaceAttributes>
        <Beard>NONE</Beard>
        <FaceBoundary>
            <Left>95</Left>
            <Top>191</Top>
            <Height>252</Height>
            <Width>269</Width>
        </FaceBoundary>
        <BeardConfidence>1</BeardConfidence>
        <HeadPose>
            <Pitch>18.38559913635254</Pitch>
            <Roll>4.204077243804932</Roll>
            <Yaw>2.49458646774292</Yaw>
        </HeadPose>
        <MaskConfidence>1</MaskConfidence>
        <Mask>NONE</Mask>
        <Glasses>NONE</Glasses>
        <GlassesConfidence>1</GlassesConfidence>
    </FaceAttributes>
</Faces>

JSON 格式

{
    "RequestId": "D2C628B8-35DF-473C-8A41-757F30202ADC",
    "ImageUri": "oss://imm-test/testcases/facetest.png",
    "Faces": [
        {
            "FaceConfidence": 0.960875928401947,
            "FaceId": "59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51",
            "FaceQuality": 0.9321795701980591,
            "Attractive": 0.96,
            "GenderConfidence": 1,
            "EmotionConfidence": 0.7078456878662109,
            "Emotion": "HAPPY",
            "Gender": "FEMALE",
            "Age": 29
        },
        {
            "EmotionDetails": {
                "CALM": 0.2919808030128479,
                "SCARED": 0.0000014968593404773856,
                "HAPPY": 0.7078456878662109,
                "SURPRISED": 0.00006672900053672493,
                "SAD": 0.00001525594689155696,
                "DISGUSTED": 0.00003373104118509218,
                "ANGRY": 0.000012824941222788766
            },
            "FaceAttributes": {
                "Beard": "NONE",
                "FaceBoundary": {
                    "Left": 95,
                    "Top": 191,
                    "Height": 252,
                    "Width": 269
                },
                "BeardConfidence": 1,
                "HeadPose": {
                    "Pitch": 18.38559913635254,
                    "Roll": 4.204077243804932,
                    "Yaw": 2.49458646774292
                },
                "MaskConfidence": 1,
                "Mask": "NONE",
                "Glasses": "NONE",
                "GlassesConfidence": 1
            }
        }
    ]
}