Hairstyle Changer Pro API leverages a state-of-the-art stable diffusion model to offer an extensive range of hairstyle and hair color transformations. Ideal for virtual makeover apps, beauty and fashion platforms, and social media content creation, this API enables users to experiment with numerous hairstyles and colors seamlessly. Using advanced AI technology, the API ensures precise and realistic adjustments, mapping hairstyles accurately to the subject’s head and facial features. Integrate the Hairstyle Changer Pro API to elevate user engagement, personalize styling options, and streamline virtual try-on experiences. With its high performance, scalability, and easy integration, this API is an essential tool for any modern digital beauty application.

Application Scenarios

• Portrait beautification: Edit and modify the hairstyle in the portrait image for portrait beautification scenes to easily enhance the user’s image.

• Hair design: Users can directly edit hairstyles and intuitively experience a variety of hair designs to enhance the personalized experience of customers in the beauty and hairdressing industry.

• Interactive entertainment: In short videos, social platforms, or integrated into photo album type apps, add hair style editing play to users’ personalized photos to attract users’ interactive participation and sharing.

Featured Advantages

• Accurate recognition: based on deep learning algorithm, accurate face recognition.

• Wide range of applications: meet the needs of diverse business scenarios, applicable to users of different ages and genders.

Rendering

Men’s Hairstyles

Original Image

Result Images

Buzz Cut hair	UnderCut hair	Pompadour hair	Slick Back hair	Curly Shag hair
Wavy Shag hair	Faux Hawk hair	Spiky hair	Comb-over hair	High and Tight Fade hair
Man Bun hair	Afro hair	Low Fade hair	Undercut With Long Hair	Two Block Haircut
Textured Fringe Hair	Blunt Bowl Cut	Long Wavy Curtain Bangs Hair	Messy Tousled hair	Medium Length Wavy hair
Cornrow Braids hair	Long Hair Tied Up Hair	Middle-parted Hair

Women’s Hairstyles

Original Image

Result Images

Short Pixie With Shaved Sides	short neat bob hair	double bun hair	Updo hair	spiked hair
bowl cut hair	Chignon hair	Pixie Cut hair	slicked back hair	Long curly hair
Curly bob hair	Stacked Curls in Short Bob hair	Side Part Comb-Over Hairstyle With High Fade hair	Wavy French Bob Vibes from 1920	bob Haircut hair
Short Twintails hair	Short Curly Pixie	Long straight hair	Long wavy hair	Fishtail braid hair
Twin Braids hair	Ponytail hair	dreadlocks hair	Cornrows hair	Shoulder Length Straight Hair
Loose Curly Afro hair	Long Twintails hair	Long Hime Cut hair	Box Braids hair

Hairstyle Colors

Original Image

Result Images

blonde hair	platinum blonde hair	brown hair	light brown hair	blue hair
dark blue hair	light blue hair	purple hair	light purple hair	pink hair
black hair	white hair	grey hair	silver hair	red hair
burgundy hair	orange hair	green hair	dark green hair	gradient hair
multicolored hair

---

Hairstyle Changer Pro (Async)

Request Description

This API is an asynchronous API, please save the task_id; then, use the task_id to request ‘Retrieve Task Results by task_id’ to obtain the task results.

• Image requirements

  • Image format: PNG JPG JPEG

  • Image size: No more than 3 MB.

  • Image resolution: Larger than 200x200px, smaller than 1999x1999px.

  • Minimum Face Proportion: To ensure effectiveness, the proportion of the face in the image cannot be less than 20%.

  • Facial Integrity: To ensure effectiveness, the face in the image should ideally not be obscured.

  • Facial Angle: To ensure effectiveness, the face in the image should ideally be front-facing, with no more than a 45-degree rotation to the left or right.

• Request Parameters

