自定义人脸检索

功能描述

自定义人脸检索根据您输入的待识别人脸图片（face），在指定人脸库（group）中查找并返回最相似的Top 5个体（person），返回的Top 5个体按照相似度从大到小排序。

检索人脸时，必须指定要检索的分组信息（最多指定一个分组）。关于参数的详细说明，请参见自定义人脸检索API文档。

您需要使用内容安全的API接入地址，调用本SDK接口。关于API接入地址的信息，请参见接入地址（Endpoint）。

前提条件

提交人脸图片检索任务

<?php

use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;
use AlibabaCloud\Green\Green;

try {
   /**
     * 注意：此处实例化的client尽可能重复使用，提升检测性能。避免重复建立连接。
     * 常见获取环境变量方式：
     * 获取RAM用户AccessKey ID：getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
     * 获取RAM用户AccessKey Secret：getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
     */
    AlibabaCloud::accessKeyClient('建议从环境变量中获取RAM用户AccessKey ID', '建议从环境变量中获取RAM用户AccessKey Secret')
        ->timeout(10) // 超时10秒，使用该客户端且没有单独设置的请求都使用此设置。
        ->connectTimeout(3) // 连接超时3秒，当单位小于1，则自动转换为毫秒，使用该客户端且没有单独设置的请求都使用此设置。
        ->regionId('cn-shanghai')
        ->asDefaultClient();

    // url：待检索图片url，必选；groupId：检索库的Id，必选。
    $task1 = array('dataId' => '业务数据ID',
        'url' => '待检测图片链接地址',
        'extras' => array('groupId' => '个体组ID')
    );
    // scenes：检测场景，取值：sface-n，表示自定义人脸检索。
    $result = Green::v20180509()->imageSyncScan()
        ->timeout(10) // 超时10秒，request超时设置，仅对当前请求有效。
        ->connectTimeout(3) // 连接超时3秒，当单位小于1，则自动转换为毫秒，request超时设置，仅对当前请求有效。
        ->body(json_encode(array("tasks" => array($task1),
            "scenes" => array("sface-n"))))
        ->request();
    print_r($result->toArray());
} catch (ClientException $exception) {
    echo $exception->getMessage() . PHP_EOL;
} catch (ServerException $exception) {
    echo $exception->getMessage() . PHP_EOL;
    echo $exception->getErrorCode() . PHP_EOL;
    echo $exception->getRequestId() . PHP_EOL;
    echo $exception->getErrorMessage() . PHP_EOL;
}