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.

Model Specifications

• Processing Resolution: 864×1296 pixels

• Processing Time: 6 seconds

• Tryon Cost: 1 per image

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

cURL

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"
  }'

JavaScript

Python

Response

200

Returns a job ID for status polling:

Response

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

Request Parameters

Required Parameters

face_image image URL | base64

Primary image of the person's face on whom the virtual try-on will be performed.

Base64 Format

Base64 images must include the proper prefix (for example, data:image/jpg;base64,<YOUR_BASE64>)

haircut 'BuzzCut' | 'SlickBack' | ...

The desired hairstyle to be tried on the face_image. You can select from a wide range of styles below.

Men's Hairstyles

Original Image

BuzzCut

UnderCut

Pompadour

SlickBack

CurlyShag

WavyShag

FauxHawk

Spiky

CombOver

HighTightFade

ManBun

Afro

LowFade

UndercutLongHair

TwoBlockHaircut

TexturedFringe

BluntBowlCut

LongWavyCurtainBangs

MessyTousled

CornrowBraids

LongHairTiedUp

Middle-parted

Women's Hairstyles

Optional Parameters

hair_color 'blonde' | 'platinumBlonde' | ...

The desired hair color to be tried on the haircut. You can select from a wide range of colors below.

Hairstyle Colors

Original Image

blonde

platinumBlonde

brown

lightBrown

blue

darkBlue

lightBlue

purple

lightPurple

pink

black

white

grey

silver

red

burgundy

orange

green

darkGreen

Response Polling

After submitting your request, poll the status endpoint using the returned job ID. See API Fundamentals for complete polling details.

Successful Response

When your virtual try-on completes successfully, the status endpoint will return:

{
  "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

{
  "error": {
    "name": "ErrorName",
    "message": "The error message"
  }
}

Example of an error when polling the /status endpoint:

{
  "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 [email protected]