3D Face Reconstruction

API METHODS

HTTP type
name

POST

/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.

{
  "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"
  }
}

Last updated