动态与公告

产品动态

关于腾讯特效 SDK V3.5 版本更新公告

关于腾讯特效 SDK V3.0 版本相关接口及素材变更公告

产品简介

产品概述

产品功能

基本概念

产品优势

应用场景

购买指南

价格总览

购买流程

欠费退费说明

新手指引

Demo 体验

免费测试

License 指引

移动端 License 新增与续期

PC 端 License 新增与续期

Web端 License 新增与续期

常见问题

SDK 下载

功能说明

SDK 下载

版本历史

SDK 集成指引（无 UI）

通用集成腾讯特效

原子能力集成指引

SDK 集成指引（含 UI）

通用集成腾讯特效

直播 SDK 集成腾讯特效

TRTC SDK 集成腾讯特效

短视频 SDK 集成腾讯特效

Avatar 虚拟人集成指引

API 文档

iOS

Android

Flutter

Web

功能实践

SDK 包瘦身

SDK 集成问题排查

性能调优

效果调优

素材使用

美颜参数说明

美颜场景推荐参数

短视频企业版迁移指引

第三方推流接入美颜（Flutter）

小程序美颜特效实践

素材制作工具使用

Web 美颜特效

产品概述

快速上手

SDK 接入

API 文档

控制台指南

Demo 体验

内置素材总览

实践教程

常见问题

通用类相关

技术类相关

License 相关

旧版文档

美颜场景推荐参数

美颜参数表

一分钟集成 TRTC

一分钟集成直播

TE SDK 政策

隐私协议

数据处理和安全协议

联系我们

iOS（3.3.0及以前）

PDF

聚焦模式

字号

最后更新时间： 2024-07-05 12:35:44

