# Hairstyle Tryon Our **Virtual Hairstyle Try-On** endpoint provides realistic hair transformations using just one photo of a person. Explore a wide range of hairstyles and hair colors with exceptional accuracy. It’s our most advanced AI model for hair try-on experiences, designed to deliver high-quality and lifelike results. {% hint style="info" %} Model Specifications * **Processing Resolution**: 864×1296 pixels * **Processing Time**: 6 seconds * **Tryon Cost**: 1 per image {% endhint %} ### Request Generate a virtual try-on by sending a face image to the following endpoint: > **POST** `https://tryiton.now/api/v1/tryon/hairstyle` **Request Examples** {% tabs %} {% tab title="cURL" %} ```python curl -X POST "https://tryiton.now/api/v1/tryon/hairstyle" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "face_image": "https://example.com/path/to/face.png", "haircut": "TwinBraids" }' ``` {% endtab %} {% tab title="JavaScript" %} ```javascript fetch('https://tryiton.now/api/v1/tryon/hairstyle', { method: 'POST', body: JSON.stringify({ face_image: "https://example.com/path/to/face.png", haircut: "TwinBraids" }), headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', } }); ``` {% endtab %} {% tab title="Python" %} ```python import requests response = requests.post( "https://tryiton.now/api/v1/tryon/hairstyle", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "face_image": "https://example.com/path/to/face.png", "haircut": "TwinBraids" } ) ``` {% endtab %} {% endtabs %} **Response** {% tabs %} {% tab title="200" %} Returns a job ID for status polling:

Response

```python { "id": "64b7f1a9d9a3b8e5c7f9a123", "error": null } ```

{% endtab %} {% endtabs %} ### Request Parameters #### Required Parameters {% hint style="info" %} #### `face_image` image URL | base64 Primary image of the person's face on whom the virtual try-on will be performed. {% endhint %} {% hint style="danger" %} **Base64 Format** Base64 images must include the proper prefix (for example, `data:image/jpg;base64,`) {% endhint %}

{% hint style="info" %} #### `haircut` 'BuzzCut' | 'SlickBack' | ... The desired hairstyle to be tried on the `face_image`. You can select from a wide range of styles below. {% endhint %} {% tabs %} {% tab title="Men's Hairstyles" %}

{% endtab %} {% tab title="Women's Hairstyles" %}

{% endtab %} {% endtabs %} #### Optional Parameters {% hint style="info" %} #### `hair_color` 'blonde' | 'platinumBlonde' | ... The desired hair color to be tried on the `haircut`. You can select from a wide range of colors below. {% endhint %} {% tabs %} {% tab title="Hairstyle Colors" %}

{% endtab %} {% endtabs %} ### Response Polling After submitting your request, poll the status endpoint using the returned job ID. See [API Fundamentals](https://docs.tryiton.now/api-overview/api-fundamentals) for complete polling details. #### Successful Response When your virtual try-on completes successfully, the status endpoint will return: ```json { "id": "64b7f1a9d9a3b8e5c7f9a123", "status": "completed", "output": [ "https://cdn.tryiton.now/hairstyle/XXX.png" ], "error": null } ``` The `output` array contains URLs to your generated try-on images showing the model wearing the specified garment. ### Runtime Errors If an error occurs during inference (while the model is running), the API will return a 200 status code with a prediction `status: failed`. The response will also include an error object under the error key. #### The Error Object ```json { "error": { "name": "ErrorName", "message": "The error message" } } ``` Example of an error when polling the `/status` endpoint: ```json { "id": "64b7f1a9d9a3b8e5c7f9a123", "status": "failed", "error": { "name": "ImageLoadError", "message": "The image could not be found at the specified URL (404)." } } ``` If you encounter an unrecognized error, please contact us at