人脸融合-免费API,收集所有免费的API

基本说明：

接口地址：https://api-cn.faceplusplus.com/imagepp/v1/mergeface
返回格式：json
请求方式：post
请求示例：https://api-cn.faceplusplus.com/imagepp/v1/mergeface?api_key=key&api_secret=secret&image_url=url

请求参数说明：

名称	类型	必填	说明
api_key	string	必填	调用此 API 的 API Key 扫码关注公众号
api_secret	string	必填	调用此 API 的 API Secret 扫码关注公众号
template_url	string	必填	用于人脸融合的模板图
merge_url	string	必填	用于人脸融合的融合图
template_rectangle	string	选填	指定模板图中进行人脸融合的人脸框位置
merge_rectangle	string	选填	指定融合图中用以融合的人脸框位置
merge_rate	int	选填	融合比例
feature_rate	int	选填	五官融合比例

返回参数说明：

名称	类型	说明
request_id	string	用于区分每一次请求的唯一的字符串
results	string	融合后的图片，jpg 格式
time_used	int	整个请求所花费的时间，单位为毫秒
error_message	string	当请求失败时才会返回此字符串，具体返回内容见后续错误信息章节。否则此字段不存在

JSON返回示例：

{
	"time_used": 544,
	"result": "省略base64图片数据",
	"request_id": "1510906671,53ca1f2b-c3d8-473a-858c-3b4fd99ef07a"
}

服务级错误码参照

错误码	说明
401	api_key和api_secret不匹配。
403	api_key没有调用本API的权限，具体原因为：用户自己禁止该api_key调用、管理员禁止该api_key调用、由于账户余额不足禁止调用。
403	并发数超过限制。
400	MISSING_ARGUMENTS：缺少某个必选参数。BAD_ARGUMENTS：某个参数解析出错（比如必须是数字，但是输入的是非数字字符串; 或者长度过长，etc.）。COEXISTENCE_ARGUMENTS：同时传入了要求是二选一或多选一的参数。如有特殊说明则不返回此错误。
413	客户发送的请求大小超过了2MB限制。该错误的返回格式为纯文本，不是json格式。
404	所调用的API不存在。
500	服务器内部错误，当此类错误发生时请再次请求，如果持续出现此类错误，请及时联系技术支持团队。

完整教学代码示例

<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2020/12/01 22:59
 */
//----------------------------------
// 人脸融合 调用类
//----------------------------------
class freeApi
{
    private $apiKey;
    private $apiSecret;
    private $apiUrl = 'https://api-cn.faceplusplus.com/imagepp/v1/mergeface';
    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,
            "template_url" => "",
            "merge_url" => "",
        ];
        $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 , 'chuanshuoapi' );
        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;
    }
}