# 3D Face Reconstruction

### 0. unregistered token

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

This error means that the service does not know of such a token.

[Get a token](/service-apis-for-creating-virtual-avatars/getting-started/getting-a-token.md), or if it has already been received, check it for typos.

### 1. fail authorization

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

Your access is limited. [Contact support](/service-apis-for-creating-virtual-avatars/welcome/about-us.md).

### 3. the file is too large

```json
{
  "error": {
    "code": 3,
    "message": "file must be less than 10mb"
  }
}
```

You are trying to send an image that is over the size limit. Compress your image.

### 4. face not found

```json
{
  "error": {
    "code": 4,
    "message": "face not found"
  }
}
```

No face found in photo.

If the face is really in the photo, then there are possible problems with the image:

* bad image quality
* face is covered
* too much head turn
* body art

### 5. invalid input image 

```json
{
  "error": {
    "code": 5,
    "message": "file corrupted"
  }
}
```

You sent a picture with an unsupported resolution.

Convert it to any of the following formats:

* png (PNG)
* jpg (JPG, JPEG)
* HEIC
* bmp
* webp

### 6. empty input image

```json
{
  "error": {
    "code": 6,
    "message": "empty input image"
  }
}
```

The server received an empty file. Check out its contents.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.metahumansdk.io/service-apis-for-creating-virtual-avatars/errors/3d-face-reconstruction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.