tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
文档

人脸特效

最后更新时间：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>
    
    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    隐私条款服务条款缓存条款