百度人脸识别服务

百度开放云中提供了一项人脸识别服务,依托百度业界领先的人脸识别算法,提供了人脸检测、五官定位、人脸属性检测等功能。

功能

提供人脸及五官几何位置定位

百度人脸识别服务_第1张图片

支持人脸图像的性别、表情等人脸属性分析功能

百度人脸识别服务_第2张图片

支持REST API方式调用

支持常用图片格式,能应对复杂的光照场景,并支持多种人脸姿态

提供了ANDROID、iOS、WP7、JAVA及PHP多种平台的SDK

服务控制台支持详细的服务统计查询及服务使用频次管理

典型案例

  • 百度云网盘
  • 百度相册
  • 百度魔拍
  • 百度内部移动办公应用
  • 有缘网

API

开启服务

使用人脸服务前,首先需要开启服务。通过开发者中心“管理控制台”,进入“我的应用列表”,创建应用。填写信息,创建成功后,点击左侧“媒体云”开启媒体云人脸识别服务。

获取 access_token

  • 访问百度开发者中心使用百度账号登录
  • 从管理中心进入相应应用得到 API Key(client_id)和 Secret Key(client_secret)。
  • 采用Client Credentials方式,获取Access Token,具体步骤见下。

在服务端发送请求(推荐用POST方法)到百度OAuth2.0授权服务的“https://openapi.baidu.com/oauth/2.0/token”地址上,并带上以下参数:

  • grant_type:必须参数,固定为“client_credentials”;
  • client_id:必须参数,应用的API Key;
  • client_secret:必须参数,应用的Secret Key;
  • scope:非必须参数。以空格分隔的权限列表,采用本方式获取Access Token时只能申请跟用户数据无关的数据访问权限。关于权限的具体信息请参考“权限列表”。

例如:

https://openapi.baidu.com/oauth/2.0/token?
    grant_type=client_credentials&
    client_id=Va5yQRHlA4Fq4eR3LT0vuXV4&
    client_secret= 0rDSjzQ20XUj5itV7WRtznPQSzr5pVw2&

若参数无误,服务器将返回一段JSON文本,包含以下参数:

  • access_token:要获取的Access Token;
  • expires_in:Access Token的有效期,以秒为单位;
  • refresh_token:用于刷新Access Token 的 Refresh Token,所有应用都会返回该参数;(10年的有效期)
  • scope:Access Token最终的访问范围,即用户实际授予的权限列表(用户在授权页面时,有可能会取消掉某些请求的权限),关于权限的具体信息参考“权限列表”一节;
  • session_key:基于http调用Open API时所需要的Session Key,其有效期与Access Token一致;
  • session_secret:基于http调用Open API时计算参数签名用的签名密钥。

例如:

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store

{
    "access_token": "1.a6b7dbd428f731035f771b8d15063f61.86400.1292922000-2346678-124328",
    "expires_in": 86400,
    "refresh_token": "2.385d55f8615fdfd9edb7c4b5ebdc3e39.604800.1293440400-2346678-124328",
    "scope": "public",
    "session_key": "ANXxSNjwQDugf8615OnqeikRMu2bKaXCdlLxn",
    "session_secret": "248APxvxjCZ0VEC43EYrvxqaK4oZExMB",
}

若请求错误,服务器将返回一段JSON文本,包含error(错误码)和 error_description (错误描述信息),例如:

HTTP/1.1 400 Bad Request
Content-Type: application/json
Cache-Control: no-store

{
    "error": "invalid_grant",
    "error_description": "Invalid authorization code: ANXxSNjwQDugOnqeikRMu2bKaXCdlLxn"
}

注意:

  • 默认情况下,Access Token的有效期为一个月,如果Access Token过期可以重新获取。
  • 获取Access Token时所返回的session_key和session_secret参数不是OAuth2.0协议标准规定的返回参数,而是百度OAuth2.0服务扩展加入的,目的是使得开发者可以基于http调用百度的Open API,因为基于https调用Open API虽然更为简单,但毕竟响应速度更差(比基于http的要差一倍时间左右)。

