Skip to main content

AILabTools API - Head Extraction - API


  • URL:
  • Method: POST
  • Content-Type: multipart/form-data

Image requirements

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


  • mask
  • Specifies the form of the returned image.
  • If not set, the four-channel PNG map is returned.
  • mask: Returns a single channel mask.
  • Response

    Public Parameters

    Viewing Public Parameters and Error Codes

    Business Parameters

    dataobjectThe content of the result data returned.
    +elementsarrayThe keying result of each child element.
    ++image_urlstringResulting image URL address.
    ++widthintegerThe width of the result map.
    ++heightintegerThe height of the resultant graph.
    ++xintegerTop left x-coordinate.
    ++yintegerTop left y-coordinate.

    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.


    "request_id": "",
    "log_id": "",
    "error_code": 0,
    "error_code_str": "",
    "error_msg": "",
    "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
    "data": {
    "elements": [
    "image_url": "",
    "width": 0,
    "height": 0,
    "x": 0,
    "y": 0

    Code example

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