美颜
美白
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_WHITEN
propertyValue
30
extraInfo
nil
磨皮
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_SMOOTH
propertyValue
30
extraInfo
nil
红润
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_ROSY
propertyValue
30
extraInfo
nil
对比度
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_CONTRAST
propertyValue
30
extraInfo
nil
饱和度
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_SATURATION
propertyValue
30
extraInfo
nil
清晰度
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_CLEAR
propertyValue
30
extraInfo
nil
大眼
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_ENLARGE_EYE
propertyValue
30
extraInfo
nil
瘦脸/自然
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_NATURE
propertyValue
30
extraInfo
@{@"reshape.basicFaceSubType":@"nature"}
瘦脸/女神
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_GODNESS
propertyValue
30
extraInfo
@{@"reshape.basicFaceSubType":@"femaleGod"}
瘦脸/英俊
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_MALE_GOD
propertyValue
30
extraInfo
@{@"reshape.basicFaceSubType":@"maleGod"}
V 脸
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_V
propertyValue
30
extraInfo
nil
收下颌（V2.6.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_JAW
propertyValue
30
extraInfo
nil
窄脸
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_THIN
propertyValue
30
extraInfo
nil
短脸
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_SHORT
propertyValue
30
extraInfo
nil
脸型
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_BASIC
propertyValue
30
extraInfo
nil
口红/复古红
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_MOUTH_LIPSTICK
propertyValue
30
extraInfo
@{@"beauty.lips.lipsMask":@"images/beauty/lips_fuguhong.png", @"beauty.lips.lipsType":@"2"}
口红/蜜桃色
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_MOUTH_LIPSTICK
propertyValue
30
extraInfo
@{@"beauty.lips.lipsMask":@"images/beauty/lips_mitaose.png", @"beauty.lips.lipsType":@"2"}
口红/珊瑚橘
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_MOUTH_LIPSTICK
propertyValue
30
extraInfo
@{@"beauty.lips.lipsMask":@"images/beauty/lips_shanhuju.png", @"beauty.lips.lipsType":@"2"}
口红/温柔粉
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_MOUTH_LIPSTICK
propertyValue
30
extraInfo
@{@"beauty.lips.lipsMask":@"images/beauty/lips_wenroufen.png", @"beauty.lips.lipsType":@"2"}
口红/活力橙
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_MOUTH_LIPSTICK
propertyValue
30
extraInfo
@{@"beauty.lips.lipsMask":@"images/beauty/lips_huolicheng.png", @"beauty.lips.lipsType":@"2"}
腮红/简约
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_RED_CHEEK
propertyValue
30
extraInfo
@{@"beauty.makeupMultiply.multiplyMask":@"images/beauty/saihong_jianyue.png"}
腮红/盛夏
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_RED_CHEEK
propertyValue
30
extraInfo
@{@"beauty.makeupMultiply.multiplyMask":@"images/beauty/saihong_shengxia.png"}
腮红/害羞
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_RED_CHEEK
propertyValue
30
extraInfo
@{@"beauty.makeupMultiply.multiplyMask":@"images/beauty/saihong_haixiu.png"}
腮红/成熟
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_RED_CHEEK
propertyValue
30
extraInfo
@{@"beauty.makeupMultiply.multiplyMask":@"images/beauty/saihong_chengshu.png"}
腮红/雀斑
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_RED_CHEEK
propertyValue
30
extraInfo
@{@"beauty.makeupMultiply.multiplyMask":@"images/beauty/saihong_queban.png"}
立体/自然
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_SOFTLIGHT
propertyValue
30
extraInfo
@{@"beauty.softLight.softLightMask":@"images/beauty/liti_ziran.png"}
立体/俊朗
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_SOFTLIGHT
propertyValue
30
extraInfo
@{@"beauty.softLight.softLightMask":@"images/beauty/liti_junlang.png"}
立体/光芒
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_SOFTLIGHT
propertyValue
30
extraInfo
@{@"beauty.softLight.softLightMask":@"images/beauty/liti_guangmang.png"}
立体/清新
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_SOFTLIGHT
propertyValue
30
extraInfo
@{@"beauty.softLight.softLightMask":@"images/beauty/liti_qingxin.png"}
瘦颧骨
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_THIN_CHEEKBONE
propertyValue
30
extraInfo
nil
下巴
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_THIN_CHIN
propertyValue
30
extraInfo
nil
额头
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_FOREHEAD
propertyValue
30
extraInfo
nil
亮眼
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_EYE_LIGHTEN
propertyValue
30
extraInfo
nil
眼距
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_EYE_DISTANCE
propertyValue
30
extraInfo
nil
眼角
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_EYE_ANGLE
propertyValue
30
extraInfo
nil
眼宽（V3.0.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_EYE_WIDTH
propertyValue
30
extraInfo
nil
眼高（V3.0.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_EYE_HEIGHT
propertyValue
30
extraInfo
nil
瘦鼻
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_NOSE_THIN
propertyValue
30
extraInfo
nil
鼻翼
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_NOSE_WING
propertyValue
30
extraInfo
nil
鼻子位置
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_NOSE_HEIGHT
propertyValue
30
extraInfo
nil
白牙
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_TOOTH_WHITEN
propertyValue
30
extraInfo
nil
祛皱
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_REMOVE_WRINKLE
propertyValue
30
extraInfo
nil
祛法令纹
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_REMOVE_LAW_LINE
propertyValue
30
extraInfo
nil
祛眼袋
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_REMOVE_EYE_BAGS
propertyValue
30
extraInfo
nil
嘴型
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_MOUTH_SIZE
propertyValue
30
extraInfo
nil
嘴唇厚度
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_MOUTH_HEIGHT
propertyValue
30
extraInfo
nil
嘴唇宽度（V3.0.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_MOUTH_WIDTH
propertyValue
30
extraInfo
nil
嘴唇位置（V3.0.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_MOUTH_POSITION
propertyValue
30
extraInfo
nil
微笑唇（V3.0.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_SMILE_FACE
propertyValue
30
extraInfo
nil
眉毛角度（V3.0.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_EYEBROW_ANGLE
propertyValue
30
extraInfo
nil
眉毛距离（V3.0.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_EYEBROW_DISTANCE
propertyValue
30
extraInfo
nil
眉毛高度（V3.0.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_EYEBROW_HEIGHT
propertyValue
30
extraInfo
nil
眉毛长度（V3.0.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_EYEBROW_LENGTH
propertyValue
30
extraInfo
nil
眉毛粗细（V3.0.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_EYEBROW_THICKNESS
propertyValue
30
extraInfo
nil
眉峰（V3.0.0）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_EYEBROW_RIDGE
propertyValue
30
extraInfo
nil
眼影（V3.1.0新增）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_EYE_SHADOW
propertyValue
30
extraInfo
@{
@"beauty.eyesMakeup.mask.eyeShadow" : @"/images/beauty/eyes_makeup_eye_shadow_0-albatross.png"
}
说明：传入字典，字典的key是@"beauty.eyesMakeup.mask.eyeShadow" ,value是效果图片的相对路径@"/images/beauty/eyes_makeup_eye_shadow_0-albatross.png"。具体美颜效果参考demo
眼线（V3.1.0新增）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_EYE_LINER
propertyValue
30
extraInfo
@{
@"beauty.eyesMakeup.mask.eyeLiner" : @"/images/beauty/eyes_makeup_eye_liner_0.png"
}
说明：传入字典，字典的key是@"beauty.eyesMakeup.mask.eyeLiner" ,value是效果图片的相对路径@"/images/beauty/eyes_makeup_eye_liner_0.png"。具体美颜效果参考demo
睫毛（V3.1.0新增）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_EYELASH
propertyValue
30
extraInfo
@{
@"beauty.eyesMakeup.mask.eyelash" : @"/images/beauty/eyes_makeup_eyelash_0.png"
}
说明：传入字典，字典的key是@"beauty.eyesMakeup.mask.eyelash" ,value是效果图片的相对路径@"/images/beauty/eyes_makeup_eyelash_0.png"。具体美颜效果参考demo
眉毛（V3.1.0新增）
字段
取值
propertyType
Category_BEAUTY
propertyName
BEAUTY_FACE_EYEBROW
propertyValue
30
extraInfo
@{
@"beauty.eyesMakeup.mask.eyebrow" : @"/images/beauty/eyes_makeup_eyebrow_0.png"
}
说明：传入字典，字典的key是@"beauty.eyesMakeup.mask.eyebrow" ,value是效果图片的相对路径@"/images/beauty/eyes_makeup_eyebrow_0.png"。具体美颜效果参考demo
美体
一键瘦身
字段
取值
propertyType
Category_BODY_BEAUTY
propertyName
BODY_AUTOTHIN_BODY_STRENGTH
propertyValue
30
extraInfo
nil
长腿
字段
取值
propertyType
Category_BODY_BEAUTY
propertyName
BODY_LEG_STRETCH
propertyValue
30
extraInfo
nil
瘦腿
字段
取值
propertyType
Category_BODY_BEAUTY
propertyName
BODY_SLIM_LEG_STRENGTH
propertyValue
30
extraInfo
nil
瘦腰
字段
取值
propertyType
Category_BODY_BEAUTY
propertyName
BODY_WAIST_STRENGTH
propertyValue
30
extraInfo
nil
瘦肩
字段
取值
propertyType
Category_BODY_BEAUTY
propertyName
BODY_THIN_SHOULDER_STRENGTH
propertyValue
30
extraInfo
nil
小头
字段
取值
propertyType
Category_BODY_BEAUTY
propertyName
BODY_SLIM_HEAD_STRENGTH
propertyValue
30
extraInfo
nil
丰胸（V3.0.0）
字段
取值
propertyType
Category_BODY_BEAUTY
propertyName
BODY_ENLARGE_CHEST_STRENGTH
propertyValue
30
extraInfo
nil
滤镜
无
字段
取值
propertyType
Category_LUT
propertyName
XmagicProperty_ID_NONE
propertyValue
30
extraInfo
nil
白皙（例子）
字段
取值
propertyType
Category_LUT
propertyName
lut.bundle/n_baixi.png
propertyValue
30
extraInfo
nil
其他
字段
取值
propertyType
Category_LUT
propertyName
滤镜图片资源的路径（参考 Demo，如果资源在 bundle 中，则可以使用相对路径，否则使用全路径）
propertyValue
30
extraInfo
nil
动效
无
字段
取值
propertyType
Category_MOTION
propertyName
XmagicProperty_ID_NONE
propertyValue
xxxxxx/2dMotionRes.bundle
extraInfo
nil
可爱涂鸦
字段
取值
propertyType
Category_MOTION
propertyName
video_keaituya
propertyValue
xxxxxx/2dMotionRes.bundle
extraInfo
nil
动效素材名称
字段
取值
propertyType
Category_MOTION
propertyName
素材文件夹名称（参考 Demo）
propertyValue
素材文件夹全路径（此处需要参考 Demo，填写全路径）
extraInfo
nil
美妆
美妆时，先设置 motion，后设置 makeup，具体请参考 Demo。
无
字段
取值
﻿
propertyType
Category_MOTION
Category_MAKEUP
propertyName
XmagicProperty_ID_NONE
BeautyConstant_MAKEUP
propertyValue
xxxxxx/makeupMotionRes.bundle
0
extraInfo
nil
nil
﻿
女团妆
字段
取值
﻿
propertyType
Category_MOTION
Category_MAKEUP
propertyName
video_nvtuanzhuang
BeautyConstant_MAKEUP
propertyValue
xxxxxx/makeupMotionRes.bundle
30
extraInfo
nil
nil
﻿
美妆素材名称
字段
取值
﻿
propertyType
Category_MOTION
Category_MAKEUP
propertyName
素材文件夹名称（参考 Demo）
BeautyConstant_MAKEUP
propertyValue
素材文件夹全路径（参考 Demo，填写全路径）
30
extraInfo
nil
nil
分割
无
字段
取值
propertyType
Category_MOTION
propertyName
XmagicProperty_ID_NONE
propertyValue
xxxxxx/segmentMotionRes.bundle
extraInfo
nil
背景模糊-弱
字段
取值
propertyType
Category_MOTION
propertyName
video_segmentation_blur_45
propertyValue
xxxxxx/segmentMotionRes.bundle
extraInfo
@{@"bgName":@"BgSegmentation.bg.png", @"bgType":@0, @"timeOffset": @0}
分割素材名称
字段
取值
propertyType
Category_MOTION
propertyName
素材文件夹名称（参考 Demo）
propertyValue
素材文件夹全路径（此处需要参考 Demo，填写全路径）
extraInfo
@{@"bgName":@"BgSegmentation.bg.png", @"bgType":@0, @"timeOffset": @0}
自定义分割
字段
取值
propertyType
Category_MOTION
propertyName
video_empty_segmentation
propertyValue
自定义分割素材的全路径
extraInfo
bgName：图片或者视频的全路径
bgType：如果是图片，则传入0，如果是视频，则传入1
timeOffset：如果是图片，则传入0，如果是视频，则传入视频时长 @{@"bgName":bgName, @"bgType":bgType, @"timeOffset": timeOffset} （参考 Demo）
﻿

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