API 请求方式

  • 目前人脸检测接口支持 POST 和 GET 方式。
  • 媒体云人脸识别 REST API 的所有参数在传入时应当使用:UTF-8 编码。

URL 格式:

https://openapi.baidu.com/rest/2.0/media/v1/face/{request_type}?{query_string}

其中:

  • request_type 为操作方法,detect为人脸检测。

示例:

GET请求:

https://openapi.baidu.com/rest/2.0/media/v1/face/detect?access_token=urlencode(xxxxx)&url =urlencode(xxxxxx)

POST请求:

POST /rest/2.0/media/v1/face
User-Agent: curl/7.12.1 (x86_64-redhat-linux-gnu) libcurl/7.12.1 OpenSSL/0.9.7a zlib/1.2.1.2
libidn/0.5.6
Pragma: no-cache
Accept: */*
Host:openapi.baidu.com
Content-Type:application/x-www-form-urlencoded
Content-Length:123

access_token =urlencode(xxxx)&url =urlencode(xxxx)

人脸检测 API

请求:GET/POST

URL: https://openapi.baidu.com/rest/2.0/media/api/v1/face/detect

参数:

  • access_token
  • url:图片地址(需要使用 urlencode)
  • callback_url:(可选)离线请求回调地址

请求示例:

curl -v "https://openapi.baidu.com/rest/2.0/media/v1/face/detect?access_token=3.ad2ee1e9b351cd800fd62bddc8bef016.2592000.1377163536.4212382003-260146&url=http://c.hiphotos.bdimg.com/album/s%3D800/sign=6bd70c1da044ad342abf8a87e0a00c08/8d5494eef01f3a29d7017b3e9825bc315d607c71.jp"

返回示例:

{
"face": //在原图片中检测到的人脸数组
[{
"attribute"{
  "gender": { //检测到的人脸的性别
    "value": "male" //人脸性别结果
    "confidence": "1.0", //性别的置信度
  },
  "smiling ": { //检测到的笑脸
    "confidence":”1.0” //笑脸的置信度
  },
},
"face_id": "ffffff32c1f3813f0944f52427ed060b", //检测到的人脸的 id
"position": { //检测到的人脸的位置,坐标均进行了归一化,值在 0~1 之间
  "center": {
    "x": "0.591000", //人脸区域中心 x 坐标,
    "y": "0.267000"}, //人脸区域中心 y 坐标
  "width": "0.181290", //人脸区域宽度
  `height": "0.120600", //人脸区域高度
  "eye_left": {
    "x": "0.556230",//左眼 x 坐标
    "y": "0.230250" //左眼 y 坐标
  },
  "eye_right": {
    "x": "0.638620",//右眼 x 坐标
    "y": "0.244190", //右眼 y 坐标
  },
  "mouth": {
  ` "x":”0.574910”,//嘴巴中心 x 坐标
    "y":” 0.301350”,//嘴巴中心 y 坐标
  },
}
}],
"img_id": "966f0f32c1f3813f0944f52427ed060b", //图片 id
"url": "" //请求中的图片 url
"session_id":  "966f0f32c1f3813f0944f52427jjjkkk" //唯一标识请求
"img_width": "320" //图片宽度
"img_height": "240" //图片高度
}

附言

除了百度提供的人脸识别服务之外,国内还有其他人脸识别服务提供商,其中 Face++的技术非常先进,值得一看。

百度深度学习研究院目前招聘人脸方向的工程师,包括人脸算法工程师、物体检测算法工程师、多媒体高级研发工程师、计算机视觉研发工程师、大规模机器学习工程师、算法研发工程师、图像方向高级测试开发工程师等,地点在北京和深圳。如果你热爱计算机视觉技术,并且在视觉方向有深入理解或取得过突出成绩,请速投简历。


编撰 SegmentFault

你可能感兴趣的:(项目,人脸识别,百度)