Name: Hair Changer – Virtual Hair Try-On | Free · $8/mo | API.market
Brand: magicapi
SKU: api-magicapi-hair
Availability: InStock
Rating: 3.50 (4 reviews)
Author: API Market

<div 
  class="p-5 bg-red-200
 mb-5 border-2 rounded-md border-[#fdd835] dark:border-yellow-400 dark:bg-slate-700 text-black"
>
  <h2 class="mt-0">
    ⚠️ New Version Released!
  </h2>

  <p class="m-0">
    We have released a brand-new version of the Hair Changer API.
    <br>
    <strong>
      <a 
        href="https://api.market/store/magicapi/hair-v2" 
        style="color: inherit; text-decoration: none;"
        class="no-underline hover:underline"
      >
        Check it out here: Hair Changer API v2 (https://api.market/store/magicapi/hair-v2)
      </a>
    </strong>
  </p>
</div>

# 👩‍🦰➡️👩‍🦱 Hair Changer API Documentation

## Overview

The Hair Changer API empowers developers to seamlessly integrate hair transformation capabilities into their applications. Users can upload images and apply realistic modifications to their hairstyles and colors. The API is ideal for use in virtual makeover apps, beauty tools, fashion platforms, and beyond.

---

## **Features**

### 🎨 **Hair Editing**
- **Hairstyle Transformation**: Choose from 40+ predefined hairstyles to try out new looks.
- **Hair Color Modification**: Experiment with a wide range of hair colors using text-based prompts.
- **Combined Editing**: Apply both hairstyle and color transformations simultaneously.

### 🚀 **Ease of Integration**
- Simple REST API with JSON schema-based input.
- Detailed error messages for seamless debugging.
- Optimized for real-time responses to enhance user experience.

### 🔐 **Secure**
- API Key-based authentication ensures data privacy and secure access.
- Rate-limiting to prevent abuse and ensure fair usage.

### 📊 **High Performance**
- Supports high-resolution image input for professional-quality results.
- Optimized to handle bulk requests efficiently.

---

## **Use Cases**

### 1. **Virtual Makeover Applications**
Enable users to upload their photos and try different hairstyles and colors before heading to the salon.

### 2. **Fashion and Styling Platforms**
Integrate hair transformation features into platforms to help users discover their best look.

### 3. **E-Commerce for Hair Products**
Let customers visualize how they’d look with specific hair extensions, colors, or treatments.

### 4. **Beauty Salon Management Software**
Offer clients a preview of their desired hairstyle or color, increasing satisfaction and reducing guesswork.

### 5. **Marketing and Advertising**
Create personalized ad campaigns showcasing potential hair transformations for specific demographics.

### 6. **Social Media Tools**
Allow users to generate shareable content with their transformed hair looks.

---

## Base URL

**`https://api.magicapi.dev/api/v1/magicapi/hair`**

---

## Authentication

The API uses API Key-based authentication. Include your key in the header:

```http
x-magicapi-key: YOUR_API_KEY
```

---

## **Endpoints**

### 1. **POST `/hair`**

#### Description

This endpoint accepts an image and applies the specified hair transformations (hairstyle, color, or both).

#### **Request Schema**

- **`image`** (Required)  
  Type: `string`  
  Format: `uri`  
  Description: URL of the input image. The image will be resized and processed.

- **`editing_type`** (Optional)  
  Type: `string`  
  Default: `"hairstyle"`  
  Description: Specifies the type of editing.  
  Accepted values:  
    - `"hairstyle"`: Change hairstyle.  
    - `"color"`: Change hair color.  
    - `"both"`: Apply both hairstyle and color transformations.

- **`color_description`** (Optional)  
  Type: `string`  
  Description: Text description of the desired hair color (e.g., `"red"`, `"purple"`, `"blonde"`).  
  Valid only if `editing_type` is `"color"` or `"both"`.

- **`hairstyle_description`** (Optional)  
  Type: `string`  
  Description: Specifies the desired hairstyle.  
  Accepted values:  
    - `afro hairstyle`  
    - `bob cut hairstyle`  
    - `bowl cut hairstyle`  
    - `braid hairstyle`  
    - `caesar cut hairstyle`  
    - *(Full list included in the appendix)*

---

#### **Sample Request**

```bash
curl -X 'POST' \
  'https://api.magicapi.dev/api/v1/magicapi/hair/hair' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "image": "https://example.com/image.jpg",
    "editing_type": "both",
    "color_description": "blonde",
    "hairstyle_description": "bob cut hairstyle"
  }'
```

#### **Sample Response**

```json
{
  "request_id": "62pypdze7drg80ckjt8txvfj6c"
}
```

---

### 2. **GET `/predictions/{request_id}`**

#### Description

Retrieve the results of a hair transformation request using the `request_id` from the initial POST request.

#### **Path Parameters**

- **`request_id`** (Required)  
  Type: `string`  
  Description: The unique identifier for the transformation request.

---

#### **Sample Request**

```bash
curl -X 'GET' \
  'https://api.magicapi.dev/api/v1/magicapi/hair/predictions/62pypdze7drg80ckjt8txvfj6c' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: YOUR_API_KEY'
```

#### **Sample Response**

```json
{
  "status": "succeeded",
  "result": "https://replicate.delivery/czjl/lCKkqGJbE27TB11fAyPfwGapIAi2S7yRBgcFYGJrAPQCH03TA/output.png"
}
```

---

## **Error Codes**

| **HTTP Status** | **Error Code**     | **Message**                                                                 |
|------------------|--------------------|-----------------------------------------------------------------------------|
| 400              | `INVALID_INPUT`    | Missing or invalid input fields.                                           |
| 401              | `UNAUTHORIZED`     | Invalid or missing API Key.                                                |
| 404              | `NOT_FOUND`        | The specified `request_id` does not exist.                                 |
| 500              | `SERVER_ERROR`     | An unexpected error occurred. Please try again later or contact support.   |

---

## **Appendix**

### Full List of Hairstyles
The following values are accepted for the `hairstyle_description` parameter:

- `afro hairstyle`
- `bob cut hairstyle`
- `bowl cut hairstyle`
- `braid 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`

---

## **Support**

For questions or issues, please contact **support@magicapi.com**.


---
<div class="bg-slate-100 dark:bg-slate-700 p-5 mb-6 rounded-md text-xl">
  <strong>Notification:</strong> We have released a new version of the Hair Changer API!<br><br>
  <strong>Check it out here:</strong>
  <a href="https://api.market/store/magicapi/hair-v2" target="_blank" class="underline">
    Hair Changer API v2
  </a>
</div>

Virtually change hair style and color in any photo. Free 100 calls/mo, from $8/mo. Start free on API.market.

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

Hair Changer API

Free

MagicAPI

PAYG

Ultra

Mega

Giga

doesn't do as advertised, picture doesnt even look like user nor is the hairstyle or colour correct. And why tf have i got 2 heads 

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

👩‍🦰➡️👩‍🦱Hair Changer API: Changes hair style and color for any Image.

Hair Changer API: Private Cloud Deployment