功能描述

对提供的一张人脸图像进行基于人脸的属性检测，返回对应的性别、发型信息，以及年龄、是否有胡子、是否戴眼镜/口罩/墨镜/帽子、是否打电话等信息。

接口调用

本节将对人脸图像属性识别服务进行阐述。由于实际所使用到的编程语言较多，此文档不会一一涉及。本章中将只就 Java 语言如何调用识别服务接口进行代码示例讲解。其它语言如何进行调用，用户可参照接口调用例程。

• 请求方法

http: //${IP}: ${Port}/v1/detect/attribute?code=PERSON_FACE_INFO_RECOGNIZE

• Header参数

• Body参数

对应示例：
{
faceImageAttributeDetectionOption:{
detectAgeBeardGlassMask:true
detectHairCapAndPhone:true
}
image:{
content:"/9j/4A0Hyc5PTgyAFFFFAFFFFoooAooooAooooAqBnzFFFATUEAnNFFATRRRQBRRRQBRRRQBRRRQBRRRQBRRRQBRRRQBRRRQEZooooSz//2Q=="
}
}

• 返回参数

对应示例：
{
"faceParam": [
{
"hairCapAndPhone": {
"call": 99,
"wearHat": 99,
"gender": 0,
"bareHead": 0,
"baldingHead": 0,
"manShortHair": 0,
"manLongHair": 99,
"mediumLengthHair": 0,
"longHair": 0,
"tiedHair": 0
}
}
],
"response": {
"status": 200,
"metadata": {},
"content": ""
}
}

错误码

注意事项

1、对图像要求
支持的图片格式：BMP/JPG/TIF/PNG/WSQ/JP2/JPC/J2K/TFF
对比度、亮度适中；
尽量不要有较多背景，尽量选择浅色、纯色背景；
图像尽量避免反光和黑影；
图像清晰，避免图像模糊不清； 图像分辨率不宜过高，一方面造成图片过大，不利于传输，一方面分辨率过高也会影响识别率。
人脸图片中，人脸宽度不低于60像素
2、服务需要联网调用
由于当前服务基于 http 技术实现，用户调用服务前请确保您的设备可以连通服务器，并保证一定的带宽。否则图像数据网络传输较慢，会引起较长时间等待。
3、Base64编码
若接口涉及到数据需要进行base64编码，请引用commons-codec-1.13.jar对图片进行base64编码：base64.encodeBase64String(byteData);

示例代码(Java)

package cn.eyecool;

import java.awt.image.BufferedImage;
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.IOException;
import java.net.MalformedURLException;

import javax.imageio.ImageIO;

import org.apache.commons.codec.binary.Base64;
import org.apache.http.client.config.RequestConfig;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

import com.alibaba.fastjson.JSON;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * 人脸属性识别原子能力调用Demo
 * 
 * @author mawj
 * @date 2023/03/09
 */
public class DetectFaceAttrDemo {

    // 连接超时时间
    private static int connTimeOut = 60 * 1000;
    // 请求原子能力的URL（实际开发调试中，可以换成自己部署的abis服务）
    private static final String url = "https://www.abis.cn/v1/detect/attribute";
    // 待检测图片的本地路径
    private static String imgPath = System.getProperty("user.dir") + File.separator + "image";

    public static void main(String[] args) {
        // 读取本地图片
        File leftImageFile = new File(imgPath + File.separator + "face1.jpg");
        // 组装数据结构
        DetectFaceAttrDemo demo = new DetectFaceAttrDemo();
        FaceAttrDetectParam param = demo.new FaceAttrDetectParam();
        param.setImage(demo.new ImageContent(encodeImgageToBase64(leftImageFile)));
        param.setFaceImageAttributeDetectionOption(demo.new Option(true, true, true));
        param.setRotateEnable(true);
        // 发送Http请求
        String response = doPostJson(url, JSON.toJSONString(param));
        System.out.println("响应数据:");
        System.out.println(response);
    }

    /**
     * 请求参数
     * 
     * @date 2022/05/25
     */
    @Data
    class FaceAttrDetectParam {
        /**
         * 图像信息
         */
        private ImageContent image;
        /**
         * Option参数
         */
        private Option faceImageAttributeDetectionOption;
        /**
         * 是否自动旋转人脸方向
         */
        private boolean rotateEnable;

    }

    /**
     * Option参数(检测属性开关)
     * 
     * @author mawj
     * @date 2023/03/09
     */
    @Data
    @AllArgsConstructor
    @NoArgsConstructor
    public class Option {
        boolean detectHairCapAndPhone; // 是否检测属性包括：是否打电话，是否戴帽子，性别和发型
        boolean detectAgeBeardGlassMask; // 是否检测属性包括：年龄，是否有胡子，是否戴眼镜，是否戴口罩，是否戴墨镜
        boolean detectHack; // 是否检测静默活体检测，比较简单的检测，专业的需要使用静默检活算法
    }

    /**
     * 图片内容
     * 
     * @date 2022/05/25
     */
    @Data
    @AllArgsConstructor
    class ImageContent {

        /**
         * 图像Base64
         */
        private String content;
    }

    /**
     * File文件转base64格式
     * 
     * @param imageFile
     * @return string
     */
    public static String encodeImgageToBase64(File imageFile) {

        ByteArrayOutputStream outputStream = null;
        try {
            BufferedImage bufferedImage = ImageIO.read(imageFile);
            outputStream = new ByteArrayOutputStream();
            ImageIO.write(bufferedImage, "jpg", outputStream);
        } catch (MalformedURLException e1) {
            e1.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
        // 返回Base64编码过的字节数组字符串
        return Base64.encodeBase64String(outputStream.toByteArray());
    }

    /**
     * PostJson请求
     * 
     * @param url
     * @param json
     * @return
     */
    public static String doPostJson(String url, String json) {
        // 创建Httpclient对象
        CloseableHttpClient httpClient = HttpClients.createDefault();
        CloseableHttpResponse response = null;
        String resultString = "";
        // TODO 此处token的值需要修改，从网页端获取，格式为：Bearer token
        String token = "Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6ImYxYzU4MGZhLTUyZjctNDE4OS04MGE4LWQ4ZjYyYWFiMmEwMCJ9.ZhWKCU0Xr7O8-cTv34FkkZUrb28WoBzPmOAnbvIrjB65kW6DUso-KB8WgAagSvYHF5McWS8Bl2_NsrikYFDxpw";
        try {
            // 创建Http Post请求
            HttpPost httpPost = new HttpPost(url);
            httpPost.setHeader("Authorization",token);
            /** 设置超时时间 */
            RequestConfig requestConfig = RequestConfig.custom().setConnectionRequestTimeout(connTimeOut)
                .setSocketTimeout(connTimeOut).setConnectTimeout(connTimeOut).build();
            // 创建请求内容
            StringEntity entity = new StringEntity(json, ContentType.APPLICATION_JSON);
            httpPost.setEntity(entity);
            httpPost.setConfig(requestConfig);
            // 执行http请求
            response = httpClient.execute(httpPost);
            resultString = EntityUtils.toString(response.getEntity(), "utf-8");
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            finallyClose(httpClient, response);
        }
        return resultString;
    }

    /**
     * 关闭和释放
     * 
     * @param httpClient
     * @param response
     */
    private static void finallyClose(CloseableHttpClient httpClient, CloseableHttpResponse response) {
        try {
            if (response != null) {
                response.close();
            }
            httpClient.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

}