功能描述
使用本 API,可以对模板图和融合图中的人脸进行融合操作。融合后的图片中将包含融合图中的人脸特征,以及模板图中的其他外貌特征与内容,返回值是一段 JSON,包含融合完成后图片的 Base64 编码。
接口使用简单,提交模板图URL和融合图URL即可返回融合图片结果。
接口适用范围: 网站, 小程序, Android, iOS等, 提供各种方式解决方案, 一对一协助对接QQ: 445899710
可以先看看演示H5
如何接入人脸融合呢
先访问影圈云平台 https://www.pyingquan.com/console/index 创建一个账号, 拿到平台的appid和appsecret
PHP示例代码
- $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="https://img-blog.csdnimg.cn/2022010703304377569.jpeg' . $json['data']['result'] . '">';
- }
接口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": 1001, "errmsg": "模板图没有识别到人脸" }
errcode状态代码
状态代码 | 说明 |
0 | 融合成功 |
100 | 参数不完整 |
101 | appid或appsecret不正确 |
102 | 余额不足 |
1001 | 模板图没有识别到人脸 |
2001 | 对应的图片未检测到人脸 |
2002 | 对应的客户上传的图像文件太大。本 API 要求图片文件大小不超过 2 MB |
2003 | 对应的图片 URL 错误或者无效 |
2004 | 对应的客户上传的图像像素尺寸太大或太小 |
2005 | 对应的图像无法正确解析 |
2006 | 传入的人脸框格式不符合要求,或者人脸框位于图片外 |
2007 | 下载图片超时 |
详细接口文档请访问 https://www.pyingquan.com/doc/mergeface
如有问题请联系技术QQ: 445899710