Skip to main content

AILabTools API - Facial aesthetics - API

Request

  • URL: https://www.ailabapi.com/api/portrait/effects/face-tidyup
  • 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.
  • Image quality recommendation: the input image should be well-lit and evenly lit as much as possible, the face should be intact and less obscured, and the angle [raw, yaw, pitch] should be less than 60 degrees.
FieldRequiredTypeDescription
ailabapi-api-keyYESstringApplication API KEY.

Body

FieldRequiredTypeScopeDescription
imageYESfile
shape_typeYESstring
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • Beauty parts.
  • 0: cheekbone.
  • 1: cut face.
  • 2: slim face.
  • 3: long face.
  • 4: chin shortening.
  • 5: chin lengthening.
  • 6: slim chin.
  • 7: slim jaw.
  • 8: big eyes.
  • 9: eye angle 1.
  • 10: eye distance.
  • 11: widen eye distance.
  • 12: eye angle 2.
  • 13: eye height.
  • 14: slim nose.
  • 15: nose wing.
  • 16: nose length.
  • 17: nose length.
  • 18: lip width.
  • 19: lip size.
  • 20: lip height.
  • 21: human middle.
  • strengthYESfloat[0, 1.0]Aesthetic strength.

    Response

    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.