表情識別對外開放接口 v1.0

2019-12-16 19:11:03
立即下載
表情識別對外開放接口 v1.0
一、準(zhǔn)備工作
1、向太古計算申請對外開放接口調(diào)用權(quán)限。并會提供調(diào)用接口token
二、調(diào)用方式
1、采用http POST方式請求接口
header頭部:
參數(shù)
Accept
application/json
token

url參數(shù):
參數(shù)
type
類型(0=網(wǎng)絡(luò)圖片地址,1=base64字符串)
imageUrl
如果type=0的話,傳網(wǎng)絡(luò)圖片地址,
type=1的話,就傳base64字符串。
返回字段說明:
字段
必選
類型
說明
face_num
int
檢測到的圖片中的人臉數(shù)量
face_list
array
人臉信息列表,具體包含的參數(shù)參考下面的列表。
+face_token
string
人臉圖片的唯一標(biāo)識
+location
array
人臉在圖片中的位置
++left
double
人臉區(qū)域離左邊界的距離
++top
double
人臉區(qū)域離上邊界的距離
++width
double
人臉區(qū)域的寬度
++height
double
人臉區(qū)域的高度
++rotation
int64
人臉框相對于豎直方向的順時針旋轉(zhuǎn)角,[-180,180]
+face_probability
double
人臉置信度,范圍【0~1】,代表這是一張人臉的概率,0最小、1最大。
+angel
array
人臉旋轉(zhuǎn)角度參數(shù)
++yaw
double
三維旋轉(zhuǎn)之左右旋轉(zhuǎn)角[-90(左), 90(右)]
++pitch
double
三維旋轉(zhuǎn)之俯仰角度[-90(上), 90(下)]
++roll
double
平面內(nèi)旋轉(zhuǎn)角[-180(逆時針), 180(順時針)]
+age
double
年齡 ,當(dāng)face_field包含age時返回
+beauty
int64
美丑打分,范圍0-100,越大表示越美。當(dāng)face_fields包含beauty時返回
+expression
array
表情,當(dāng) face_field包含expression時返回
++type
string
none:不笑;smile:微笑;laugh:大笑
++probability
double
表情置信度,范圍【0~1】,0最小、1最大。
+face_shape
array
臉型,當(dāng)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
雙眼狀態(tài)(睜開/閉合) face_field包含eye_status時返回
++left_eye
double
左眼狀態(tài) [0,1]取值,越接近0閉合的可能性越大
++right_eye
double
右眼狀態(tài) [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個關(guān)鍵點位置,左眼中心、右眼中心、鼻尖、嘴中心。face_field包含landmark時返回
+quality
array
人臉質(zhì)量信息。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], 表示臉部區(qū)域的光照程度 越大表示光照越好
++completeness
int64
人臉完整度,0或1, 0為人臉溢出圖像邊界,1為人臉都在圖像邊界內(nèi)
三、接口調(diào)用限制
暫時限定一天請求500次,如需升額請聯(lián)系我們!