人脸检测及属性分析

服务简介 :

本服务提供以下功能:
•人脸检测:检测出图片中人脸及标记出位置信息。
•人脸关键点:找出人脸的核心关键点信息,及68个关键点信息。

应用场景 :

人脸属性分析,基于人脸关键点的加工分析,人脸营销活动等等。



接口地址 : http://www.tudatech.com:7080/wztimgsvr/faceapi/faceDetect

图片格式要求: JPG格式,图像长及宽约300 – 1200 像素图片

请求方法 :POST

请求参数(body) :

参数名 类型 必填 参数位置 描述 默认值
apikey string body API密钥
returntype string body 0 – 返回最详细所有信息;
1 – 只返回简单识别出人脸位置信息;
2 – 返回更多人脸关键点信息; 不包括所有68关键点信息.
0
fmt string body 返回结果格式: json或xml json

参数名 类型 必填 参数位置 描述 默认值
photo file body 图片文件


详细使用教程



接口地址 : http://www.tudatech.com:7080/wztimgsvr/faceapi/faceDetect

图片格式要求: JPG格式,图像长及宽约300 – 1200 像素图片

请求方法 : POST

请求参数(body) :

参数名 类型 必填 参数位置 描述 默认值
apikey string body API密钥
imgurl string body 图片地址URL

其他非必填参数与POST请求方法相同



JSON返回示例 :

