tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
数据万象
    文档
    Download PDF

    人脸特效

    最后更新时间：2024-01-20 09:22:44
    下载PDF

      功能描述

      人脸特效支持人脸美颜、人脸性别变换、人脸年龄变化、人像分割的特效功能，适用于社交娱乐、广告营销、互动传播等场景。
      功能
      说明
      人脸美颜
      可用于自拍照片等人像美化场景，上传照片即可一键智能实现美白、磨皮、瘦脸、大眼、美型，支持自定义调整参数，帮助提升个人形象。
      人脸性别变换
      用户上传一张人脸图片，基于人脸编辑与生成算法，输出一张人脸性别转换的图片。男变女可实现美颜、淡妆、加刘海和长发的效果；女变男可实现加毛须、变短发的效果。
      人脸年龄变化
      用户上传一张人脸图片，基于人脸编辑与生成算法，输出一张人脸变老或变年轻的图片，支持实现人脸不同年龄的变化。
      人像分割
      指对图片中的人体轮廓范围进行识别，将其与背景进行分离，返回分割后的二值图、灰度图、前景人像图。可应用于人像抠图、照片合成、人像特效等场景，极大提升工具效率。
      说明：
      当前人脸特效的图片限制为：图片 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>
      
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款