人脸搜索-免费API,收集所有免费的API

基本说明：

接口地址：https://api-cn.faceplusplus.com/facepp/v3/search
返回格式：json
请求方式：post
请求示例：https://api-cn.faceplusplus.com/facepp/v3/search?api_key=k&api_secret=s&image_url=u1&faceset_token=t

请求参数说明：

名称	类型	必填	说明
api_key	string	必填	调用此API的API Key 扫码关注公众号
api_secret	string	必填	调用此API的API Secret 扫码关注公众号
image_url	string	必填	图片的 URL
faceset_token	string	必填	用来搜索的 FaceSet 的标识

返回参数说明：

名称	类型	说明
-	-	详情见json

JSON返回示例：

{
	"request_id": "1470481443,0d749845-7153-4f5e-a996-ffc5a1ac0a79",
	"time_used": 1126,
	"thresholds": {
		"1e-3": 65.3,
		"1e-5": 76.5,
		"1e-4": 71.8
	},
	"results": [{
		"confidence": 96.46,
		"user_id": "234723hgfd",
		"face_token": "4dc8ba0650405fa7a4a5b0b5cb937f0b"
	}]
}

服务级错误码参照

错误码	说明
400	IMAGE_ERROR_UNSUPPORTED_FORMAT:参数<param>对应的图像无法正确解析，有可能不是一个图像文件、或有数据破损、或图片文件格式不符合要求。
400	INVALID_IMAGE_SIZE:客户上传的图像像素尺寸太大或太小，图片要求请参照本API描述。<param>对应图像太大的那个参数的名称
400	INVALID_IMAGE_URL:无法从指定的image_url下载图片，图片URL错误或者无效
400	IMAGE_FILE_TOO_LARGE:客户通过参数<param>上传的图片文件太大。本 API 要求图片文件大小不超过 2 MB
403	INSUFFICIENT_PERMISSION:试用 API Key 无法使用 <param>对应的参数。请勿传入此参数。或者使用正式 API Key 调用。
412	IMAGE_DOWNLOAD_TIMEOUT:下载图片超时

完整教学代码示例

<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2020/10/10 17:50
 */
//----------------------------------
// 人脸搜索 调用类
//----------------------------------
class freeApi
{
    private $apiKey = false;
    private $apiSecret = false;
    private $apiUrl = 'https://api-cn.faceplusplus.com/facepp/v3/search';
    public function __construct($apikey,$apiSecret){
        $this->apiKey = $apikey;
        $this->apiSecret = $apiSecret;
    }
    /**
     * 将JSON内容转为数据，并返回
     * @param string $content [内容]
     * @return array
     */
    public function returnArray($content){
        return json_decode($content,true);
    }
    /**
     * 获取结果
     * @return array
     */
    public function getResult(){
        $params = [
            "api_key" => $this->apiKey,
            "api_secret" => $this->apiSecret,
            "image_url" => "",
            "faceset_token" => "",
        ];
        $params = http_build_query($params);
        return $this->returnArray($this->freeApiCurl($this->apiUrl,$params,1));
    }
    /**
     * 请求接口返回内容
     * @param  string $url [请求的URL地址]
     * @param  string $params [请求的参数]
     * @param  int $ipost [是否采用POST形式]
     * @return  string
     */
    public function freeApiCurl($url,$params=false,$ispost=0){
        $ch = curl_init();
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch , CURLOPT_SSL_VERIFYHOST , false );
        curl_setopt( $ch , CURLOPT_SSL_VERIFYPEER , false );
        curl_setopt( $ch, CURLOPT_USERAGENT , 'free-api' );
        curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT , 60 );
        curl_setopt( $ch, CURLOPT_TIMEOUT , 60);
        curl_setopt( $ch, CURLOPT_RETURNTRANSFER , true );
        if( $ispost )
        {
            curl_setopt( $ch , CURLOPT_POST , true );
            curl_setopt( $ch , CURLOPT_POSTFIELDS , $params );
            curl_setopt( $ch , CURLOPT_URL , $url );
        }
        else
        {
            if($params){
                curl_setopt( $ch , CURLOPT_URL , $url.'?'.$params );
            }else{
                curl_setopt( $ch , CURLOPT_URL , $url);
            }
        }
        $response = curl_exec( $ch );
        if ($response === FALSE) {
            return false;
        }
        curl_close( $ch );
        return $response;
    }
}