前言
人脸试妆，是指利用计算机视觉技术，自动检测并定位人脸关键点（如嘴唇、眼睛、眉毛、脸颊等区域），将虚拟的化妆品色彩与质感实时渲染叠加到用户面部图像或视频流中，模拟真实上妆效果的过程。
人脸试妆应用场景如下：
1.美妆电商线上购物
电商平台、品牌小程序 / APP 内置虚拟试妆功能。用户在商品详情页直接试口红、粉底、眼影，直观查看色号适配效果，减少 “盲买”，降低商品退换货率，提升商品转化率。
2.短视频 & 社交内容营销
抖音、小红书等社交平台的AR试妆特效。品牌发布专属妆容滤镜，用户一键上妆并拍摄短视频分享，自带传播属性，低成本完成品牌种草，扩大产品曝光。
API介绍
人脸试妆包括三个API，分别为：人脸试妆-滤镜、人脸试妆-美颜、人脸试妆-试唇色
人脸试妆-滤镜
- 上传一张照片，输出滤镜处理后的图片
- 支持PNG、JPG、JPEG、BMP 等图片格式，不支持 GIF 图片
- 图片文件Base64大小不超过5MB
请求说明
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| file | file | 否 | 图像文件，文件类型，file、base64、url 必须提供一个 |
| base64 | String | 否 | 图像的Base64，file、base64、url 必须提供一个 |
| url | String | 否 | 图像的url，file、base64、url 必须提供一个 |
| filterType | Integer | 是 | 滤镜类型，取值如下：1.白茶；2 白皙；3.初夏；4.东京；5.告白；6.暖阳；7.蔷薇；8.清澄；9.清透；10.甜薄荷；11.默认；12.心动；13.哑灰；14.樱桃布丁；15.自然；16.清逸；17.黑白；18.水果；19.爱情；20.冬日；21.相片；22.夏日；23.香氛；24.魅惑；25.悸动；26.沙滩；27.街拍；28.甜美；29.初吻；30.午后。 |
| filterDegree | Integer | 否 | 滤镜效果，取值[0,100]，0表示无效果，100表示满滤镜效果。默认值为80。 |
返回样例
{
"code": 200,//返回码，详见返回码说明
"msg": "成功",// 返回码对应描述
"taskNo": "708707365169542428753449",// 本次请求
"data": {
"imgUrl": "",//图片img，有效期10天。建议自行下载保存，避免丢失
"imgBase64": ""//图片base64
}
}
人脸试妆-美颜
- 用户上传一张人脸图片（最多能处理一张图片中最大的五张人脸信息），精准定位五官，实现美肤、亮肤、祛痘等美颜功能
- 支持PNG、JPG、JPEG、BMP 等图片格式，不支持 GIF 图片
- 图片文件Base64大小不超过5MB
请求说明
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| file | file | 否 | 图像文件，文件类型，file、base64、url 必须提供一个 |
| base64 | String | 否 | 图像的Base64，file、base64、url 必须提供一个 |
| url | String | 否 | 图像的url，file、base64、url 必须提供一个 |
| whitening | Integer | 否 | 美白程度，取值范围[0,100]。0不美白，100代表最高程度。默认值30 |
| smoothing | Integer | 否 | 磨皮程度，取值范围[0,100]。0不磨皮，100代表最高程度。默认值10 |
| faceLifting | Integer | 否 | 瘦脸程度，取值范围[0,100]。0不瘦脸，100代表最高程度。默认值70 |
| eyeEnlarging | Integer | 否 | 大眼程度，取值范围[0,100]。0不大眼，100代表最高程度。默认值70 |
返回样例
{
"code": 200,//返回码，详见返回码说明
"msg": "成功",// 返回码对应描述
"taskNo": "708707365169542428753449",// 本次请求
"data": {
"imgUrl": "",//图片img，有效期10天。建议自行下载保存，避免丢失
"imgBase64": ""//图片base64
}
}
人脸试妆-试唇色
- 上传一张照片，对图片中的人脸嘴唇进行着色，最多支持同时对一张图中的3张人脸进行试唇色
- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
- 图片文件Base64大小不超过5MB
请求说明
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| file | file | 否 | 图像文件，文件类型，file、base64、url 必须提供一个 |
| base64 | String | 否 | 图像的Base64，file、base64、url 必须提供一个 |
| url | String | 否 | 图像的url，file、base64、url 必须提供一个 |
| rgbaGroupList | String | 是 | 唇色信息 最多支持3组RGBA，每组之间用‘|’分隔，RGBA之间用逗号分隔，譬如只有一组RGBA则xxx,xxx,xxx,xxx 譬如有2组RGBA则xxx,xxx,xxx,xxx|xxx,xxx,xxx,xxx |
返回样例
{
"code": 200,//返回码，详见返回码说明
"msg": "成功",// 返回码对应描述
"taskNo": "708707365169542428753439",// 本次请求号
"data": {
"imgUrl": "",//图片img，有效期10天。建议自行下载保存，避免丢失
"imgBase64": ""//图片base64
}
}
