Name: Hairstyle Changer – AI Hair Makeover | Free · $10/mo | API.market
Brand: ailabtools
SKU: api-ailabtools-hairstyle-changer-pro
Availability: InStock
Rating: 5.00 (1 reviews)
Author: API Market

# 💇‍♀️🖼️Hairstyle Changer Pro API

The Hairstyle Changer Pro API offers a professional solution for virtual hair makeovers. It operates in two stages—front-end photo validation and backend hairstyle processing—to ensure that input images meet strict quality standards before applying the desired hairstyle and color. The API works asynchronously and returns a task ID for later result retrieval.

## Hairstyle Images

<div align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/OriginalImage-hairstyle-1.webp" alt="Original Image" style="max-width:40%; border-radius:8px;">
 <h4>Original Image</h4>
</div>

 

<table>
 
 <tr>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-BuzzCut-2.webp" alt="Buzz Cut hair" style="max-width:100%; border-radius:8px;"> 
 Buzz Cut hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-UnderCut-2.webp" alt="UnderCut hair" style="max-width:100%; border-radius:8px;"> 
 UnderCut hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-Pompadour-2.webp" alt="Pompadour hair" style="max-width:100%; border-radius:8px;"> 
 Pompadour hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-SlickBack-2.webp" alt="Slick Back hair" style="max-width:100%; border-radius:8px;"> 
 Slick Back hair
 </td>
 </tr>
 
 <tr>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-CurlyShag-2.webp" alt="Curly Shag hair" style="max-width:100%; border-radius:8px;"> 
 Curly Shag hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-WavyShag-2.webp" alt="Wavy Shag hair" style="max-width:100%; border-radius:8px;"> 
 Wavy Shag hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-FauxHawk-2.webp" alt="Faux Hawk hair" style="max-width:100%; border-radius:8px;"> 
 Faux Hawk hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-Spiky-2.webp" alt="Spiky hair" style="max-width:100%; border-radius:8px;"> 
 Spiky hair
 </td>
 </tr>
 
 <tr>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-CombOver-2.webp" alt="Comb-over hair" style="max-width:100%; border-radius:8px;"> 
 Comb-over hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-HighTightFade-2.webp" alt="High and Tight Fade hair" style="max-width:100%; border-radius:8px;"> 
 High and Tight Fade hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-ManBun-2.webp" alt="Man Bun hair" style="max-width:100%; border-radius:8px;"> 
 Man Bun hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-Afro-2.webp" alt="Afro hair" style="max-width:100%; border-radius:8px;"> 
 Afro hair
 </td>
 </tr>
 
 <tr>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-LowFade-2.webp" alt="Low Fade hair" style="max-width:100%; border-radius:8px;"> 
 Low Fade hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-UndercutLongHair-2.webp" alt="Undercut With Long Hair" style="max-width:100%; border-radius:8px;"> 
 Undercut With Long Hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-TwoBlockHaircut-2.webp" alt="Two Block Haircut" style="max-width:100%; border-radius:8px;"> 
 Two Block Haircut
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-TexturedFringe-2.webp" alt="Textured Fringe Hair" style="max-width:100%; border-radius:8px;"> 
 Textured Fringe Hair
 </td>
 </tr>
 
 <tr>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-BluntBowlCut-2.webp" alt="Blunt Bowl Cut" style="max-width:100%; border-radius:8px;"> 
 Blunt Bowl Cut
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-LongWavyCurtainBangs-2.webp" alt="Long Wavy Curtain Bangs Hair" style="max-width:100%; border-radius:8px;"> 
 Long Wavy Curtain Bangs Hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-MessyTousled-2.webp" alt="Messy Tousled hair" style="max-width:100%; border-radius:8px;"> 
 Messy Tousled hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-CornrowBraids-2.webp" alt="Cornrow Braids hair" style="max-width:100%; border-radius:8px;"> 
 Cornrow Braids hair
 </td>
 </tr>
 
 <tr>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-LongHairTiedUp-2.webp" alt="Long Hair Tied Up Hair" style="max-width:100%; border-radius:8px;"> 
 Long Hair Tied Up Hair
 </td>
 <td align="center">
 <img src="https://ai-resource.ailabtools.com/hairstyle-changer-pro/doc/ResultImage-hairstyle-1-Middle-parted-2.webp" alt="Middle-parted Hair" style="max-width:100%; border-radius:8px;"> 
 Middle-parted Hair
 </td>
 
 <td align="center"></td>
 <td align="center"></td>
 </tr>
</table>

## Features
- **Two-Stage Workflow:** 
 Leverage a front-end validation step (using face analysis) to ensure images meet API standards before processing.
- **Diverse Hairstyle Options:** 
 Select from a wide range of hairstyle categories tailored for male and female subjects.
- **Customizable Color Selection:** 
 Optionally specify hair color from a detailed list (e.g., blonde, platinum blonde, brown, etc.).
- **Configurable Output Quantity:** 
 Control the number of output images with the `image_size` parameter.
- **Asynchronous Processing:** 
 Submit requests and receive a task ID to query the processed images later.

## Use-Cases
- **Virtual Makeover Applications:** 
 Allow users to preview various hairstyles and colors for personalized style makeovers.
- **E-Commerce and Fashion Platforms:** 
 Enhance product imagery by showcasing models with diverse, realistic hairstyles.
- **Digital Content Creation:** 
 Generate multiple styled images for marketing, social media, and creative projects.
- **Beauty and Styling Tools:** 
 Integrate into mobile and web apps to offer dynamic hair transformation features.

## API Documentation

### Step 1: Schedule a Job (POST Request)
Send a POST request to generate the Task Id. This consumes one API unit
**Request:**

