tencent cloud

文档反馈

人脸特效

最后更新时间:2024-01-20 09:22:44

    功能描述

    人脸特效支持人脸美颜、人脸性别变换、人脸年龄变化、人像分割的特效功能,适用于社交娱乐、广告营销、互动传播等场景。
    功能
    说明
    人脸美颜
    可用于自拍照片等人像美化场景,上传照片即可一键智能实现美白、磨皮、瘦脸、大眼、美型,支持自定义调整参数,帮助提升个人形象。
    人脸性别变换
    用户上传一张人脸图片,基于人脸编辑与生成算法,输出一张人脸性别转换的图片。男变女可实现美颜、淡妆、加刘海和长发的效果;女变男可实现加毛须、变短发的效果。
    人脸年龄变化
    用户上传一张人脸图片,基于人脸编辑与生成算法,输出一张人脸变老或变年轻的图片,支持实现人脸不同年龄的变化。
    人像分割
    指对图片中的人体轮廓范围进行识别,将其与背景进行分离,返回分割后的二值图、灰度图、前景人像图。可应用于人像抠图、照片合成、人像特效等场景,极大提升工具效率。
    说明:
    当前人脸特效的图片限制为:图片 base64 编码后大小不可超过5MB。支持 PNG、JPG、JPEG、BMP 格式,不支持 GIF 图片。当使用人像分割时,图片分辨率须小于2000 × 2000px。
    人脸特效为付费服务,计费详情请查看内容识别费用。
    该功能目前仅提供 API 使用方式。

    请求

    请求示例

    GET /<ObjectKey>?ci-process=face-effect&type=<type> HTTP/1.1
    Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
    Date: <GMT Date>
    Authorization: <Auth String>
    
    说明:
    Authorization: Auth String(详情请参见 请求签名 文档)。
    通过子账号使用时,需要授予相关的权限,详情请参见授权粒度详情 文档。

    请求参数

    参数名称
    描述
    类型
    是否必选
    ObjectKey
    对象文件名,例如:folder/document.jpg。
    String
    ci-process
    数据万象处理能力,人脸特效固定为 face-effect。
    String
    type
    人脸特效类型。人脸美颜:face-beautify;人脸性别转换:face-gender-transformation;人脸年龄变化:face-age-transformation;人像分割:face-segmentation。
    String
    whitening
    type 为 face-beautify 时生效,美白程度,取值范围[0,100]。0表示不美白,100表示最高程度。默认值30。
    Integer
    smoothing
    type 为 face-beautify 时生效,磨皮程度,取值范围[0,100]。0表示不磨皮,100表示最高程度。默认值10。
    Integer
    faceLifting
    type 为 face-beautify 时生效,瘦脸程度,取值范围[0,100]。0表示不瘦脸,100表示最高程度。默认值70。
    Integer
    eyeEnlarging
    type 为 face-beautify 时生效,大眼程度,取值范围[0,100]。0表示不大眼,100表示最高程度。默认值70。
    Integer
    gender
    type 为 face-gender-transformation 时生效,选择转换方向,0表示男变女,1表示女变男。无默认值。注意:仅对图片中面积最大的人脸进行转换。
    Integer
    age
    type 为 face-age-transformation 时生效,变化到的人脸年龄,范围为[10,80],无默认值。注意:仅对图片中面积最大的人脸进行转换。
    Integer

    请求头

    此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

    请求体

    该请求无请求体。

    响应

    响应头

    此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

    响应体

    该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
    <Response>
    <ResultImage>base64编码的图片</ResultImage>
    <ResultMask>base64编码的文件</ResultMask>
    </Response>
    具体的数据内容如下:
    节点名称(关键字)
    父节点
    描述
    类型
    Response
    保存结果的容器
    Container
    Response 的内容:
    节点名称(关键字)
    父节点
    描述
    类型
    ResultImage
    Response
    处理后的图片 base64 数据。
    String
    ResultMask
    Response
    人像分割输出参数,一个通过 Base64 编码的文件,解码后文件由 Float 型浮点数组成。这些浮点数代表原图从左上角开始的每一行的每一个像素点,每一个浮点数的值是原图相应像素点位于人体轮廓内的置信度(0-1)转化的灰度值(0-255)。
    String

    错误码

    该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。

    实际案例

    请求

    GET /test.jpg?ci-process=face-effect&type=face-beautify&whitening=70&smoothing=80&faceLifting=70&eyeEnlarging=70 HTTP/1.1
    Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****
    Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com

    响应

    HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: 414641
    Date: Thu, 15 Jun 2017 12:37:29 GMT
    Server: tencent-image
    x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
    
    <Response>
    <ResultImage>base64编码的图片</ResultImage>
    </Response>