# 3D Hair Reconstruction
## 1. Getting a token
[Getting a token](https://docs.metahumansdk.io/service-apis-for-creating-virtual-avatars/getting-started/getting-a-token)
## 2. Choice of photo
Choose a photo of a person.
{% hint style="warning" %}
Note: The quality of the photo must be a good resolution.
{% endhint %}
{% hint style="warning" %}
Note: Hair should be clearly visible.
{% endhint %}
{% hint style="warning" %}
Note: So far, we are unable to work well with ponytails and pigtails.
{% endhint %}
{% hint style="info" %}
Need a successful image? [Download a sample](https://www.freepik.com/download-file/9631091)
{% endhint %}
## 3. Reconstruct 3D Hair
Make a request by sending your chosen photo. Make sure you are using the mode you really need. `'card'` mode is used by default.
{% tabs %}
{% tab title="curl" %}
```bash
token="ENTER_YOUR_TOKEN"
image_path="ENTER_IMAGE_PATH"
curl -X 'POST' \
'https://api.metahumansdk.io/hair_recon/run_pipeline' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-F "token=$token" \
-F "image_bytes=@$image_path;type=image/png" > hair.glb \
-F 'mode=card'
```
{% endtab %}
{% tab title="python" %}
{% code lineNumbers="true" %}
```python
import requests
token = "ENTER_YOUR_TOKEN"
image_path = "ENTER_IMAGE_PATH"
if __name__ == "__main__":
service_url = "https://api.metahumansdk.io/hair_recon"
service_headers = {"accept": "application/json"}
files = {
"token": (None, token),
"image_bytes": ("image", open(image_path, "rb"), "image/png"),
"mode": (None, "card") # card or volume
}
response_config = requests.post(service_url + "/run_pipeline", headers=service_headers, files=files, stream=True)
with open("hair.glb", "wb") as f:
f.write(response_config.content)
```
{% endcode %}
{% endtab %}
{% endtabs %}
The expected result is the `hair.glb` file.
## 4. Check GLB model
Check saved file in GLB viewer (for example in Blender).
### Examples of results
Open in Blender
Original photo
Reconstructed hair mesh in card mode
Reconstructed hair mesh in volume mode
### Example rendering
Rendering in Blender
Rendered hair mesh in card mode
Rendered hair mesh in volume mode
## 5. Visualization with head
In order to get a 3D model of the head with hair, we will use GLB Constructor:
{% hint style="danger" %}
GLB Constructor currently supports only hair in***`volume`*** mode
{% endhint %}
{% hint style="info" %}
At this step it is assumed that you have already received `uv.png` and `head_config.json`from 3D Face Reconstruction tab.
{% endhint %}
{% tabs %}
{% tab title="curl" %}
```bash
token="ENTER_YOUR_TOKEN"
curl -X 'POST' 'https://api.metahumansdk.io/glb_const/assemble' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-F "token=$token" \
-F 'head_uv=@uv.png;type=image/png' \
-F 'head_config=@head_config.json;type=application/json' \
-F 'custom_models=@hair.glb;type=image/png' \
-F 'add_facs=true' > head.glb
```
{% endtab %}
{% tab title="python" %}
```python
import io
import json
import requests
token = "ENTER_YOUR_TOKEN"
if __name__ == "__main__":
service_url = "https://api.metahumansdk.io/glb_const"
service_headers = {'accept': 'application/json'}
with open('uv.png', 'rb') as out:
head_uv = out.read()
with open('head_config.json', 'r') as out:
head_config = json.loads(out.read())
with open('hair.glb', 'rb') as out:
custom_hair = out.read()
files = {
'token': (None, token),
'head_uv': ('head_model', head_uv, 'image/png'),
'head_config': ('head_config', json.dumps(head_config), 'application/json'),
'custom_models': ('custom_models', io.BytesIO(custom_hair), 'application/json'),
'add_facs': (None, True),
}
response = requests.post(service_url + "/assemble", headers=service_headers, files=files)
assert (response.status_code == 200)
with open("head.glb", "wb") as f:
f.write(response.content)
```
{% endtab %}
{% endtabs %}
After the completed stages, you get a glb model `head.glb` .
Result:
