/detect/byimage
描述
检测给定图片(Image)中的所有人脸(Face)的位置和相应的面部属性
- 目前面部属性包括性别(gender), 表情(Expression)
参数
| 参数名 | 参数说明 | |
|---|---|---|
| 必须 | token | 申请应用的token |
| appid | 申请应用时的appid | |
| img[POST] | 通过POST方法上传的二进制数据，原始图片大小需要小于3M | |
| 可选 | mode | 检测模式可以是normal(默认) 或者 oneface 。在oneface模式中，检测器仅找出图片中最大的一张脸。 |
| level | 人脸检测精度，分为低精度(low)，普通(normal)，高精度(high)。 | |
| tag | 可以为图片中检测出的每一张Face指定一个不包含^@,&=*'"等非法字符且不超过255字节的字符串作为tag，相当于备注 |
返回值说明
| 字段 | 类型 | 说明 |
|---|---|---|
| Count | integer | 人脸数量 |
| url | string | 请求中图片的url |
| ImageID | string | 系统中的图片标识符，用于标识用户请求中的图片 |
| faceId | string | 被检测出的每一张人脸都在系统中的标识符 |
| Width | integer | 请求图片的宽度 |
| Height | integer | 请求图片的高度 |
| face | array | 被检测出的人脸的列表 |
| position | object | 包含人脸位置信息的json对象。见下面返回结果示例 |
| eye_left | object | 相应人脸的左眼坐标，x & y 坐标分别表示在图片中的像素坐标 |
| eye_right | object | 相应人脸的右眼坐标，x & y 坐标分别表示在图片中的像素坐标 |
| mouth | object | 相应人脸的左侧嘴角坐标，x & y 坐标分别表示在图片中的像素坐标 |
| nose | object | 相应人脸的鼻尖坐标，x & y 坐标分别表示在图片中的像素坐标 |
| gender | string | 包含性别分析结果，value的值为Male/Female |
| age(暂无) | int | 检测到的年龄信息 |
| ThumbUrl | string | 人脸缩略图URL |
| Expression | string |
包含微笑等表情信息 |
调用示例
http://192.168.1.120:8090/Detect/ByUrl?appid=YOUR_APPID&token=YOUR_TOKEN&url=YOUR_IMAGE_URL&tag=YOUR_IMAGE_TAG
JSON 示例
{
Code: 0,
Result: {
"ImageID": "39129B306051AC9B9F939EC8E78DDB15",
"Url:"http://192.168.1.120:8090/image/photo/17AD03DBE7B89B310AB2471ED66C4FE7",
"Count":2,
"Width":888,
"Height":666,
"Face":
[{
"FaceID":"783137a114a73f79e532527b9fae97ae",
"Position":{"Left":423,"Top":346,"Width":40,"Height":40},
"Eye_Left":{"X":452,"Y":357},
"Eye_Right":{"X":433,"Y":359},
"Nose":{"X":443,"Y":368},
"Mouth":{"X":444,"Y":377},
"Gender":"Male",
"Expression":"Smile",
"ThumbUrl":"http://192.168.1.120:8090/image/thumb/783137a114a73f79e532527b9fae97ae"},
{"FaceID":"50766a3a7bafe21b57b869811ea79cbe",
"Position":{"Left":314,"Top":257,"Width":40,"Height":40},
"Eye_Left":{"X":345,"Y":266},
"Eye_Right":{"X":323,"Y":265},
"Nose":{"X":334,"Y":277},
"Mouth":{"X":333,"Y":289},
"Gender":"Female",
"Expression":"Smile",
"ThumbUrl":"http://localhost/image/thumb/50766a3a7bafe21b57b869811ea79cbe"}
]}
错误列表
| 错误码 | 描述 | |
|---|---|---|
| 1-999 系统错误码 | 0 | 操作成功 |
| 1 | 操作失败 | |
| 2 | 参数值格式有误 | |
| 1000-1999 用户操作错误码 | 1001 | 用户授权验证失败 |
| 1002 | 应用授权验证失败 | |
| 2000-2999 人脸检测错误码 | 2000 | 人脸检测失败 |
| 2001 | 图片转换失败 | |
| 2002 | 未检测到人脸 | |
| 3000-3999 Group组错误码 | 3000 | 组操作失败 |
| 3001 | 组创建失败 | |
| 3002 | 组删除失败 | |
| 3003 | 组人员添加失败 | |
| 3004 | 组人员删除失败 | |
| 3005 | 组信息获取失败 | |
| 3006 | 组信息设置失败 | |
| 5000-5999 Person错误码 | 5000 | 人员操作失败 |
| 5001 | 人员创建失败 | |
| 5002 | 人员删除失败 | |
| 5003 | 人员人脸添加失败 | |
| 5004 | 人员人脸删除失败 | |
| 5005 | 人员信息获取失败 | |
| 5006 | 人员信息设置失败 | |
| 7000-7999 Match错误码 | 7000 | 识别失败 |
| 7006 | 匹配失败 | |
| 8000-8999 Query错误码 | 8000 | 查询失败 |
| 8001 | 未找到此相片的信息 | |
| 8002 | 未找到人脸的信息 | |
| 8003 | 未找到人员的信息 | |
| 8004 | 未找到人脸集合的信息 | |
| 8005 | 未找到组的信息 | |