Python调用face++API完成本地图片的人脸检测
简单调用face++API对本地图片进行人脸检测,输出基本信息到csv文件。
注册face++账号
face++网址 https://www.faceplusplus.com.cn/
注册完成之后,查看自己的 API Key 和 API Secret
改写官网代码示例完成人脸信息采集
原代码示例网址 https://console.faceplusplus.com.cn/documents/6329752
选用原代码示例中的python代码对其进行符合人脸检测信息采集需求的修改,代码如下,具体代码解释见下节:
# -*- coding: utf-8 -*-
import urllib2
import time
import os
from pandas.core.frame import DataFrame
result = []
http_url='https://api-cn.faceplusplus.com/facepp/v3/detect'
key = "sJVodwPAjfbo18Vc2OCZjIUuM1u2BhWe" #这里是你申请的API Key
secret = "29dB1GxL9oXbv7P117CLa4ZyUdHzj1ad" #这里是你申请的API Secret
filedir = r"C:\Users\Desktop\face\data\images" #这里是你要检测图片文件夹的路径
writepath = "C:\\Users\\Desktop\\face\\data\\note.csv" #这里替换为你写入csv文件的路径
filelist = os.listdir(filedir)
for filename in filelist:
filepath = os.path.join(filedir,filename)
boundary = '----------%s' % hex(int(time.time() * 1000))
data = []
data.append('--%s' % boundary)
data.append('Content-Disposition: form-data; name="%s"\r\n' % 'api_key')
data.append(key)
data.append('--%s' % boundary)
data.append('Content-Disposition: form-data; name="%s"\r\n' % 'api_secret')
data.append(secret)
data.append('--%s' % boundary)
fr=open(filepath,'rb')
data.append('Content-Disposition: form-data; name="%s"; filename=" "' % 'image_file')
data.append('Content-Type: %s\r\n' % 'application/octet-stream')
data.append(fr.read())
fr.close()
data.append('--%s' % boundary)
data.append('Content-Disposition: form-data; name="%s"\r\n' % 'return_landmark')
data.append('1')
data.append('--%s' % boundary)
data.append('Content-Disposition: form-data; name="%s"\r\n' % 'return_attributes')
data.append("gender,age,smiling,headpose,facequality,blur,eyestatus,emotion,ethnicity,beauty,mouthstatus,eyegaze,skinstatus")
data.append('--%s--\r\n' % boundary)
http_body='\r\n'.join(data)
#buld http request
req=urllib2.Request(http_url)
#header
req.add_header('Content-Type', 'multipart/form-data; boundary=%s' % boundary)
req.add_data(http_body)
#这里提取图片的性别、年龄、人脸框位置,并输出该图片的绝对路径。
#若提取其他属性,请修改以下代码,将result中加入所需属性并输出
try:
resp = urllib2.urlopen(req, timeout=5)
qrcont = resp.read()
dict = eval(qrcont)
faces = dict['faces']
for i in range(len(faces)):
attribute = faces[i]['attributes']
gender = attribute['gender']['value']
age = attribute['age']['value']
face_rectangle = faces[i]['face_rectangle']
width = face_rectangle['width']
top = face_rectangle['top']
left = face_rectangle['left']
height = face_rectangle['height']
result.append([filepath,gender,age,width,top,left,height])
except urllib2.HTTPError as e:
print e.read()
DataFrame(result).to_csv(writepath,header=['filepath','gender','age','width','top','left','heigth'])
返回变量
在本示例中,只提取了检测到人脸的性别、年龄、人脸框位置,而face++人脸检测API提供了十分全面的返回值,具体返回值课件参考官网文档 https://console.faceplusplus.com.cn/documents/4888373
这里,解释上述代码提取各变量的含义。
字段 | 类型 | 说明 |
---|---|---|
gender | String | 性别分析结果,Male为男性,Female为女性 |
age | Int | 年龄分析结果。返回值为一个非负整数 |
face_rectangle | Object | 人脸矩形框的位置,包括以下属性 |
top | Int | 矩形框左上角像素点的纵坐标 |
left | Int | 矩形框左上角像素点的横坐标 |
width | Int | 矩形框的宽度 |
height | Int | 矩形框的高度 |
代码结果
若路径filedir下有如下一张图片:
使用python2.7运行代码,可以得到一个绝对路径为writepath的csv文件如下
face++人脸检测API检测出5张人脸,并将人脸信息保存在了csv文件中。
注意事项
- 改进的示例代码使用python2编译
- filedir和writepath两个路径不要带有中文字符
- 需要事先安装urllib2