Skip to main content

AILabTools API - Face Filters - API:V1.0.0(DEPRECATED)


draft: true

Important Announcement: API Version Update Notice

Dear Developers,

We are thrilled to announce that our API is receiving a major update! The new version will introduce a host of improvements and feature enhancements to enhance your development experience and meet your needs.

However, along with the rollout of the new version, we must also inform you that the old version of the API will no longer receive maintenance and support. This means that we will no longer release new features, fix known issues, or provide technical support for the old version of the API.

We strongly encourage you to upgrade to the latest version of the API as soon as possible to ensure that your applications continue to operate smoothly and to take advantage of the latest features and optimizations.

If you have any questions or need assistance regarding this change, please feel free to contact our support team ([email protected]). We are committed to assisting you and ensuring a smooth transition.

Once again, thank you for your support and trust in our API.

Best Regards,

AILabTools Support Team

Request

  • URL: https://www.ailabapi.com/api/portrait/effects/face-filter
  • Method: POST
  • Content-Type: multipart/form-data

Image requirements

  • Image format: JPEG JPG PNG BMP
  • Image size: No more than 3 MB.
  • Image resolution: Larger than 10x10px, smaller than 2000x2000px.
FieldRequiredTypeDescription
ailabapi-api-keyYESstringApplication API KEY. Get API KEY

Body

FieldRequiredTypeScopeDescription
imageYESfile
resource_typeYESstringScopePicture style. More Details
strengthYESfloat[0, 1.0]Filter intensity.

resource_type

resource_typeDescription
0Default
1Sunflower
2Bellflower
3Kenting
4Dali
5Lijiang
10001White Tea
10002Fair Skin
10003Early Summer
10004Tokyo
10005Confession
10006Warm Sunshine
10007Rose
10008Clarity
10009Crystal Clear
10010Sweet Mint
10011Basic
10012Heartbeat
10013Muted Gray
10014Cherry Pudding
10015Natural
10016Elegance
10017Black and White
10018Fruit
10019Love
10020Winter
10021Photo
10022Summer
10023Fragrance
10024Charm
10025Throb
10026Beach
10027Street Snap
10028Sweet
10029First Kiss
10030Afternoon
10031Vitality
10032Hazy
10033Joyful
10034Fashion
10035Bubbles
10036Lemon
10037Cotton Candy
10038Brook
10039Beauty
10040Coffee
10041Tender Bud
10042Passion
10043Gradual Warmth
10044Breakfast
10045White Tea
10046Fair
10047Holy
10048Forest
10049Surfing
10050Milk Coffee
10051Clear
10052Breeze
10053Sunset
10054Water Glow
10055Japanese Style
10056Starlight
10057Sunshine
10058Falling Leaves
10059Vitality
10060Sweetheart
10061Elegance
10062Spring
10063Rome
10064Green
10065Gentle Breeze
10066Warm Heart
10067Seawater
10068Mysterious
10069Vintage 1
10070Vintage 2
10071Snowy Peak
10072Sunlight
10073Floating Clouds
10074Flowing Colors
10075Film
10076Nostalgia
10077Cheese
10078Butterfly

Response

Processing Flow
  1. Handle Public Parameters:

    First, parse and validate the Public Parameters, checking the status code or response message to ensure the request is successful and no errors are present.

  2. Handle Business Parameters:

    If the public parameters are valid and no exceptions are found, proceed to process the business logic in the Business Parameters.

Public Parameters

Viewing Public Parameters and Error Codes

Business Parameters

FieldTypeDescription
dataobjectThe content of the result data returned.
+image_urlstringResulting image URL address.
tip

The URL address is a temporary address, valid for 24 hours, and will not be accessible after it expires. If you need to save the file for a long time or permanently, please visit the URL address within 24 hours and download the file to your own storage space.

Example

{
"request_id": "",
"log_id": "",
"error_code": 0,
"error_code_str": "",
"error_msg": "",
"error_detail": {
"status_code": 200,
"code": "",
"code_message": "",
"message": ""
},
"data": {
"image_url": ""
}
}

Code example

If you'd like to see the actual effects, please visit the experience page for a trial.