表情识别对外开放接口 v1.0

2019-12-16 19:11:03
立即下载
表情识别对外开放接口 v1.0
一、准备工作
1、向太古计算申请对外开放接口调用权限。并会提供调用接口token
二、调用方式
1、采用http POST方式请求接口
header头部:
参数
Accept
application/json
token

url参数:
参数
type
类型(0=网络图片地址,1=base64字符串)
imageUrl
如果type=0的话,传网络图片地址,
type=1的话,就传base64字符串。
返回字段说明:
字段
必选
类型
说明
face_num
int
检测到的图片中的人脸数量
face_list
array
人脸信息列表,具体包含的参数参考下面的列表。
+face_token
string
人脸图片的唯一标识
+location
array
人脸在图片中的位置
++left
double
人脸区域离左边界的距离
++top
double
人脸区域离上边界的距离
++width
double
人脸区域的宽度
++height
double
人脸区域的高度
++rotation
int64
人脸框相对于竖直方向的顺时针旋转角,[-180,180]
+face_probability
double
人脸置信度,范围【0~1】,代表这是一张人脸的概率,0最小、1最大。
+angel
array
人脸旋转角度参数
++yaw
double
三维旋转之左右旋转角[-90(左), 90(右)]
++pitch
double
三维旋转之俯仰角度[-90(上), 90(下)]
++roll
double
平面内旋转角[-180(逆时针), 180(顺时针)]
+age
double
年龄 ,当face_field包含age时返回
+beauty
int64
美丑打分,范围0-100,越大表示越美。当face_fields包含beauty时返回
+expression
array
表情,当 face_field包含expression时返回
++type
string
none:不笑;smile:微笑;laugh:大笑
++probability
double
表情置信度,范围【0~1】,0最小、1最大。
+face_shape
array
脸型,当face_field包含face_shape时返回
++type
double
square: 正方形 triangle:三角形 oval: 椭圆 heart: 心形 round: 圆形
++probability
double
置信度,范围【0~1】,代表这是人脸形状判断正确的概率,0最小、1最大。
+gender
array
性别,face_field包含gender时返回
++type
string
male:男性 female:女性
++probability
double
性别置信度,范围【0~1】,0代表概率最小、1代表最大。
+glasses
array
是否带眼镜,face_field包含glasses时返回
++type
string
none:无眼镜,common:普通眼镜,sun:墨镜
++probability
double
眼镜置信度,范围【0~1】,0代表概率最小、1代表最大。
+eye_status
array
双眼状态(睁开/闭合) face_field包含eye_status时返回
++left_eye
double
左眼状态 [0,1]取值,越接近0闭合的可能性越大
++right_eye
double
右眼状态 [0,1]取值,越接近0闭合的可能性越大
+emotion
array
情绪 face_field包含emotion时返回
++type
string
angry:愤怒 disgust:厌恶 fear:恐惧 happy:高兴
sad:伤心 surprise:惊讶 neutral:无情绪
++probability
double
情绪置信度,范围0~1
+race
array
人种 face_field包含race时返回
++type
string
yellow: 黄种人 white: 白种人 black:黑种人 arabs阿拉伯人
++probability
double
人种置信度,范围【0~1】,0代表概率最小、1代表最大。
+face_type
array
真实人脸/卡通人脸 face_field包含face_type时返回
++type
string
human: 真实人脸 cartoon: 卡通人脸
++probability
double
人脸类型判断正确的置信度,范围【0~1】,0代表概率最小、1代表最大。
+landmark
array
4个关键点位置,左眼中心、右眼中心、鼻尖、嘴中心。face_field包含landmark时返回
+quality
array
人脸质量信息。face_field包含quality时返回
++occlusion
array
人脸各部分遮挡的概率,范围[0~1],0表示完整,1表示不完整
+++left_eye
double
左眼遮挡比例,[0-1] ,1表示完全遮挡
+++right_eye
double
右眼遮挡比例,[0-1] , 1表示完全遮挡
+++nose
double
鼻子遮挡比例,[0-1] , 1表示完全遮挡
+++mouth
double
嘴巴遮挡比例,[0-1] , 1表示完全遮挡
+++left_cheek
double
左脸颊遮挡比例,[0-1] , 1表示完全遮挡
+++right_cheek
double
右脸颊遮挡比例,[0-1] , 1表示完全遮挡
+++chin
double
下巴遮挡比例,,[0-1] , 1表示完全遮挡
++blur
double
人脸模糊程度,范围[0~1],0表示清晰,1表示模糊
++illumination
double
取值范围在[0~255], 表示脸部区域的光照程度 越大表示光照越好
++completeness
int64
人脸完整度,0或1, 0为人脸溢出图像边界,1为人脸都在图像边界内
三、接口调用限制
暂时限定一天请求500次,如需升额请联系我们!