Name: Face Beauty Pro – AI Portrait Retouching | Free · $10/mo | API.market
Brand: ailabtools
SKU: api-ailabtools-face-beauty-pro
Availability: InStock
Author: API Market

# 🙂✨Face Beauty Pro API

## Overview
The Face Beauty Pro API provides advanced AI-powered enhancements for portrait images. It offers granular control over multiple facial retouching parameters—including whitening, smoothing, face slimming, small face adjustment, eye enlargement, and eyebrow removal—along with a wide range of filter effects. This API is optimized for images up to 2 MB and supports various common formats, enabling professional-level beauty adjustments for digital portraits.
## Image Examples
**Face Beauty**
| | ORIGINAL IMAGE | RESULT IMAGE |
|:---|:------------------:|:------------------:|
| `whitening` = `70` | ![ORIGINAL IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/OriginalImage-1.webp) | ![RESULT IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-whitening-70-1.webp) |
| `smoothing` = `70` | ![ORIGINAL IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/OriginalImage-1.webp) | ![RESULT IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-smoothing-70-1.webp) |
| `thinface` = `70` | ![ORIGINAL IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/OriginalImage-1.webp) | ![RESULT IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-thinface-70-1.webp) |
| `shrink_face` = `70` | ![ORIGINAL IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/OriginalImage-1.webp) | ![RESULT IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-shrink_face-70-1.webp) |
| `enlarge_eye` = `70` | ![ORIGINAL IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/OriginalImage-1.webp) | ![RESULT IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-enlarge_eye-70-1.webp) |
| `remove_eyebrow` = `70` | ![ORIGINAL IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/OriginalImage-1.webp) | ![RESULT IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-remove_eyebrow-70-1.webp) |
| `whitening` = `70` `smoothing` = `70` `thinface` = `70` `shrink_face` = `70` `enlarge_eye` = `70` `remove_eyebrow` = `70` | ![ORIGINAL IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/OriginalImage-1.webp) | ![RESULT IMAGE](https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-all-70-1.webp) |

**Filters**

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

 