Field	Required	Type	Scope	Default	Description
task_type	YES	string	async		Task Type. async: Asynchronous tasks.
auto	YES	integer	1	0	1: Automatic mode. If automatic mode is not used, please refer to the old version documentation for integration.
image	YES	file			Main image.
hair_style	YES	string	BuzzCut UnderCut Pompadour SlickBack CurlyShag WavyShag FauxHawk Spiky CombOver HighTightFade ManBun Afro LowFade UndercutLongHair TwoBlockHaircut TexturedFringe BluntBowlCut LongWavyCurtainBangs MessyTousled MediumLengthWavy CornrowBraids LongHairTiedUp Middle-parted ShortPixieWithShavedSides ShortNeatBob DoubleBun Updo Spiked bowlCut Chignon PixieCut SlickedBack LongCurly CurlyBob StackedCurlsInShortBob SidePartCombOverHairstyleWithHighFade WavyFrenchBobVibesfrom1920 BobCut ShortTwintails ShortCurlyPixie LongStraight LongWavy FishtailBraid TwinBraids Ponytail Dreadlocks Cornrows ShoulderLengthHair LooseCurlyAfro LongTwintails LongHimeCut BoxBraids		BuzzCut: Buzz Cut hair UnderCut: UnderCut hair Pompadour: Pompadour hair SlickBack: Slick Back hair CurlyShag: Curly Shag hair WavyShag: Wavy Shag hair FauxHawk: Faux Hawk hair Spiky: Spiky hair CombOver: Comb-over hair HighTightFade: High and Tight Fade hair ManBun: Man Bun hair Afro: Afro hair LowFade: Low Fade hair UndercutLongHair: Undercut With Long Hair TwoBlockHaircut: Two Block Haircut TexturedFringe: Textured Fringe Hair BluntBowlCut: Blunt Bowl Cut LongWavyCurtainBangs: Long Wavy Curtain Bangs Hair MessyTousled: Messy Tousled hair MediumLengthWavy: Medium Length Wavy hair CornrowBraids: Cornrow Braids hair LongHairTiedUp: Long Hair Tied Up Hair Middle-parted: Middle-parted Hair ShortPixieWithShavedSides: Short Pixie With Shaved Sides ShortNeatBob: short neat bob hair DoubleBun: double bun hair Updo: Updo hair Spiked: spiked hair bowlCut: bowl cut hair Chignon: Chignon hair PixieCut: Pixie Cut hair SlickedBack: slicked back hair LongCurly: Long curly hair CurlyBob: Curly bob hair StackedCurlsInShortBob: Stacked Curls in Short Bob hair SidePartCombOverHairstyleWithHighFade: Side Part Comb-Over Hairstyle With High Fade hair WavyFrenchBobVibesfrom1920: Wavy French Bob Vibes from 1920 BobCut: bob Haircut hair ShortTwintails: Short Twintails hair ShortCurlyPixie: Short Curly Pixie LongStraight: Long straight hair LongWavy: Long wavy hair FishtailBraid: Fishtail braid hair TwinBraids: Twin Braids hair Ponytail: Ponytail hair Dreadlocks: dreadlocks hair Cornrows: Cornrows hair ShoulderLengthHair: Shoulder Length Straight Hair LooseCurlyAfro: Loose Curly Afro hair LongTwintails: Long Twintails hair LongHimeCut: Long Hime Cut hair BoxBraids: Box Braids hair
color	NO	string	blonde platinumBlonde brown lightBrown blue lightBlue purple lightPurple pink black white grey silver red orange green gradient multicolored darkBlue burgundy darkGreen		blonde: blonde hair platinumBlonde: platinum blonde hair brown: brown hair lightBrown: light brown hair blue: blue hair lightBlue: light blue hair purple: purple hair lightPurple: light purple hair pink: pink hair black: black hair white: white hair grey: grey hair silver: silver hair red: red hair orange: orange hair green: green hair gradient: gradient hair multicolored: multicolored hair darkBlue: blue hair burgundy: burgundy hair darkGreen: dark green
image_size	NO	integer	1 2 3 4	1	Returns the number of images.

Response Description

• Response Parameters

Field	Type	Description
error_code	integer	Error Code.
error_msg	string	Error Message.
request_id	string	Request ID.
task_id	string	Task ID.

---

Retrieve Task Results by task_id

Request Description

Retrieve asynchronous task results by task_id.

• Request Parameters

Field	Required	Type	Description
task_id	YES	string	Task id：task_id

Response Description

• Response Parameters

Field	Type	Description
error_code	integer	Error Code.
error_msg	string	Error Message.
request_id	string	Request ID.
task_status	integer	Asynchronous task status. 0: The task is queued. 1: Asynchronous processing. 2: Processing was successful.
data	object	The content of the result data returned.
+images	array	Result URL address. Note: The URL address is a temporary address, valid for 24 hours, and will not be accessible after the expiration date.