3D Hair Reconstruction

API METHODS

HTTP type	name
POST	/run_pipeline

/run_pipeline

Reconstruction 3D hair model in GLB format from photo.

Some details about hair model:

• number of vertices

  • in volume mode: from 10000 to 20000

  • in card mode: from 15000 to 25000

• material

  • in volume mode: base color from photo

  • in card mode: UV texture

• location and scale: corresponds to the head from GLB Constructor Service

• blendshapes: coming soon

Method for 3D Hair Reconstruction

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

Reconstruction 3D hair model in GLB format 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, in which hair is clearly visible. Supported file formats: JPG, PNG, HEIC. Maximum file size: 10 MB.
mode	string	Hair reconstruction mode: 'card' or 'volume'. Mode 'card' is used by default.
hair_color	string	Custom hair color as hex triplet. Default color is predicted from photo.

200: OK the request is successful, a file with GLB model will be returned

string($binary)

422: Unprocessable Entity Error while processing

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

Check in ERRORS section for possible error response examples.