3D Face Reconstruction

API METHODS

HTTP type	name
POST	/run_pipeline

/run_pipeline

Getting face texture and head model parameters of 3D head model from photo.

For visualization use GLB Constructor Service.

Model parameters:

Parameter	Type	Description
result.face.textureUrl	string	UV Texture path saved .png file into /static directory.
result.face.blendShapes	list	Shape blendshapes. List 80 long with float.
result.face.blinkCorrectionCoeff	int	Coefficient for corrective blink blendshape.
result.hair.color	string	Hex RGB color code of hair.
result.hair.type	string	Type of hairstyle (long/short/ponytail and straight/wavy).
result.gender	string	Gender class of input image.
result.skin.color	string	Hex RGB color code of skin.
result.accessories	list	List of accessories. List of strings.

Method for 3D Face Reconstruction

POST https://api.metahumansdk.io/face_recon/run_pipeline

Getting face texture and head model parameters of 3D head model from photo.

Request Body

Name	Type	Description
token*	string	Registered token.
image_bytes*	binary	Photo of a person in full face or half a turn. Supported file formats: JPG, PNG, HEIC. Maximum file size: 10 MB.

200: OK The request is successful

{
  "result": {
    "face": {
      "textureUrl": "/static/input_image_texture.png",
      "blendShapes": [
        -1.7523525953292847,
        ...
        1.5906388759613037
      ],
      "blinkCorrectionCoeff": 1.0096107066555675
    },
    "hair": {
      "color": "#160406",
      "type": "long_straight"
    },
    "skin": {
      "color": "#965e53"
    },
    "accessories": [],
    "gender": "Female"
  }
}

422: Unprocessable Entity Error while processing

{
    "error": {
            "code": int
            "message": str
    }
}

Check in ERRORS section for possible error response examples.

---