空间H5游戏-后台接口

/v3/picture/face_merge

pf=wanba_ts

获取,上传的人脸头像和素材模板人脸头像融合之后的新图片。

注意: 1.上传的图片需要有明显的人脸,否则无法识别。 2.目前素材模板人脸id,需要空间提供

URL

https://api.urlshare.cn/v3/picture/face_merge

私有参数

参数名称 是否必须 类型 描述
rsp_img_type string 上传图片类型。注意只能填写url或者base64
model_id string 素材模板id
img_url string 上传图片url
img_data string 上传图片base64数据
alpha_blend string 融合程度,0-1之间浮点数,无特殊需求可不用填
alpha_position string 形变程度,0-1之间浮点数
mask_id string 蒙板id,1-3之间整数

data参数示例

{ 
  "rsp_img_type":"url",
  "model_id":"cf_fuwa_qiji",
  "img_url":"http://imgtu.5011.net/uploads/content/20160503/6018721462246529.jpg",
  "alpha_blend":0.1,
  "alpha_position":0.1,
  "mask_id":1
}

返回参数说明

参数名称 描述
code 返回码,说明如下
url 图片url
imgbaseUrl 图片base64数据
msg 信息

备注:如果rsp_img_type参数是base64,则返回参数会有融合之后的图片url和图片base64数据。如果如果rsp_img_type参数是url,则只返回img_url

code 返回码说明:

code 说明
0 成功
1 参数错误或失败
1000 无人脸
-1000 参数错误
-1002 读写CKV出错
-1003 读写REDIS出错
-1004 保存结果图片出错
-1005 下载用户图片出错
-1007 服务器内部逻辑出错
-1008 人脸检测失败
-2101 签名串鉴权失败
-2102 图片处理功能不存在
-2103 图片操作功能无权限

正确返回示例

{
 code:0,
 url:'http://qzonestyle.gtimg.cn/qzone/space_item/qzone_pet/PetUniverse/org/2/12402/Yshaonian.png',
 msg:'成功'
}

demo

在电脑上打开连接,即可体验 demo