swan.ai.faceDetect

    解释：人脸检测，检测图片中的人脸并标记出相应的信息位置，同时可以展示出人脸的关键信息和属性信息，比如年龄，性别等。使用本功能需要小程序开发者后台登录超级管理员账号，点击云平台付费链接开通云账号付费功能。

    Object object

    success 返回参数说明

    参数名参数类型说明
    log_idNumber唯一的log id，用于问题定位。
    error_noNumber错误码，错误码为0时，人脸检测成功。
    error_msgString错误描述信息，帮助理解和解决发生的错误。
    face_numNumber检测到图片中的人脸数量
    face_listArray人脸信息列表

    face_list 参数说明

    参数名参数类型说明
    face_tokenstring人脸图片的唯一标识
    locationObject人脸在图片中的位置
    face_probabilitynumber人脸置信度，范围[0~1]，代表这是一张人脸的概率，0最小、1最大。
    angelObject人脸旋转角度参数
    agenumber年龄，当 face_field 包含 age 时返回。
    beautynumber美丑打分，范围 [0-100]，越大表示越美，当 face_fields 包含 beauty 时返回。
    expressionObject表情，当 face_field 包含 expression 时返回。
    face_shapeObject脸型，当 face_field 包含 face_shape 时返回。
    genderObject性别，face_field 包含 gender 时返回。
    glassesObject是否带眼镜，face_field 包含 glasses 时返回。
    eye_statusObject双眼状态（睁开/闭合）face_field 包含 eye_status 时返回。
    emotionObject情绪，face_field 包含 emotion 时返回。
    raceObject人种 face_field 包含 race 时返回。
    face_typeObject真实人脸/卡通人脸 face_field 包含 face_type 时返回。
    landmarkObject4 个关键点位置，左眼中心、右眼中心、鼻尖、嘴中心。face_field 包含 landmark 时返回。
    qualityObject人脸质量信息，face_field 包含 quality 时返回。

    location 返回值说明

    参数名参数类型说明
    leftnumber人脸区域离左边界的距离
    topnumber人脸区域离上边界的距离
    widthnumber人脸区域的宽度
    heightnumber人脸区域的高度
    rotationnumber人脸框相对于竖直方向的顺时针旋转角，[-180,180]。

    angel 返回值说明

    参数名参数类型说明
    yawnumber三维旋转之左右旋转角[-90(左), 90(右)]。
    pitchnumber三维旋转之俯仰角度[-90(上), 90(下)]。
    rollnumber平面内旋转角[-180(逆时针), 180(顺时针)]。

    expression 返回值说明

    face_shape 返回值说明

    参数名参数类型说明
    typestringsquare: 正方形；triangle:三角形；oval: 椭圆；heart: 心形；round: 圆形。
    probabilitynumber置信度，范围 [0~1]，代表这是人脸形状判断正确的概率，0 最小、1 最大。
    参数名参数类型说明
    typestringmale:男性；female:女性。
    probabilitynumber性别置信度，范围[0~1]，0 代表概率最小、1 代表最大。

    glasses 返回值说明

    参数名参数类型说明
    typestringnone:无眼镜；common:普通眼镜；sun:墨镜。
    probabilitynumber眼镜置信度，范围 [0~1]，0 代表概率最小、1 代表最大。

    eye_status 返回值说明

    参数名参数类型说明
    left_eyenumber左眼状态 [0,1] 取值，越接近 0 闭合的可能性越大。
    right_eyenumber右眼状态 [0,1] 取值，越接近 0 闭合的可能性越大。

    emotion 返回值说明

    race 返回值说明

    参数名参数类型说明
    typestringyellow: 黄种人；white: 白种人；black:黑种人；arabs: 阿拉伯人。
    probabilitynumber人种置信度，范围[0~1]，0 代表概率最小、1 代表最大。

    face_type 返回值说明

    参数名参数类型说明
    typestringhuman: 真实人脸； cartoon: 卡通人脸。
    probabilitynumber人脸类型判断正确的置信度，范围[0~1]，0 代表概率最小、1 代表最大。

    landmark 返回值说明

    参数名参数类型说明
    landmark72Array72 个特征点位置 face_field 包含 landmark72 时返回。
    landmark150Array150 个特征点位置 face_field 包含 landmark150 时返回。
    参数名参数类型说明
    occlusionnumber人脸各部分遮挡的概率，范围 [0~1]，0 表示完整，1 表示不完整。
    blurnumber人脸模糊程度，范围 [0~1]，0 表示清晰，1 表示模糊。
    illuminationnumber取值范围在 [0~255], 表示脸部区域的光照程度越大表示光照越好。
    completenessnumber人脸完整度，0 或 1, 0 为人脸溢出图像边界，1 为人脸都在图像边界内。

    occlusion 返回值说明

    示例

    图片示例

    swan.ai.faceDetect - 图3

    代码示例1 - image_type为BASE64 ：

    代码示例2 - image_type为URL ：

    代码示例3 - image_type为FACE_TOKEN: ：

    返回值示例