人脸裁剪服务

描述

人脸裁剪服务(facecrop2)能够帮您将保存在七牛云的图片中人脸部位裁剪出来。本服务由Face++提供，FDDB 给出了最新的人脸检测数据集基准，加入了Face++ 人脸检测。FDDB是麻省大学阿姆赫斯特校区给出的无约束条件下的人脸检测的人脸区域数据集研究。Face++检测器在人脸误检数为30左右的时候就已经达到0.8的检出率，之后的表现和Olaworks公司给出的检测器几乎平分秋色，优于其他公司。而在连续情况下Face++的优势更加明显，比其检测器表现都要好。若您需要对一张图片中的人脸区域裁剪出需要的合理宽高图片，那么本服务是非常简单高效的解决方案。

启用服务后，您存储在七牛云空间的文件将被提供给Face++以供其计算使用。七牛不能保证裁剪结果的正确性，请您自行评估后选择是否启用。服务价格请您参考具体的价格表及计费举例，您使用本服务产生的费用由七牛代收。启用服务则表示您知晓并同意以上内容。

如何开启

进入https://portal.qiniu.com/service/market, 找到人脸剪裁服务点击开始使用。

请求

接口规格

facecrop2/<width>x<height>
         /ignore-error/<ifIgnore>

参数	必填	说明
<width>x<height>	是	设置裁剪结果的宽高（int型），两个值必填 注：若裁剪的宽高范围超出原图会提示错误
ifIgnore		是否忽略出错信息，默认为否，返回错误信息；若设为1，则返回原图

请求报文格式

GET <ImageDownloadURI>?<接口规格> HTTP/1.1 
Host: <ImageDownloadHost> 

注意：当您下载私有空间的资源时，ImageDownloadURI的生成方法请参考七牛的下载凭证。

示例： 资源为http://78re52.com1.z0.glb.clouddn.com/resource/AllEast.jpg，处理样式为facecrop2/200x200。

#构造下载URL
DownloadUrl = 'http://78re52.com1.z0.glb.clouddn.com/resource/AllEast.jpg?facecrop2/200x200'
……
#最后得到
RealDownloadUrl = 'http://78re52.com1.z0.glb.clouddn.com/resource/AllEast.jpg?facecrop2/200x200&e=×××&token=MY_ACCESS_KEY:×××'

请求头部

头部名称	必填	说明
Host	是	下载服务器域名，可为七牛三级域名或自定义二级域名，参考域名绑定

响应

响应报文格式

HTTP/1.1 200 OK
Content-Type: image/jpeg

响应头部

头部名称	必填	说明
Content-Type	是	MIME类型，为image/jpeg(如果失败则是application/json)

响应内容

• 如果请求成功，返回图片的二进制数据
• 如果请求失败，返回包含如下内容的JSON字符串（已格式化，便于阅读）：

{ 
    "error": "<ErrMsg string>"
}

示例

原图URL:

http://78re52.com1.z0.glb.clouddn.com/resource/AllEast.jpg

正常剪切后的图片URL：

http://78re52.com1.z0.glb.clouddn.com/resource/AllEast.jpg?facecrop2/200x200 

剪切出错并返回错误信息：

http://78re52.com1.z0.glb.clouddn.com/resource/AllEast.jpg?facecrop2/800x200

剪切出错但忽略错误信息：

http://78re52.com1.z0.glb.clouddn.com/resource/AllEast.jpg?facecrop2/800x200/ignore-error/1

服务价格

以请求次数计费，0.3元/千次

计费示例

某司上月共发起3000次人脸裁剪请求，该司上个月的服务价格为：3000次 * 0.3元/千次 ＝ 0.9元