Name: Hair Changer V2 – Virtual Hair Try-On | Free · $9/mo | API.market
Brand: magicapi
SKU: api-magicapi-hair-v2
Availability: InStock
Rating: 5.00 (2 reviews)
Author: API Market

Shashank Agarwal

# 👩‍🦰➡️👩‍🦱 [NEW] Hair Changer API V2: Changes hair style and color for any Image.

The **Hair Changer v2 API** equips developers and AI engineers with robust, on-the-fly hair transformation capabilities. By simply uploading an image and specifying a hairstyle and hair color—and optionally a hair property—users can preview realistic transformations. This is perfect for virtual makeover apps, styling platforms, social media filters, and more.

> **Note:** 
> - **Average processing time** is ~20 seconds per request. 
> - **All requests are automatically deleted** 30 minutes after submission. 
> - **All output image URLs** are automatically deleted **48 hours** after generation.

---
## Examples generated using this Hair Style Changer API

| Example | Params | Input Image | Output Image |
|---------|--------|------------|--------------|
| 1 | - **haircolor**: Caramel Highlights - **hairstyle**: Buzz Cut - **hairproperty**: Natural texture with defined pattern | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_male.jpg) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/male/hairswapper_Buzz%20Cut_Natural%20texture%20with%20defined%20pattern.jpg) |
| 2 | - **haircolor**: Ash Blonde - **hairstyle**: Curtain Bangs - **hairproperty**: Short on sides, long on top | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_male.jpg) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/male/hairswapper_Curtain%20Bangs_Short%20on%20sides,%20long%20on%20top.jpg) |
| 3 | - **haircolor**: Silver - **hairstyle**: Braids - **hairproperty**: Thin and fine | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_male.jpg) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/male/hairswapper_Braids_Thin%20and%20fine.jpg) |
| 4 | - **haircolor**: Chocolate Brown - **hairstyle**: Undercut - **hairproperty**: Thick and coarse | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_male.jpg) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/male/hairswapper_Undercut_Thick%20and%20coarse.jpg) |
| 5 | - **haircolor**: Midnight Blue - **hairstyle**: Side Part - **hairproperty**: Voluminous with body | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_male.jpg) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/male/hairswapper_Side%20Part_Voluminous%20with%20body.jpg) |
| 6 | - **haircolor**: Pastel Pink - **hairstyle**: Slicked Back - **hairproperty**: Silky smooth with shine | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_male.jpg) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/male/hairswapper_Slicked%20Back_Silky%20smooth%20with%20shine.jpg) |
| 7 | - **haircolor**: Jet Black - **hairstyle**: Long Layers - **hairproperty**: Wavy with volume | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_male.jpg) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/male/hairswapper_Long%20Layers_Wavy%20with%20volume.jpg) |
| 8 | - **haircolor**: Auburn - **hairstyle**: Bob - **hairproperty**: Tight curls | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_male.jpg) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/male/hairswapper_Bob_Tight%20curls.jpg) |
| 9 | - **haircolor**: Copper Red - **hairstyle**: Shag - **hairproperty**: Frizzy at ends | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_male.jpg) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/male/hairswapper_Shag_Frizzy%20at%20ends.jpg) |
| 10 | - **haircolor**: Platinum Blonde - **hairstyle**: Pixie Cut - **hairproperty**: Straight and sleek | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_male.jpg) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/male/hairswapper_Pixie%20Cut_Straight%20and%20sleek.jpg) |
| 11 | - **haircolor**: Caramel Highlights - **hairstyle**: Buzz Cut - **hairproperty**: Natural texture with defined pattern | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_female.png) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/female/hairswapper_Buzz%20Cut_Natural%20texture%20with%20defined%20pattern.jpg) |
| 12 | - **haircolor**: Ash Blonde - **hairstyle**: Curtain Bangs - **hairproperty**: Short on sides, long on top | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_female.png) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/female/hairswapper_Curtain%20Bangs_Short%20on%20sides,%20long%20on%20top.jpg) |
| 13 | - **haircolor**: Silver - **hairstyle**: Braids - **hairproperty**: Thin and fine | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_female.png) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/female/hairswapper_Braids_Thin%20and%20fine.jpg) |
| 14 | - **haircolor**: Chocolate Brown - **hairstyle**: Undercut - **hairproperty**: Thick and coarse | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_female.png) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/female/hairswapper_Undercut_Thick%20and%20coarse.jpg) |
| 15 | - **haircolor**: Midnight Blue - **hairstyle**: Side Part - **hairproperty**: Voluminous with body | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_female.png) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/female/hairswapper_Side%20Part_Voluminous%20with%20body.jpg) |
| 16 | - **haircolor**: Pastel Pink - **hairstyle**: Slicked Back - **hairproperty**: Silky smooth with shine | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_female.png) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/female/hairswapper_Slicked%20Back_Silky%20smooth%20with%20shine.jpg) |
| 17 | - **haircolor**: Jet Black - **hairstyle**: Long Layers - **hairproperty**: Wavy with volume | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_female.png) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/female/hairswapper_Long%20Layers_Wavy%20with%20volume.jpg) |
| 18 | - **haircolor**: Auburn - **hairstyle**: Bob - **hairproperty**: Tight curls | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_female.png) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/female/hairswapper_Bob_Tight%20curls.jpg) |
| 19 | - **haircolor**: Copper Red - **hairstyle**: Shag - **hairproperty**: Frizzy at ends | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_female.png) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/female/hairswapper_Shag_Frizzy%20at%20ends.jpg) |
| 20 | - **haircolor**: Platinum Blonde - **hairstyle**: Pixie Cut - **hairproperty**: Straight and sleek | ![Input Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/original_image_female.png) | ![Output Image](http://dtu1vvf8tvi89.cloudfront.net/hairswap-images/female/hairswapper_Pixie%20Cut_Straight%20and%20sleek.jpg) |


---

## Features

1. **Unlimited Hairstyle Options** 
 - You can input literally **any** style, from “Brazilian Blowout” to “Pixie Cut” to “Retro Waves.” 

2. **Custom Hair Colors** 
 - Accepts free-text color specifications (e.g., “brunette,” “ash blonde,” “pastel pink”).

3. **Hair Property (Optional)** 
 - Optionally define characteristics like “straight,” “wavy,” or “curly.”

4. **Fast & High-Quality Processing** 
 - AI-driven transformations with an average **20-second** processing time.

5. **Secure & Scalable** 
 - API key-based authentication and cloud-based infrastructure ensure reliability at scale.

---

## Use Cases

1. **Virtual Salon & Makeover Tools** 
 Let users preview new styles before committing to a real salon visit.

2. **E-Commerce & Haircare Retail** 
 Integrate style previews to help shoppers select hair extensions, dyes, and treatments.

3. **Social Media & Influencer Apps** 
 Encourage user engagement with shareable, AI-generated transformations.

4. **Stylist & Salon Booking Platforms** 
 Provide a polished preview of potential styles, reducing miscommunication.

5. **Marketing & Advertising** 
 Generate visually engaging campaigns by personalizing hair transformations for target audiences.

---

## API Documentation

### Base URL
```
https://prod.api.market/api/v1/magicapi/hair-v2
```

### Authentication
Include your **API Market Key** in the header for every request:
```
x-magicapi-key: YOUR_API_MARKET_KEY
```

---

### 1. POST `/run`

**Description** 
Submit an image and styling parameters to initiate a hair transformation.

**Request Structure** 
```json
{
 "input": {
 "image": "<string: URL to the source image>",
 "haircolor": "<string: hair color description>",
 "hairstyle": "<string: hairstyle description>",
 "hairproperty": "<string: optional hair property>"
 }
}
```

| Field | Type | Required | Description |
|---------------|--------|----------|-------------------------------------------------------------------------------------------------------------------------------------|
| `image` | string | Yes | **URL** of the image to transform. |
| `haircolor` | string | Yes | Defines the hair color (e.g. “brunette,” “blonde,” “silver ombré”). |
| `hairstyle` | string | Yes | Any hairstyle description (e.g. “Brazilian Blowout,” “Pixie Cut,” “Retro Waves”). |
| `hairproperty`| string | No | Hair characteristic (e.g. “straight,” “wavy,” “curly”). This parameter is optional. |

**Sample Request**
```bash
curl -X 'POST' \
 'https://prod.api.market/api/v1/magicapi/hair-v2/run' \
 -H 'accept: application/json' \
 -H 'x-magicapi-key: YOUR_API_MARKET_KEY' \
 -H 'Content-Type: application/json' \
 -d '{
 "input": {
 "image": "https://blog.api.market/wp-content/uploads/2025/04/taylor_curl_hair.jpg",
 "haircolor": "brunette",
 "hairstyle": "Brazilian Blowout",
 "hairproperty": "straight"
 }
 }'
```

**Sample Response**
```json
{
 "id": "ffb7b753-4487-4858-89da-215bf3e5fe12-e1",
 "status": "IN_QUEUE"
}
```
Use the `id` in the next endpoint to track progress and retrieve the output image.

---

### 2. GET `/status/{id}`

**Description** 
Check the current status of your request and retrieve the result image (when ready).

**Path Parameter** 
- `id` *(string, required)*: Unique identifier returned by the **POST** `/run` call.

**Sample Request**
```bash
curl -X 'GET' \
 'https://prod.api.market/api/v1/magicapi/hair-v2/status/840293ff-6466-437d-bf45-639efa7a8c62-e1' \
 -H 'accept: application/json' \
 -H 'x-magicapi-key: YOUR_API_MARKET_KEY'
```

**Sample Response**
```json
{
 "delayTime": 1014,
 "executionTime": 22670,
 "id": "58e57a81-bca0-4db9-b334-049713e2be98-e1",
 "output": {
 "completed_at": "2025-04-09T05:43:27.139297+00:00",
 "image_url": "https://d3tx3wg2jy0sui.cloudfront.net/faceswap_videos/20250409_054326_f672c303.png",
 "started_at": "2025-04-09T05:43:04.519492+00:00"
 },
 "status": "COMPLETED"
}
```
When `status` is `"COMPLETED"`, `image_url` will contain the link to your transformed image.

---

## Status Codes

| HTTP Status | Meaning | Example Scenario |
|-------------|-------------------------|-------------------------------------------|
| 200 | OK / Request Accepted | Request or status retrieval succeeded. |
| 400 | Bad Request | Missing/invalid required parameters. |
| 401 | Unauthorized | Invalid or missing API key. |
| 404 | Not Found | Requested `id` does not exist. |
| 500 | Internal Server Error | Unexpected server error, retry later. |

---

## Pricing

- **POST** `/run` calls consume **1 API unit** each. 
- **GET** `/status/{id}` calls are **free** and consume **0 API units**.

---

## Example Transformation

**Input Image** 
![Input Image](https://blog.api.market/wp-content/uploads/2025/04/taylor_curl_hair.jpg)

**Parameters**
```json
{
 "haircolor": "brunette",
 "hairstyle": "Brazilian Blowout",
 "hairproperty": "straight"
}
```

**Output Image** 
![Output Image](https://blog.api.market/wp-content/uploads/2025/04/brazilian_blouwout.png)

---

### Sample Hairstyles


| | | | |
|---|---|---|---|
| afro hairstyle | bob cut hairstyle | bowl cut hairstyle | braid hairstyle |
| brazilian blowout hairstyle | caesar cut hairstyle | chignon hairstyle | cornrows hairstyle |
| crew cut hairstyle | crown braid hairstyle | curtained hair hairstyle | dido flip hairstyle |
| dreadlocks hairstyle | extensions hairstyle | fade hairstyle | fauxhawk hairstyle |
| finger waves hairstyle | french braid hairstyle | frosted tips hairstyle | full crown hairstyle |
| harvard clip hairstyle | hi-top fade hairstyle | high and tight hairstyle | hime cut hairstyle |
| jewfro hairstyle | jheri curl hairstyle | liberty spikes hairstyle | marcel waves hairstyle |
| mohawk hairstyle | pageboy hairstyle | perm hairstyle | pixie cut hairstyle |
| psychobilly wedge hairstyle | quiff hairstyle | regular taper cut hairstyle | ringlets hairstyle |
| shingle bob hairstyle | short hair hairstyle | slicked-back hairstyle | spiky hair hairstyle |
| surfer hair hairstyle | taper cut hairstyle | the rachel hairstyle | undercut hairstyle |
| updo hairstyle | blowout hairstyle | parted bob hairstyle | wavy bob hairstyle |
| butterfly haircut hairstyle | layered lob hairstyle | curly shag hairstyle | undone waves hairstyle |


Remember, you can combine terms (e.g., “layered pixie cut with bangs”) to get custom styles.

---

## SEO Keywords
hair changer api, ai-based hair editing, hairstyle transformations, hair color editing, virtual makeover solution, beauty and styling api, image transformation service, hairstyle change API

---

## Support
For technical help, best practices, or any other queries send us a message using the embedded chat on the bottom right corner or send us an email:
- **Email**: [support@api.market](mailto:support@api.market)

---

**Enjoy transforming hairstyles, hair colors, and hair properties with a few lines of code!**

Add virtual hair style and color try-on to your app. Realistic results in ~20 sec. Free 100 calls/mo, from $9/mo. Start free on API.market.

Hair Changer V2 – Virtual Hair Try-On | Free · $9/mo | API.market

FREE

MagicAPI

PAYG

START

ULTRA

MEGA

GIGA

BULK

One of the best HairStyle changer API, support literally every hairstyle and also preserves the full image instead of just giving a headshot like other APIs.

Empower users to experiment with hairstyles and colors: Seamlessly integrate Hair Changer API into your app for interactive hair modification capabilities.

Hair Changer V2: Enterprise Self-Hosting