调用DetectImageFaces接口检测图片中的人脸及人脸信息。
接口说明
该接口不依赖媒体集。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DetectImageFaces |
操作接口名称,固定取值为DetectImageFaces。 |
ImageUri | String | 是 | oss://imm-test/testcases/facetest.jpg |
图片的OSS URI。 OSS地址规则为 |
Project | String | 是 | immimagetest |
项目名称。 |
RegionId | String | 否 | cn-hangzhou |
项目所在地域的ID。 地域Endpoint格式为 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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 |
人脸的俯仰角,取值范围为 |
Roll | Float | 4.204077243804932 |
内偏转角,取值范围为 |
Yaw | Float | 2.49458646774292 |
人脸的左右偏转角,取值范围为 |
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
}
}
]
}
在文档使用中是否遇到以下问题
更多建议
匿名提交