<table style="width:100%; text-align:center;">
 
 <tr>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-1-1.webp" alt="Black and White" style="max-width:100%; border-radius:8px;"> 
 Black and White
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-2-1.webp" alt="Calm" style="max-width:100%; border-radius:8px;"> 
 Calm
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-3-1.webp" alt="Sunny Day" style="max-width:100%; border-radius:8px;"> 
 Sunny Day
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-4-1.webp" alt="Journey" style="max-width:100%; border-radius:8px;"> 
 Journey
 </td>
 </tr>
 
 <tr>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-5-1.webp" alt="Beautify Skin" style="max-width:100%; border-radius:8px;"> 
 Beautify Skin
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-6-1.webp" alt="Hong Kong Style" style="max-width:100%; border-radius:8px;"> 
 Hong Kong Style
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-7-1.webp" alt="Aesthetic" style="max-width:100%; border-radius:8px;"> 
 Aesthetic
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-8-1.webp" alt="Lovely" style="max-width:100%; border-radius:8px;"> 
 Lovely
 </td>
 </tr>
 
 <tr>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-9-1.webp" alt="New York" style="max-width:100%; border-radius:8px;"> 
 New York
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-10-1.webp" alt="Sakura" style="max-width:100%; border-radius:8px;"> 
 Sakura
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-11-1.webp" alt="Seventeen" style="max-width:100%; border-radius:8px;"> 
 Seventeen
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-12-1.webp" alt="Soft Light" style="max-width:100%; border-radius:8px;"> 
 Soft Light
 </td>
 </tr>
 
 <tr>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-13-1.webp" alt="Afternoon Tea" style="max-width:100%; border-radius:8px;"> 
 Afternoon Tea
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-14-1.webp" alt="Brighten Skin" style="max-width:100%; border-radius:8px;"> 
 Brighten Skin
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-15-1.webp" alt="Chaplin" style="max-width:100%; border-radius:8px;"> 
 Chaplin
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-16-1.webp" alt="Floral" style="max-width:100%; border-radius:8px;"> 
 Floral
 </td>
 </tr>
 
 <tr>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-17-1.webp" alt="Memories" style="max-width:100%; border-radius:8px;"> 
 Memories
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-18-1.webp" alt="Ice Beauty" style="max-width:100%; border-radius:8px;"> 
 Ice Beauty
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-19-1.webp" alt="Paris" style="max-width:100%; border-radius:8px;"> 
 Paris
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-20-1.webp" alt="Time" style="max-width:100%; border-radius:8px;"> 
 Time
 </td>
 </tr>
 
 <tr>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-21-1.webp" alt="LOMO" style="max-width:100%; border-radius:8px;"> 
 LOMO
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-22-1.webp" alt="Old Times" style="max-width:100%; border-radius:8px;"> 
 Old Times
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-23-1.webp" alt="Early Spring" style="max-width:100%; border-radius:8px;"> 
 Early Spring
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-24-1.webp" alt="Story" style="max-width:100%; border-radius:8px;"> 
 Story
 </td>
 </tr>
 
 <tr>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-25-1.webp" alt="Abao Color" style="max-width:100%; border-radius:8px;"> 
 Abao Color
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-26-1.webp" alt="Fill Light" style="max-width:100%; border-radius:8px;"> 
 Fill Light
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-27-1.webp" alt="Warm" style="max-width:100%; border-radius:8px;"> 
 Warm
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-28-1.webp" alt="Gorgeous" style="max-width:100%; border-radius:8px;"> 
 Gorgeous
 </td>
 </tr>
 
 <tr>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-29-1.webp" alt="Lavender" style="max-width:100%; border-radius:8px;"> 
 Lavender
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-30-1.webp" alt="Chanel" style="max-width:100%; border-radius:8px;"> 
 Chanel
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-31-1.webp" alt="Prague" style="max-width:100%; border-radius:8px;"> 
 Prague
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-32-1.webp" alt="Old Dreams" style="max-width:100%; border-radius:8px;"> 
 Old Dreams
 </td>
 </tr>
 
 <tr>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-33-1.webp" alt="Peach Blossom" style="max-width:100%; border-radius:8px;"> 
 Peach Blossom
 </td>
 <td>
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-34-1.webp" alt="Pink" style="max-width:100%; border-radius:8px;"> 
 Pink
 </td>
 <td >
 <img src="https://ai-resource.ailabtools.com/face-beauty-pro/doc/ResultImage-1-filter_type-35-1.webp" alt="Misty Rain" style="max-width:100%; border-radius:8px;"> 
 Misty Rain
 </td>
 </tr>
</table>

## Features
- **Comprehensive Enhancement Controls:** 
 Customize whitening, smoothing, face slimming, small face effect, eye enlargement, and eyebrow removal individually.
- **Filter Effects:** 
 Apply one of 35 predefined filter effects to further stylize the image.
- **High-Quality Processing:** 
 Supports portrait images with sizes up to 2 MB and resolutions between 48×48 px and 4096×4096 px.
- **Flexible Input:** 
 Accepts JPEG, JPG, and PNG formats.

## Use-Cases
- **Digital Portrait Retouching:** 
 Enhance personal or professional portraits for social media, photography, and digital media.
- **Beauty & Fashion Applications:** 
 Integrate customizable beauty filters into mobile or web applications to provide users with advanced retouching features.
- **E-Commerce & Advertising:** 
 Refine model images to produce high-quality visuals for beauty product catalogs and marketing materials.
- **Automated Image Processing:** 
 Streamline photo enhancement workflows in professional editing software or automated digital pipelines.

## API Documentation

### Endpoint
```bash
curl -X 'POST' \
 'https://prod.api.market/api/v1/ailabtools/face-beauty-pro/portrait/enhance/face-beauty-pro' \
 -H 'accept: application/json' \
 -H 'x-magicapi-key: <YOUR API MARKET KEY>' \
 -H 'Content-Type: multipart/form-data' \
 -F 'image=@20241011_201008.jpg;type=image/jpeg' \
 -F 'whitening=50' \
 -F 'smoothing=50' \
 -F 'thinface=50' \
 -F 'shrink_face=50' \
 -F 'enlarge_eye=50' \
 -F 'remove_eyebrow=50' \
 -F 'filter_type='
```

