Service APIs for creating virtual avatars
  • Welcome
    • Overview
    • About us
    • Glossary
  • What's New
    • Changelog
    • Subscribe for updates
  • EXAMPLES
    • 3D model from single photo
  • Getting started
    • Introduction
    • Getting a token
    • 3D Face Reconstruction
    • 3D Hair Reconstruction
    • GLB Constructor
      • Easy - Head Visualization
      • Advanced - Schema preparation
      • Advanced - Assembling
  • API Methods
    • 3D Face Reconstruction
      • Bad Case Examples
    • 3D Hair Reconstruction
    • GLB Constructor
  • Errors
    • 3D Face Reconstruction
    • 3D Hair Reconstruction
    • GLB Constructor
  • API Metrics
    • SLA
Powered by GitBook
On this page
  • API METHODS
  • /run_pipeline
  • Method for 3D Face Reconstruction
  1. API Methods

3D Face Reconstruction

PreviousAdvanced - AssemblingNextBad Case Examples

Last updated 2 years ago

API METHODS

HTTP type
name

POST

/run_pipeline

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

For visualization use .

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"
  }
}
{
    "error": {
            "code": int
            "message": str
    }
}

Check in section for possible error response examples.

GLB Constructor Service
ERRORS
/run_pipeline