{"class":"face.api.VseFaceDetectResults","facesNum":1,"facesTotalEntity":[{"class":"face.api.VseFaceEntry","faceBox":{"bottom":192,"class":"face.api.VseFaceBox","left":158,"right":261,"top":89},"facePoints68":[{"class":"face.api.VseFaceLandmark","index":1,"nameStr":null,"x":176.0,"y":127.0},{"class":"face.api.VseFaceLandmark","index":2,"nameStr":null,"x":176.0,"y":137.0},{"class":"face.api.VseFaceLandmark","index":3,"nameStr":null,"x":177.0,"y":147.0},{"class":"face.api.VseFaceLandmark","index":4,"nameStr":null,"x":180.0,"y":157.0},{"class":"face.api.VseFaceLandmark","index":5,"nameStr":null,"x":185.0,"y":167.0},{"class":"face.api.VseFaceLandmark","index":6,"nameStr":null,"x":190.0,"y":175.0},{"class":"face.api.VseFaceLandmark","index":7,"nameStr":null,"x":196.0,"y":183.0},{"class":"face.api.VseFaceLandmark","index":8,"nameStr":null,"x":201.0,"y":190.0},{"class":"face.api.VseFaceLandmark","index":9,"nameStr":null,"x":209.0,"y":193.0},{"class":"face.api.VseFaceLandmark","index":10,"nameStr":null,"x":219.0,"y":193.0},{"class":"face.api.VseFaceLandmark","index":11,"nameStr":null,"x":230.0,"y":188.0},{"class":"face.api.VseFaceLandmark","index":12,"nameStr":null,"x":241.0,"y":182.0},{"class":"face.api.VseFaceLandmark","index":13,"nameStr":null,"x":251.0,"y":174.0},{"class":"face.api.VseFaceLandmark","index":14,"nameStr":null,"x":258.0,"y":164.0},{"class":"face.api.VseFaceLandmark","index":15,"nameStr":null,"x":262.0,"y":152.0},{"class":"face.api.VseFaceLandmark","index":16,"nameStr":null,"x":264.0,"y":140.0},{"class":"face.api.VseFaceLandmark","index":17,"nameStr":null,"x":266.0,"y":127.0},{"class":"face.api.VseFaceLandmark","index":18,"nameStr":null,"x":176.0,"y":116.0},{"class":"face.api.VseFaceLandmark","index":19,"nameStr":null,"x":179.0,"y":112.0},{"class":"face.api.VseFaceLandmark","index":20,"nameStr":null,"x":185.0,"y":111.0},{"class":"face.api.VseFaceLandmark","index":21,"nameStr":null,"x":191.0,"y":113.0},{"class":"face.api.VseFaceLandmark","index":22,"nameStr":null,"x":197.0,"y":116.0},{"class":"face.api.VseFaceLandmark","index":23,"nameStr":null,"x":214.0,"y":117.0},{"class":"face.api.VseFaceLandmark","index":24,"nameStr":null,"x":223.0,"y":114.0},{"class":"face.api.VseFaceLandmark","index":25,"nameStr":null,"x":232.0,"y":113.0},{"class":"face.api.VseFaceLandmark","index":26,"nameStr":null,"x":240.0,"y":115.0},{"class":"face.api.VseFaceLandmark","index":27,"nameStr":null,"x":248.0,"y":119.0},{"class":"face.api.VseFaceLandmark","index":28,"nameStr":null,"x":205.0,"y":128.0},{"class":"face.api.VseFaceLandmark","index":29,"nameStr":null,"x":203.0,"y":136.0},{"class":"face.api.VseFaceLandmark","index":30,"nameStr":null,"x":201.0,"y":144.0},{"class":"face.api.VseFaceLandmark","index":31,"nameStr":null,"x":200.0,"y":151.0},{"class":"face.api.VseFaceLandmark","index":32,"nameStr":null,"x":196.0,"y":156.0},{"class":"face.api.VseFaceLandmark","index":33,"nameStr":null,"x":199.0,"y":158.0},{"class":"face.api.VseFaceLandmark","index":34,"nameStr":null,"x":202.0,"y":160.0},{"class":"face.api.VseFaceLandmark","index":35,"nameStr":null,"x":207.0,"y":159.0},{"class":"face.api.VseFaceLandmark","index":36,"nameStr":null,"x":212.0,"y":157.0},{"class":"face.api.VseFaceLandmark","index":37,"nameStr":null,"x":182.0,"y":126.0},{"class":"face.api.VseFaceLandmark","index":38,"nameStr":null,"x":187.0,"y":122.0},{"class":"face.api.VseFaceLandmark","index":39,"nameStr":null,"x":193.0,"y":122.0},{"class":"face.api.VseFaceLandmark","index":40,"nameStr":null,"x":198.0,"y":129.0},{"class":"face.api.VseFaceLandmark","index":41,"nameStr":null,"x":192.0,"y":130.0},{"class":"face.api.VseFaceLandmark","index":42,"nameStr":null,"x":186.0,"y":129.0},{"class":"face.api.VseFaceLandmark","index":43,"nameStr":null,"x":220.0,"y":130.0},{"class":"face.api.VseFaceLandmark","index":44,"nameStr":null,"x":226.0,"y":124.0},{"class":"face.api.VseFaceLandmark","index":45,"nameStr":null,"x":233.0,"y":124.0},{"class":"face.api.VseFaceLandmark","index":46,"nameStr":null,"x":238.0,"y":129.0},{"class":"face.api.VseFaceLandmark","index":47,"nameStr":null,"x":233.0,"y":131.0},{"class":"face.api.VseFaceLandmark","index":48,"nameStr":null,"x":226.0,"y":131.0},{"class":"face.api.VseFaceLandmark","index":49,"nameStr":null,"x":193.0,"y":165.0},{"class":"face.api.VseFaceLandmark","index":50,"nameStr":null,"x":197.0,"y":164.0},{"class":"face.api.VseFaceLandmark","index":51,"nameStr":null,"x":201.0,"y":164.0},{"class":"face.api.VseFaceLandmark","index":52,"nameStr":null,"x":204.0,"y":165.0},{"class":"face.api.VseFaceLandmark","index":53,"nameStr":null,"x":208.0,"y":164.0},{"class":"face.api.VseFaceLandmark","index":54,"nameStr":null,"x":217.0,"y":165.0},{"class":"face.api.VseFaceLandmark","index":55,"nameStr":null,"x":227.0,"y":167.0},{"class":"face.api.VseFaceLandmark","index":56,"nameStr":null,"x":218.0,"y":174.0},{"class":"face.api.VseFaceLandmark","index":57,"nameStr":null,"x":210.0,"y":177.0},{"class":"face.api.VseFaceLandmark","index":58,"nameStr":null,"x":205.0,"y":178.0},{"class":"face.api.VseFaceLandmark","index":59,"nameStr":null,"x":201.0,"y":177.0},{"class":"face.api.VseFaceLandmark","index":60,"nameStr":null,"x":197.0,"y":173.0},{"class":"face.api.VseFaceLandmark","index":61,"nameStr":null,"x":195.0,"y":166.0},{"class":"face.api.VseFaceLandmark","index":62,"nameStr":null,"x":201.0,"y":167.0},{"class":"face.api.VseFaceLandmark","index":63,"nameStr":null,"x":205.0,"y":168.0},{"class":"face.api.VseFaceLandmark","index":64,"nameStr":null,"x":209.0,"y":168.0},{"class":"face.api.VseFaceLandmark","index":65,"nameStr":null,"x":224.0,"y":167.0},{"class":"face.api.VseFaceLandmark","index":66,"nameStr":null,"x":209.0,"y":172.0},{"class":"face.api.VseFaceLandmark","index":67,"nameStr":null,"x":205.0,"y":172.0},{"class":"face.api.VseFaceLandmark","index":68,"nameStr":null,"x":201.0,"y":171.0}],"facePointsBrief":[{"class":"face.api.VseFaceLandmark","index":0,"nameStr":"LEFT_EYE","x":189.66667,"y":126.333336},{"class":"face.api.VseFaceLandmark","index":1,"nameStr":"RIGHT_EYE","x":229.33333,"y":128.16667},{"class":"face.api.VseFaceLandmark","index":2,"nameStr":"LEFT_OF_LEFT_EYEBROW","x":176.0,"y":116.0},{"class":"face.api.VseFaceLandmark","index":3,"nameStr":"RIGHT_OF_LEFT_EYEBROW","x":197.0,"y":116.0},{"class":"face.api.VseFaceLandmark","index":4,"nameStr":"LEFT_OF_RIGHT_EYEBROW","x":214.0,"y":117.0},{"class":"face.api.VseFaceLandmark","index":5,"nameStr":"RIGHT_OF_RIGHT_EYEBROW","x":214.0,"y":117.0},{"class":"face.api.VseFaceLandmark","index":6,"nameStr":"MIDPOINT_BETWEEN_EYES","x":205.0,"y":128.0},{"class":"face.api.VseFaceLandmark","index":7,"nameStr":"NOSE_TIP","x":200.0,"y":151.0},{"class":"face.api.VseFaceLandmark","index":8,"nameStr":"UPPER_LIP","x":204.0,"y":165.0},{"class":"face.api.VseFaceLandmark","index":9,"nameStr":"LOWER_LIP","x":205.0,"y":178.0},{"class":"face.api.VseFaceLandmark","index":10,"nameStr":"MOUTH_LEFT","x":193.0,"y":165.0},{"class":"face.api.VseFaceLandmark","index":11,"nameStr":"MOUTH_RIGHT","x":227.0,"y":167.0},{"class":"face.api.VseFaceLandmark","index":12,"nameStr":"MOUTH_CENTER","x":205.0,"y":170.0},{"class":"face.api.VseFaceLandmark","index":13,"nameStr":"NOSE_BOTTOM_RIGHT","x":212.0,"y":157.0},{"class":"face.api.VseFaceLandmark","index":14,"nameStr":"NOSE_BOTTOM_LEFT","x":196.0,"y":156.0},{"class":"face.api.VseFaceLandmark","index":15,"nameStr":"NOSE_BOTTOM_CENTER","x":202.0,"y":160.0},{"class":"face.api.VseFaceLandmark","index":16,"nameStr":"LEFT_EYE_TOP_BOUNDARY","x":190.0,"y":122.0},{"class":"face.api.VseFaceLandmark","index":17,"nameStr":"LEFT_EYE_RIGHT_CORNER","x":198.0,"y":129.0},{"class":"face.api.VseFaceLandmark","index":18,"nameStr":"LEFT_EYE_BOTTOM_BOUNDARY","x":189.0,"y":129.5},{"class":"face.api.VseFaceLandmark","index":19,"nameStr":"LEFT_EYE_LEFT_CORNER","x":182.0,"y":126.0},{"class":"face.api.VseFaceLandmark","index":20,"nameStr":"LEFT_EYE_PUPIL","x":189.66667,"y":126.333336},{"class":"face.api.VseFaceLandmark","index":21,"nameStr":"RIGHT_EYE_TOP_BOUNDARY","x":229.5,"y":124.0},{"class":"face.api.VseFaceLandmark","index":22,"nameStr":"RIGHT_EYE_RIGHT_CORNER","x":238.0,"y":129.0},{"class":"face.api.VseFaceLandmark","index":23,"nameStr":"RIGHT_EYE_BOTTOM_BOUNDARY","x":229.5,"y":131.0},{"class":"face.api.VseFaceLandmark","index":24,"nameStr":"RIGHT_EYE_LEFT_CORNER","x":220.0,"y":130.0},{"class":"face.api.VseFaceLandmark","index":25,"nameStr":"RIGHT_EYE_PUPIL","x":229.33333,"y":128.16667},{"class":"face.api.VseFaceLandmark","index":26,"nameStr":"LEFT_EYEBROW_UPPER_MIDPOINT","x":185.0,"y":111.0},{"class":"face.api.VseFaceLandmark","index":27,"nameStr":"RIGHT_EYEBROW_UPPER_MIDPOINT","x":232.0,"y":113.0},{"class":"face.api.VseFaceLandmark","index":28,"nameStr":"CHIN_TIP","x":209.0,"y":193.0}]}]}



错误码参照:


限制类错误:
API_CODE_ERROR_exceeded_access_total 用户总调用量超限
API_CODE_ERROR_exceeded_access_frequency 用户调用频度超限
API_CODE_ERROR_exceeded_access_frequency_min 服务每分钟调用量超限
API_CODE_ERROR_exceeded_access_frequency_hr 服务每小时调用量超限
API_CODE_ERROR_exceeded_access_frequency_day 用户日调用量超限
API_CODE_ERROR_exceeded_access_frequency_month 服务每月调用量超限
API_CODE_ERROR_two_API_calls_time_too_close 两次调用时间太近

调用方法错误:
API_CODE_ERROR_invalid_apikey Apikey错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgName 图片名错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgUrl 图片URL错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_LANG 语言参数错误(中文zh 或英语en)
IMAGE_INDEX_CODE_ERROR_IMAGE_SIZE_TOO_BIG 图片太大(最好在400 – 800PIX JPG 图片)