### Request

#### Image Requirements
- **Formats:** JPEG, JPG, PNG
- **Max File Size:** 2 MB
- **Resolution:** Greater than 48×48 px and less than 4096×4096 px

#### Request Body Fields

| Field | Required | Type | Range | Default | Description |
|------------------|:--------:|---------|------------|---------|------------------------------------------------------------------------------------------------------|
| `image` | Yes | file | - | - | The portrait image to be processed. |
| `whitening` | No | integer | [0, 100] | 50 | Whitening Degree. 0 means no whitening; 100 represents the highest degree. |
| `smoothing` | No | integer | [0, 100] | 50 | Smoothing Degree. 0 means no smoothing; 100 represents the highest degree. |
| `thinface` | No | integer | [0, 100] | 50 | Face Slimming Degree. 0 means no face slimming; 100 represents the highest degree. |
| `shrink_face` | No | integer | [0, 100] | 50 | Small Face Degree. 0 means no small face effect; 100 represents the highest degree. |
| `enlarge_eye` | No | integer | [0, 100] | 50 | Big Eyes Degree. 0 means no eye enlargement; 100 represents the highest degree. |
| `remove_eyebrow` | No | integer | [0, 100] | 50 | Eyebrow Removal Degree. 0 means no effect; 100 represents the highest degree. |
| `filter_type` | No | integer | [1, 35] | - | Filter Effect. Choose a value from 1 to 35 corresponding to the desired filter: |
| | | | | | 1: Black and White, 2: Calm, 3: Sunny Day, 4: Journey, 5: Beautify Skin, 6: Hong Kong Style, |
| | | | | | 7: Aesthetic, 8: Lovely, 9: New York, 10: Sakura, 11: Seventeen, 12: Soft Light, 13: Afternoon Tea, |
| | | | | | 14: Brighten Skin, 15: Chaplin, 16: Floral, 17: Memories, 18: Ice Beauty, 19: Paris, 20: Time, |
| | | | | | 21: LOMO, 22: Old Times, 23: Early Spring, 24: Story, 25: Abao Color, 26: Fill Light, 27: Warm, |
| | | | | | 28: Gorgeous, 29: Lavender, 30: Chanel, 31: Prague, 32: Old Dreams, 33: Peach Blossom, |
| | | | | | 34: Pink, 35: Misty Rain |

### Response 
```json
{
 "error_code": 0,
 "error_detail": {
 "status_code": 200,
 "code": "",
 "code_message": "",
 "message": ""
 },
 "log_id": "1744024903,378c70f7-cf60-4aa6-9e8a-666534baa4d2",
 "request_id": "1744024903,378c70f7-cf60-4aa6-9e8a-666534baa4d2",
 "result": "/9j/4AAQSkZJRgABAQAAAQABAA ...",
 "task_type": "sync"
}
```


### Status Codes & Error Handling

| Field | Description |
|--------------|-------------------------------------------------------------------------------------------------|
| `error_code` | `0` indicates success; non-zero values indicate errors such as invalid input, unsupported file format, or file size issues. |
| `error_msg` | A brief explanation of the error encountered. |
| `status_code`| Standard HTTP status codes (e.g., `200` for success, `400` for client errors), used in conjunction with `error_code` for troubleshooting. |

## SEO Keywords
Face Beauty Pro API, advanced portrait retouching, face slimming API, digital beauty enhancement, image beautification API, AI beauty filter, professional face retouching, cosmetic image processing, photo enhancement API

AI API to smooth skin, shape faces, and apply beauty filters. Free 10 calls/mo, from $10/mo. Start free on API.market.

Face Beauty Pro – AI Portrait Retouching | Free · $10/mo | API.market

BASIC

AILabTools

ULTRA

MEGA

The Face Beauty Pro API offers advanced portrait enhancement with skin smoothing, face shaping, eye enlargement, and filters for a flawless, artistic look.