调用DetectImageFaces接口检测图片中的人脸及人脸信息。
接口说明
-
此接口已不再维护，建议使用新版（2020-09-30 版本）接口 DetectImageFaces 。关于新版与旧版 API 的对比，请参见新旧版本使用指引中的新版与旧版 API 对应关系说明章节。
-
此接口不依赖媒体集。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| imm:DetectImageFaces | *全部资源 * |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Project | string | 是 | 项目名称。 | immimagetest |
| ImageUri | string | 是 | 图片的 OSS URI。 OSS 地址规则为 | oss://imm-test/testcases/facetest.jpg |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "D2C628B8-35DF-473C-8A41-757F30202ADC",
"ImageUri": "oss://imm-test/testcases/facetest.png",
"Faces": [
{
"AttractiveConfidence": 0.9321795701980591,
"Gender": "FEMALE",
"GenderConfidence": 1,
"FaceId": "59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51",
"FaceAttributes": {
"GlassesConfidence": 1,
"Glasses": "NONE",
"Mask": "NONE",
"BeardConfidence": 1,
"MaskConfidence": 1,
"FaceBoundary": {
"Top": 191,
"Width": 269,
"Height": 252,
"Left": 95
},
"HeadPose": {
"Pitch": 18.38559913635254,
"Roll": 4.204077243804932,
"Yaw": 2.49458646774292
},
"Beard": "NONE"
},
"FaceQuality": 0.9321795701980591,
"Emotion": "HAPPY",
"Age": 29,
"FaceConfidence": 0.960875928401947,
"EmotionConfidence": 0.7078456878662109,
"Attractive": 0.96,
"AgeConfidence": 0.9321795701980591,
"EmotionDetails": {
"HAPPY": 0.7078456878662109,
"CALM": 0.2919808030128479,
"SURPRISED": 0.00006672900053672493,
"DISGUSTED": 0.00003373104118509218,
"ANGRY": 0.000012824941222788766,
"SAD": 0.00001525594689155696,
"SCARED": 0.0000014968593404773856
}
}
]
}错误码
访问错误中心查看更多错误码。