# 前言 
人脸试妆，是指利用计算机视觉技术，自动检测并定位人脸关键点（如嘴唇、眼睛、眉毛、脸颊等区域），将虚拟的化妆品色彩与质感实时渲染叠加到用户面部图像或视频流中，模拟真实上妆效果的过程。

人脸试妆应用场景如下：
**1.美妆电商线上购物**
电商平台、品牌小程序 / APP 内置虚拟试妆功能。用户在商品详情页直接试口红、粉底、眼影，直观查看色号适配效果，减少 “盲买”，降低商品退换货率，提升商品转化率。
**2.短视频 & 社交内容营销 **
抖音、小红书等社交平台的AR试妆特效。品牌发布专属妆容滤镜，用户一键上妆并拍摄短视频分享，自带传播属性，低成本完成品牌种草，扩大产品曝光。![请添加图片描述](https://developer.qcloudimg.com/http-save/yehe-12007261/1ea9cb41f7abd29e0416e69ca1ee789c.png)


# 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。


## 返回样例

```json
{
  "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


## 返回样例

```json
{
  "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，每组之间用‘&#124;’分隔，RGBA之间用逗号分隔，譬如只有一组RGBA则xxx,xxx,xxx,xxx 譬如有2组RGBA则xxx,xxx,xxx,xxx&#124;xxx,xxx,xxx,xxx |


## 返回样例

```json
{
  "code": 200,//返回码，详见返回码说明
  "msg": "成功",// 返回码对应描述
  "taskNo": "708707365169542428753439",// 本次请求号
  "data": {
    "imgUrl": "",//图片img，有效期10天。建议自行下载保存，避免丢失
    "imgBase64": ""//图片base64
  }
}
```

人脸试妆，是指利用计算机视觉技术，自动检测并定位人脸关键点（如嘴唇、眼睛、眉毛、脸颊等区域），将虚拟的化妆品色彩与质感实时渲染叠加到用户面部图像或视频流中，模拟真实上妆效果的过程。

在线试妆-人脸美颜-人脸试妆-图片滤镜

数据库

人脸试妆API提供滤镜、美颜、试唇色三大功能，精准定位五官实时渲染虚拟妆容。支持美妆电商试妆、短视频AR滤镜及社交种草场景，兼容多种图片格式，助商家降低退货率、提升转化与品牌曝光。

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

在线试妆-人脸美颜-人脸试妆-图片滤镜-腾讯云开发者社区-腾讯云

在线试妆-人脸美颜-人脸试妆-图片滤镜

在线试妆-人脸美颜-人脸试妆-图片滤镜

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