```bash
curl -X 'POST' \
 'https://prod.api.market/api/v1/ailabtools/hairstyle-changer-pro/portrait/editing/hairstyle-pro' \
 -H 'accept: application/json' \
 -H 'x-magicapi-key: <YOUR API MARKET KEY>' \
 -H 'Content-Type: multipart/form-data' \
 -F 'task_type=async' \
 -F 'image=@Markus-Beck-portrait-less-than-1MB-scaled-qnfhmm6p6lo14h0jjs50p6bg31bc1nv9i7rk0hq8a8.jpg;type=image/jpeg' \
 -F 'hair_style=BuzzCut' \
 -F 'color=lightBlue' \
 -F 'image_size=2'
```
**Response:**
```json
{
 "error_code": 0,
 "error_detail": {
 "status_code": 200,
 "code": "",
 "code_message": "",
 "message": ""
 },
 "task_id": "1744050593863.79a04cea-c34c-ef60-1826-af06d25115ab",
 "task_type": "async"
}
```
You’ll receive a <task_id> to track the progress.

#### Image Requirements
- **Formats:** PNG, JPG, JPEG 
- **Max File Size:** 3 MB 
- **Resolution:** 200×200px to 1999×1999px 
- **Additional Criteria:** 
 - Minimum face proportion: ≥ 20% 
 - Face must be intact and unobscured 
 - Face angle should be within 45° of front-facing

#### Request Body Fields

| Field | Required | Type | Options / Range | Default | Description |
|---------------|:--------:|---------|-----------------|---------|-------------------------------------------------------------------------------------------------------|
| `task_type` | Yes | string | `async` | — | Indicates asynchronous processing. |
| `auto` | Yes | integer | 1 | 1 | Mode selection; `1` signifies automatic mode. |
| `image` | Yes | file | — | — | The main validated portrait image. |
| `hair_style` | Yes | string | See below | — | Hairstyle selection. Choose a code based on gender and desired style. |
| `color` | No | string | See below | — | (Optional) Hair color selection code. |
| `image_size` | No | integer | 1, 2, 3, or 4 | 1 | The number of output images to return. |

**Hairstyle Options:**

*For Male:*
- `BuzzCut`, `UnderCut`, `Pompadour`, `SlickBack`, `CurlyShag`, `WavyShag`, `FauxHawk`, `Spiky`, `CombOver`, `HighTightFade`, `ManBun`, `Afro`, `LowFade`, `UndercutLongHair`, `TwoBlockHaircut`, `TexturedFringe`

*For Female:*
- `ShortPixieWithShavedSides`, `short neat bob hair`, `double bun hair`, `Updo`, `spiked hair`, `bowl cut hair`, `Chignon`, `PixieCut`, `slicked back hair`, `LongCurly`, `Curly bob hair`, `StackedCurlsInShortBob`, `SidePartCombOverHairstyleWithHighFade`, `WavyFrenchBobVibesfrom1920`, `bob Haircut hair`, `ShortTwintails`, `Short Curly Pixie`, `LongStraight`, `LongWavy`, `FishtailBraid`, `TwinBraids`, `Ponytail`, `dreadlocks hair`, `Cornrows hair`, `Shoulder Length Straight Hair`, `Loose Curly Afro`, `Long Twintails`, `Long Hime Cut hair`, `Box Braids`

**Color Options:**

| Code | Description |
|-------------------|----------------------------|
| `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` | Dark blue hair |
| `burgundy` | Burgundy hair |
| `darkGreen` | Dark green hair |


### Step 2: Check Status (GET Request)
Call this endpoint as many times as you need—these calls are free.

**Request:**
```bash
curl -X 'GET' \
 'https://prod.api.market/api/v1/ailabtools/hairstyle-changer-pro/api/apimarket/query-async-task-result?task_id=1744050593863.79a04cea-c34c-ef60-1826-af06d25115ab' \
 -H 'accept: application/json' \
 -H 'x-magicapi-key: <YOUR API MARKET KEY>'
```
**Response**:
```json
{
 "data": {
 "images": [
 "https://ailab-result-rapidapi.oss-accelerate.aliyuncs.com/faceBody/hairstyle/2025-04-08/BuzzCut_20250408022959412545_4hzrkiyf5ba6aqvyf2ps.jpeg",
 "https://ailab-result-rapidapi.oss-accelerate.aliyuncs.com/faceBody/hairstyle/2025-04-08/BuzzCut_20250408022959412786_s34duednoxqug5lgwby7.jpeg"
 ]
 },
 "error_code": 0,
 "error_detail": {
 "status_code": 200,
 "code": "",
 "code_message": "",
 "message": ""
 },
 "error_msg": "",
 "task_status": 2
}
```
The response includes images.




### Status Codes & Error Handling

| Field | Description |
|---------------|----------------------------------------------------------------------------------------------------------|
| `error_code` | A value of `0` indicates success; non‑zero values denote specific errors (e.g., invalid input or file format issues). |
| `error_msg` | Provides a brief description of any errors encountered. |
| `status_code` | Standard HTTP status codes (e.g., `200` for success, `400` for bad requests) provided in `error_detail`. |

## SEO Keywords
hairstyle changer pro API, virtual hair makeover, AI hairstyle transformation, digital hair styling, face validation hair API, asynchronous hairstyle processing, portrait hair editor, AI beauty hair API, virtual hair simulation

Virtually change hairstyles and hair colors in images. With built-in photo validation. Free 10 calls/mo, from $10/mo. Try it free on API.market.

Hairstyle Changer – AI Hair Makeover | Free · $10/mo | API.market

BASIC