字段	取值
propertyType	Category_BEAUTY
propertyName	BEAUTY_WHITEN
propertyValue	30
extraInfo	nil

tencent cloud

腾讯特效 SDK

iOS（3.3.0及以前）

美颜

美白

磨皮

红润

对比度

饱和度

清晰度

大眼

瘦脸/自然

瘦脸/女神

瘦脸/英俊

V 脸

收下颌（V2.6.0）

窄脸

短脸

脸型

口红/复古红

口红/蜜桃色

口红/珊瑚橘

口红/温柔粉

口红/活力橙

腮红/简约

腮红/盛夏

腮红/害羞

腮红/成熟

腮红/雀斑

立体/自然

立体/俊朗

立体/光芒

立体/清新

瘦颧骨

下巴

额头

亮眼

眼距

眼角

眼宽（V3.0.0）

眼高（V3.0.0）

瘦鼻

鼻翼

鼻子位置

白牙

祛皱

祛法令纹

祛眼袋

嘴型

嘴唇厚度

嘴唇宽度（V3.0.0）

嘴唇位置（V3.0.0）

微笑唇（V3.0.0）

眉毛角度（V3.0.0）

眉毛距离（V3.0.0）

眉毛高度（V3.0.0）

眉毛长度（V3.0.0）

眉毛粗细（V3.0.0）

眉峰（V3.0.0）

眼影（V3.1.0新增）

眼线（V3.1.0新增）

睫毛（V3.1.0新增）

眉毛（V3.1.0新增）

美体

一键瘦身

长腿

瘦腿

瘦腰

瘦肩

小头

丰胸（V3.0.0）

滤镜

无

白皙（例子）

其他

动效

无

可爱涂鸦

动效素材名称

美妆