tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Documentation

Face Filter

Last updated: 2024-02-18 15:49:30

    Feature Description

    Face filter supports beauty filter, gender swap, age change, and face cut-out. It is suitable for many use cases, such as social entertainment, marketing, and interactive communication.
    Feature
    Description
    Beauty filter
    You can upload a selfie and quickly apply smart skin brightening, skin smoothing, face slimming, eye enlarging, and contouring filters. You can also customize parameters.
    Gender swap
    You can upload a face image and have the gender swapped based on the face editing and generation algorithms. Beauty filters, makeup, bang, and long hair can be added to a face swapped from male to female, while beard and short hair can be added to a face swapped from female to male.
    Age change
    You can upload a face image and make the face look older or younger based on the face editing and generation algorithms.
    Face cut-out
    You can upload an image and get the body contour recognized and separated from the background. The binary image, grayscale image, and foreground portrait are returned. This is applicable to portrait keying, photo synthesis, face special effect, and other use cases and greatly improves the tool efficiency.
    Note:
    Face filters can be applied to a Base64-encoded image of up to 5 MB in size. PNG, JPG, JPEG, and BMP formats are supported, while GIF is not. To use face cut-out, the image resolution must be lower than 2000x2000 px.
    Face filter is a paid service. For billing details, see Content Recognition Fees.
    This feature currently can be used only through APIs.

    Request

    Sample request

    GET /<ObjectKey>?ci-process=face-effect&type=<type> HTTP/1.1
    Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
    Date: <GMT Date>
    Authorization: <Auth String>
    
    Note:
    Authorization: Auth String (for more information, see Request Signature).
    When this feature is used by a sub-account, relevant permissions must be granted. For more information, see Authorization Granularity.

    Request parameters

    Parameter
    Description
    Type
    Required
    ObjectKey
    Object name, such as folder/document.jpg.
    String
    Yes
    ci-process
    CI's processing capability, which is fixed at face-effect for face filter.
    String
    Yes
    type
    Face filter type. Valid value: face-beautify, face-gender-transformation, face-age-transformation, face-segmentation.
    String
    Yes
    whitening
    Skin brightening level, which takes effect if type is face-beautify. Value range: [0,100]. Default value: 30. The higher the value, the more obvious the effect.
    Integer
    No
    smoothing
    Skin smoothing level, which takes effect if type is face-beautify. Value range: [0,100]. Default value: 10. The higher the value, the more obvious the effect.
    Integer
    No
    faceLifting
    Face slimming level, which takes effect if type is face-beautify. Value range: [0,100]. Default value: 70. The higher the value, the more obvious the effect.
    Integer
    No
    eyeEnlarging
    Eye enlarging level, which takes effect if type is face-beautify. Value range: [0,100]. Default value: 70. The higher the value, the more obvious the effect.
    Integer
    No
    gender
    Target gender, which takes effect if type is face-gender-transformation. 0: male to female; 1: female to male. There is no default value. Note that only the gender of the largest face in the image will be swapped.
    Integer
    Yes
    age
    Target age, which takes effect if type is face-age-transformation. Value range: [10, 80]. There is no default value. Note that only the age of the largest face in the image will be changed.
    Integer
    Yes

    Request headers

    This API only uses common request headers. For more information, see Common Request Headers.

    Request body

    This request does not have a request body.

    Response

    Response headers

    This API only returns common response headers. For more information, see Common Response Headers.

    Response body

    The response body returns application/xml data. The following contains all the nodes:
    <Response>
      <ResultImage>Base64-encoded image</ResultImage>
      <ResultMask>Base64-encoded file</ResultMask>
    </Response>
    The nodes are as described below:
    Node Name (Keyword)
    Parent Node
    Description
    Type
    Response
    None
    Response container
    Container
    Response has the following sub-nodes:
    Node Name (Keyword)
    Parent Node
    Description
    Type
    ResultImage
    Response
    Base64-encoded result image data
    String
    ResultMask
    Response
    Face cut-out output parameter, which is a Base64-encoded file consisting of floating point numbers after being decoded. These numbers represent pixels in each line starting from the top-left corner of the input image. The value of each number is the grayscale value (0–255) converted from the confidence (0–1) of the body contour.
    String

    Error codes

    There are no special error messages for this request. For common error messages, see Error Codes.

    Samples

    Request

    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

    Response

    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-encoded image</ResultImage>
    </Response>
    
    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    Privacy PolicyLegalCookie Policy