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
  • 0. unregistered token
  • 1. authorization fail
  • 2. schema is not loaded
  • 3. invalid checksum
  • 4. invalid model type
  • 5. invalid model id
  • 6. model must be in GLB format
  • 7. unable to load model
  • 8. reading schema error
  • 9. invalid head config
  • 10. invalid models config
  • 11. invalid model type in request
  • 12. invalid model ID in request
  • 13. invalid head_uv file
  • 14. head_uv file size must be less than 2 Mb
  • 15. model file size in custom_models must be less than 50 Mb
  • 16. invalid file in custom_models
  • 17. invalid json fields in head config
  • 18. internal error
  • 19. internal error: assemble
  • 20. missing schema
  • 21. schema error
  1. Errors

GLB Constructor

Previous3D Hair ReconstructionNextSLA

Last updated 1 year ago

0. unregistered token

{
  "error": {
    "code": 0,
    "message": "unregistered token"
  }
}

This error means that the provided token is not recognized by the service.

, or, if you already have one, make sure you entered it correctly.

1. authorization fail

{
  "error": {
    "code": 1,
    "message": "authorization fail"
  }
}

You are not authorized to access this service. .

2. schema is not loaded

{
  "error": {
    "code": 2,
    "message": "schema not loaded"
  }
}

You haven't uploaded the schema yet.

3. invalid checksum

{
  "error": {
    "code": 3,
    "message": "invalid checksum"
  }
}

Checksum does not match the saved model, which means errors occurred while uploading the model.

4. invalid model type

{
  "error": {
    "code": 4,
    "message": "invalid model type"
  }
}

The field 'data_type' is filled incorrectly. Please check your schema.

5. invalid model id

{
  "error": {
    "code": 5,
    "message": "invalid model id for type"
  }
}

The field 'data_id' is filled incorrectly. Please check your schema using POST /schema request.

6. model must be in GLB format

{
  "error": {
    "code": 6,
    "message": "model must be in glb format"
  }
}

The service could not read the file. Check if it's in the right format.

7. unable to load model

{
  "error": {
    "code": 7,
    "message": "model load fail"
  }
}

Error while parsing the uploaded model.

8. reading schema error

{
  "error": {
    "code": 8,
    "message": "schema reading problems"
  }
}

Error while reading the uploaded schema.

9. invalid head config

{
  "error": {
    "code": 9,
    "message": "invalid head config"
  }
}

10. invalid models config

{
  "error": {
    "code": 10,
    "message": "invalid models config"
  }
}

Correct config example:

{
   "hair" : [
      "hairF_01"
   ],
   "body": [
      "body_01"
   ]
}

11. invalid model type in request

{
  "error": {
    "code": 11,
    "message": "invalid types in models config"
  }
}

Request contains model type not declared in the models config.

12. invalid model ID in request

{
  "error": {
    "code": 12,
    "message": "model not loaded or invalid id in models config"
  }
}

Request contains model ID not declared in the models config, or model was not loaded via PUT /glb. Please check your schema via POST /schema request.

13. invalid head_uv file

{
  "error": {
    "code": 13,
    "message": "invalid head_uv file, image expected"
  }
}

Service expects image file.

14. head_uv file size must be less than 2 Mb

{
  "error": {
    "code": 14,
    "message": "head_uv image must be less than 2 Mb"
  }
}

Submitted image file is over the size limit.

15. model file size in custom_models must be less than 50 Mb

{
  "error": {
    "code": 15,
    "message": "each model in custom_models must be less than 50 Mb"
  }
}

Submitted GLB file is over the size limit.

16. invalid file in custom_models

{
  "error": {
    "code": 16,
    "message": "invalid files in custom_models, GLB format expected"
  }
}

The service could not read the file. Make sure it's in GLB format.

17. invalid json fields in head config

{
  "error": {
    "code": 17,
    "message": "invalid json fields in head config"
  }
}

Invalid JSON structure.

18. internal error

{
  "error": {
    "code": 18,
    "message": "internal error"
  }
}

19. internal error: assemble

{
  "error": {
    "code": 19,
    "message": "internal error: assemble fail"
  }
}

20. missing schema

{
  "error": {
    "code": 20,
    "message": "missing schema"
  }
}

21. schema error

{
  "error": {
    "code": 21,
    "message": "schema error"
  }
}

Schema can contain several possible formating errors:

1. Schema configuration must be enclosed in curly brackets.

For example:

{
   "hair" : [
      "hairM_01", "hairF_01"
   ],
   "body": [
      "body_01", "body_02"
   ]
}

or

{
}

for empty config.

2. Each model type must contain list (enclosed in brackets) of file IDs.

Correct config example:

{
   "hair" : [
      "hairM_01"
   ]
}

Wrong config example:

{
   "hair" : (
      "hairM_01"
   )
}

3. All model identifiers must be strings.

Wrong config example:

{
   "hair" : [
      0, 1, 2
   ],
   "body": [
      body_01, body_02
   ]
}

4. File IDs should be unique for each model type.

Wrong config example:

{
   "hair" : [
      "hairM_01", "hairM_01"
   ]
}

To get started, you need to download the schema and models. Please check section when getting started.

. If the problem persists, .

Try again. If the problem persists, .

Try again. If the problem persists, .

For config template see .

The same rules apply to the models config as to , with the exception that there should only be one ID in the model type list.

It is recommended that you use UV texture generated from the .

It is recommended that you use head config generated from the .

Internal error occured. Try again. If the problem persists, .

Internal error occured. Try again. If the problem persists, .

Upload schema first. Please check section when getting started.

Obtain a token
Contact support
the GLB Constructor Service
contact support
contact support
3D Face Reconstruction Service
3D Face Reconstruction Service
3D Face Reconstruction Service
contact support
contact support
the GLB Constructor Service
contact support
Try again
the schema