Q: What is the Hairstyle API used for?

The Hairstyle API allows users to virtually try on different hairstyles using AI. It analyzes a face photo and applies predefined hairstyle styles (cuts, lengths, bangs, etc.) in a realistic way.

Q: Is the Hairstyle API a direct execution API or a style-based API?

It is a style-based API . You must query available hairstyle styles first , then run the hairstyle task using a selected style ID.

Q: What image requirements are needed for hairstyle try-on?

Typical requirements include: Clear front-facing face Hair visible (not bald, not fully covered) No extreme face angles JPG / JPEG / PNG File size < 10MB Long side ≤ 4096 px Common errors include: error_no_face error_hair_too_short error_bald_image error_large_face_angle

Q: Does the API support multiple faces in one image?

No. The Hairstyle API expects a single face only . If multiple people are detected, the task will fail with error_multiple_people .

Q: When are units consumed?

Units are consumed only when the task succeeds and a result image is generated. If the task fails, no units are deducted .

Question 1

What is the Hairstyle API used for?

Accepted Answer

The Hairstyle API allows users to virtually try on different hairstyles using AI. It analyzes a face photo and applies predefined hairstyle styles (cuts, lengths, bangs, etc.) in a realistic way.

Question 2

Is the Hairstyle API a direct execution API or a style-based API?

Accepted Answer

It is a style-based API.
You must query available hairstyle styles first, then run the hairstyle task using a selected style ID.

Question 3

How do I get the list of available hairstyles?

Accepted Answer

You can retrieve hairstyle styles using the style query APIs:

v1.0

GET /s2s/v1.0/task/style-group/hairstyle
GET /s2s/v1.0/task/style/hairstyle

v1.1 (recommended)

GET /s2s/v1.1/task/style/hairstyle

Version 1.1 supports category-based browsing and multi-layer categories.

Question 4

What image requirements are needed for hairstyle try-on?

Accepted Answer

Typical requirements include:

Clear front-facing face
Hair visible (not bald, not fully covered)
No extreme face angles
JPG / JPEG / PNG
File size < 10MB
Long side ≤ 4096 px

Common errors include:

error_no_face
error_hair_too_short
error_bald_image
error_large_face_angle

Question 5

Does the API support multiple faces in one image?

Accepted Answer

No.
The Hairstyle API expects a single face only. If multiple people are detected, the task will fail with error_multiple_people.

Question 6

When are units consumed?

Accepted Answer

Units are consumed only when the task succeeds and a result image is generated.
If the task fails, no units are deducted.

AI Hairstyle Try On API

Empower your beauty e-commerce/app or salon business with ultra-realistic Generative AI. Enable users to visualize hairstyles instantly with a single API call.

Ultra-Realistic Gen AI API Technology

Excellent Try-On Capabilities that Surpass Other AI Tools

True-to-Life Accuracy

How Does Our AI Hairstyle API Work

Initialize Request & Payload

AI Processing

AI Returns Results

Explore Our Interactive API Playground

Benefits for Developers

AI Hairstyle API FAQ

Start integrating the AI Hairstyle API today.

Bald

Buzzcut

Bowlcut

Short Curly

Curtain

Crewcut

Long Wavy

Long Wavy

Pixie

Long Straight

Bobcut

Curtain Wavy

Messy Bun

Two Braids

Loose Waves

Side Bob

Short Bob

Top Bun

Space Buns

Wolf Cut Long

Beachy

Bobcut Wavy

Medium Straight

Afro

Bobcut Curly

Gentle Waves

Combover

Curly Bob

Wave Brunette

Dark Wooly Curls

Blended Blonde Hair

Crewcut Purple

Long Wavy Blonde

Long Straight Black

Parted Bangs

Pixie Pink

Short Curly Indigo

Soft Chestnut Midcut

JavaScript & Java

Flutter

Python

PHP

Node.js