# 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 --- # 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.tryiton.now/api-reference/hairstyle-tryon.md?ask= ``` 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.