Skip to main content
POST
/
api
/
portrait
/
effects
/
face-beauty-advanced
Face Beauty Advanced
curl --request POST \
  --url https://www.ailabapi.com/api/portrait/effects/face-beauty-advanced \
  --header 'Content-Type: multipart/form-data' \
  --header 'ailabapi-api-key: <api-key>' \
  --form image='@example-file' \
  --form 'whitening=<string>' \
  --form 'smoothing=<string>' \
  --form 'face_lifting=<string>' \
  --form 'eye_enlarging=<string>'
{
  "request_id": "",
  "log_id": "",
  "error_code": 0,
  "error_code_str": "",
  "error_msg": "",
  "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
  },
  "result_image": ""
}

​
Request

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

​
Image requirements

  • Image format: JPEG JPG PNG BMP
  • Image size: No more than 5 MB.
  • Image resolution: Less than 2000x2000px.

​
Headers

FieldRequiredTypeDescription
ailabapi-api-keyYESstringApplication API KEY. Get API KEY

​
Body

FieldRequiredTypeScopeDefaultDescription
imageYESfile
whiteningNOinteger[0, 100]30Whitening level: 0 means no whitening, 100 represents the highest level.
smoothingNOinteger[0, 100]10Skin smoothing level: 0 means no skin smoothing, 100 represents the highest level.
face_liftingNOinteger[0, 100]70Face slimming level: 0 means no face slimming, 100 represents the highest level.
eye_enlargingNOinteger[0, 100]70Eye enlargement level: 0 means no eye enlargement, 100 represents the highest level.

​
Response

Response Field Handling Flow
  1. Handle Public Response Fields Parse and validate the Public Response Fields, checking the status code or response message to ensure the request is successful and error-free.
  2. Handle Business Response Fields If the Public Response Fields are valid and error-free, proceed with processing the business logic in the Business Response Fields.

​
Public Response Fields

Viewing Public Response Fields and Error Codes

​
Business Response Fields

FieldTypeDescription
result_imagestringReturns the base64 data of the processed image.

​
Response Example

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

Authorizations

​
ailabapi-api-key
string
header
required

API Key for authentication

Body

multipart/form-data
​
image
file
​
whitening
string

Whitening level: 0 means no whitening, 100 represents the highest level.

​
smoothing
string

Skin smoothing level: 0 means no skin smoothing, 100 represents the highest level.

​
face_lifting
string

Face slimming level: 0 means no face slimming, 100 represents the highest level.

​
eye_enlarging
string

Eye enlargement level: 0 means no eye enlargement, 100 represents the highest level.

Response

200 - application/json

Success

The response is of type object.