阿里云视觉智能开放平台提供人脸人体AI服务，该服务中的大部分API都可以单独使用，人脸搜索的API则需要多个API调用配合使用。本文档为您介绍如何调用多个API进行人脸搜索。

操作流程

  1. 开通服务。您需要开通人脸人体服务和对象存储服务。
  2. 添加POM依赖。
  3. 创建人脸数据库。关于该接口的详细说明请参见创建人脸数据库。
  4. 添加人脸样本。关于该接口的详细说明请参见添加人脸样本。
  5. 添加人脸数据。关于该接口的详细说明请参见添加人脸数据。
  6. 搜索人脸。关于该接口的详细说明请参见人脸搜索。

开通服务

调用人脸搜索相关API前，您需要开通人脸人体服务。在添加人脸数据时，需要先将图片上传至上海地域的OSS Bucket中生成URL链接，通过图片URL链接添加人脸数据。关于如何开通OSS服务请参见开通OSS服务。下面为您介绍如何开通人脸人体服务。

  1. 登录阿里云视觉智能开放平台。
  2. 在顶部菜单栏的能力广场中单击人脸人体。
  3. 在人脸人体页面中单击立即开通。
    说明 对于公测期免费能力，在页面中显示免费开通；对于商业化付费能力，在页面中显示立即开通，开通后不调用不计费，调用后开始收费。
  4. 确认开通地域并勾选服务协议后，单击立即开通。

    页面提示服务开通成功。

    说明 开通了人脸人体服务后，该服务下的所有API均可以直接调用，不需要再单独开通。

添加POM依赖

在您的Java工程中添加人体人脸能力的POM依赖。 
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.14</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-facebody -->
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-facebody</artifactId>
    <version>1.2.2</version>
</dependency>

创建人脸数据库

调用CreateFaceDb接口创建人脸数据库，数据库名称为：compare_face_test。Java代码请求示例如下。
说明 请将如下代码示例中的<accessKeyId>和<accessSecret>替换为您的真实AK信息。如何获取AK请参见创建AccessKey。 
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import java.util.*;
import com.aliyuncs.facebody.model.v20191230.*;

public class CreateFaceDb {

    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile("cn-shanghai", "<accessKeyId>", "<accessSecret>");
        IAcsClient client = new DefaultAcsClient(profile);

        CreateFaceDbRequest request = new CreateFaceDbRequest();
        request.setRegionId("cn-shanghai");
        request.setName("compare_face_test");

        try {
            CreateFaceDbResponse response = client.getAcsResponse(request);
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }

    }
}

添加人脸样本

调用AddFaceEntity接口添加人脸样本，添加的人脸样本ID为：compare_face_test_entity。Java代码请求示例如下。
说明 请将如下代码示例中的<accessKeyId>和<accessSecret>替换为您的真实AK信息。如何获取AK请参见创建AccessKey。 
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import java.util.*;
import com.aliyuncs.facebody.model.v20191230.*;

public class AddFaceEntity {

    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile("cn-shanghai", "<accessKeyId>", "<accessSecret>");
        IAcsClient client = new DefaultAcsClient(profile);

        AddFaceEntityRequest request = new AddFaceEntityRequest();
        request.setRegionId("cn-shanghai");
        request.setDbName("compare_face_test");
        request.setEntityId("compare_face_test_entity");
        request.setLabels("人事");

        try {
            AddFaceEntityResponse response = client.getAcsResponse(request);
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }

    }
}

添加人脸数据

在添加人脸前，我们需要将人脸图片生成图片URL，然后调用AddFace接口传入图片URL添加人脸数据。

  1. 开通OSS服务。
    具体操作请参见开通OSS服务。
  2. 创建存储空间，其中区域选择为华东2（上海）。
    具体操作请参见创建存储空间。
  3. 上传人脸图片至OSS存储空间中。
    具体操作请参见上传文件。
  4. 查看人脸图片的URL。
    1. 单击已上传人脸图片后的详情。
    2. 在详情页面查看图片的URL。
      您也可以单击URL下的复制文件 URL复制人脸图片的URL。
  5. 调用AddFace添加人脸数据。
    Java代码请求示例如下。
    说明 请将如下代码示例中的<accessKeyId>和<accessSecret>替换为您的真实AK信息。如何获取AK请参见创建AccessKey。 
    import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import java.util.*;
import com.aliyuncs.facebody.model.v20191230.*;

public class AddFace {

    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile("cn-shanghai", "<accessKeyId>", "<accessSecret>");
        IAcsClient client = new DefaultAcsClient(profile);

        AddFaceRequest request = new AddFaceRequest();
        request.setRegionId("cn-shanghai");
        request.setDbName("compare_face_test");
        request.setImageUrl("https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/imgsearch/demo/1.png");
        request.setEntityId("compare_face_test_entity");
        request.setExtraData("小明");

        try {
            AddFaceResponse response = client.getAcsResponse(request);
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }

    }
}

搜索人脸

在人脸数据库compare_face_test中，搜索已经添加的人脸数据。Java代码请求示例如下。
说明 请将如下代码示例中的<accessKeyId>和<accessSecret>替换为您的真实AK信息。如何获取AK请参见创建AccessKey。 
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import java.util.*;
import com.aliyuncs.facebody.model.v20191230.*;

public class SearchFace {

    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile("cn-shanghai", "<accessKeyId>", "<accessSecret>");
        IAcsClient client = new DefaultAcsClient(profile);

        SearchFaceRequest request = new SearchFaceRequest();
        request.setRegionId("cn-shanghai");
        request.setDbName("compare_face_test");
        request.setImageUrl("https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/tiankong/9%E4%BA%BA%E8%84%B82.png");
        request.setLimit(5);

        try {
            SearchFaceResponse response = client.getAcsResponse(request);
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }

    }
}
搜索人脸数据的返回结果示例如下。 
{
    "RequestId": "D2995F67-5A0E-4FA4-BFF5-5692B7C4A558",
    "Data": {
        "MatchList": [
            {
                "FaceItems": [
                    {
                        "FaceId": "1589871296906000",
                        "EntityId": "compare_face_test_entity",
                        "Score": 1,
                        "ExtraData": "小明"
                    }
                ],
                "Location": {
                    "X": 191,
                    "Y": 66,
                    "Height": 324,
                    "Width": 230
                }
            }
        ]
    }
}