tencent cloud

Feedback

Face Filter

Last updated:2022-08-18 15:12:15

    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>
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support