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 Hair Reconstruction
  1. API Methods

3D Hair Reconstruction

PreviousBad Case ExamplesNextGLB Constructor

Last updated 1 year ago

API METHODS

HTTP type
name

POST

/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

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

string($binary)
{
    "error": {
            "code": int
            "message": str
    }
}

Check in section for possible error response examples.

GLB Constructor Service
ERRORS
/run_pipeline