服务简介 :
本服务提供以下功能:
•人脸检测:检测出图片中人脸及标记出位置信息。
•人脸关键点:找出人脸的核心关键点信息,及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请求方法相同
{"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 图片) |