智能创作
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 智能创作 > 客户端 API > 媒体物料相关接口 > 查询人脸识别结果

查询人脸识别结果

最近更新时间：2022-03-23 17:12:36

我的收藏

本页目录：

接口描述

接口名称：/Material/DescribeFaceInMaterial。
接口功能：查询媒体人脸识别结果。

调用方式

具体调用方式参见 客户端 API 调用方式综述，您也可以使用 CME 客户端 API 调试工具 快速进行调试。

输入参数

字段
类型
必填
描述
MaterialId
String
是
媒体 ID。

输出参数

接口输出参数由 公共返回参数 和接口自身返回参数两部分组成。接口自身返回参数详情如下。
字段
类型
描述
FaceInfo
人脸信息。

示例

示例1：查询媒体人脸识别结果成功

查询媒体 ID 为38192156030633420589人脸识别结果，返回人脸识别信息。

输入示例

{
    "MaterialId": "38192156030633420589"
}

输出示例

{
    "Code": "Success",
    "Message": "成功",
    "EnglishMessage": "success",
    "Data": {
        "FaceInfo": {
            "Version": "5fd977677a23b40001ca3afa",
            "FaceSet": [
                {
                    "Id ": "12410",
                    "Name": "黄晓明",
                    "Type": "Default",
                    "FaceUrl": "http://host/path",
                    "SegmentSet": [
                        {
                            "StartTimeOffset": 1.0,
                            "EndTimeOffset": 2.0,
                            "AreaCoordSet": [
                                100,
                                120,
                                130,
                                140
                            ],
                            "Confidence": 96.7
                        },
                        {
                            "StartTimeOffset": 10.0,
                            "EndTimeOffset": 11.0,
                            "AreaCoordSet": [
                                105,
                                120,
                                135,
                                140
                            ],
                            "Confidence": 96.7
                        }
                    ]
                }
            ]
        }
    }
}

示例2：查询媒体人脸识别结果失败

查询媒体 ID 为38192156030633420589人脸识别结果，返回失败。

输入示例

{
    "MaterialId": "38192156030633420589"
}

输出示例

{
    "Code": "ResourceNotFound",
    "Message": "资源不存在",
    "EnglishMessage": "resource not found : no face index"
}
<!-- 注意：本文档由 gen_client_api_from_core.sh 脚本自动生成，如有修改需求，请阅读 readme.md -->
中国站