功能描述

使用本 API,可以对模板图和融合图中的人脸进行融合操作。融合后的图片中将包含融合图中的人脸特征,以及模板图中的其他外貌特征与内容,返回值是一段 JSON,包含融合完成后图片的 Base64 编码。
接口使用简单,提交模板图URL融合图URL即可返回融合图片结果。

接口适用范围: 网站, 小程序, Android, iOS等, 提供各种方式解决方案, 一对一协助对接QQ: 445899710

图片要求

图片格式:JPG(JPEG)
图片像素尺寸:最小200*200像素,最大4096*4096像素
图片文件大小:最大 2 MB
最小人脸像素尺寸: 为了保证融合效果,推荐图片中人脸框(正方形)边长的最小值不低于200像素。
人脸质量:人脸质量越高,则融合效果越好。影响人脸质量的因素包括:对人脸五官的遮挡、不当的光照(强光、暗光、逆光)、过大的人脸角度等。
不支持黑白照片。

接口URL

https://www.pyingquan.com/api/mergeface

提交方式

POST

请求参数

是否必选 参数名 类型 说明
appid String 调用此 API 的 API Key
appsecret String 调用此 API 的 API Secret
template_url String 模板图片的 URL
magic_url String 融合图的图片URL
rate Int 融合比例,范围 [0,100]。数字越大融合结果包含越多融合图特征。
默认值为50

返回值说明

字段 类型 说明
errcode Int 状态码
errmsg String 错误信息描述,当发生错误时才返回。
data Array 成功后返回的内容数组
┗ result String 融合完成后图片的 Base64 编码内容

成功返回示例

{"errcode":0,"data":{"result":"\/9j\/4AAQSkZJRgABAQAAAQABAAD\/2wBD......."}}

错误返回示例

{ "errcode": 2001, "errmsg": "对应的图片未检测到人脸" }

errcode状态代码

状态代码 说明
0 融合成功
100 参数不完整
101 appid或appsecret不正确
102 余额不足
1001 模板图没有识别到人脸
2001 对应的图片未检测到人脸
2002 对应的客户上传的图像文件太大。本 API 要求图片文件大小不超过 2 MB
2003 对应的图片 URL 错误或者无效
2004 对应的客户上传的图像像素尺寸太大或太小
2005 对应的图像无法正确解析
2006 传入的人脸框格式不符合要求,或者人脸框位于图片外
2007 下载图片超时

调用示例

$param = array(
    'appid' => '',
    'appsecret' => '',
    'magic_url' => 'http://wx3.sinaimg.cn/mw690/6446d518ly1g2cmnhnut3j20jg0ykjta.jpg',
    'template_url' => 'https://wx3.sinaimg.cn/mw600/006fXfqdly1g2ejt0sphoj30lw0qomyg.jpg',
    'rate' => 60,
);
$snoopy = new \Snoopy();
$snoopy->submit('https://www.pyingquan.com/api/mergeface', $param);
$json = json_decode($snoopy->results, true);
if (!empty($json['data']['result'])) {
    echo '<img src="data:image/jpeg;base64,' . $json['data']['result'] . '">';
}

价格

按量计费 0.1元/次

注册新账户会赠送1元,可测试10次。

线上案例预览