/detect/byurl

描述

检测给定图片(Image)中的所有人脸(Face)的位置和相应的面部属性

  • 目前面部属性包括性别(gender), 表情(Expression)

参数

参数名参数说明
必须 token 申请应用的token
appid 申请应用时的appid
url 待检测图片的URL,原始图片大小需要小于3M
可选 mode 检测模式可以是normal(默认) 或者 oneface 。在oneface模式中,检测器仅找出图片中最大的一张脸。
level 人脸检测精度,分为低精度(low),普通(normal),高精度(high)。
tag 可以为图片中检测出的每一张Face指定一个不包含^@,&=*'"等非法字符且不超过255字节的字符串作为tag,相当于备注

返回值说明

字段类型说明
Count string 人脸数量
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未找到组的信息
到体验中心,您需要登录帐户
用户名:
密码:
记住我 新用户注册
登录