Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Perfect Corp. AI Makeup Virtual Try-On API

docs.perfectcorp.com

  • Free trial
  • Web
  • iPhone and iPad
  • Android
  • API

What Perfect Corp. AI Makeup Virtual Try-On API is

Perfect Corp. AI Makeup Virtual Try-On API applies customizable makeup effects to user-provided selfie images. Its face analysis and 3D rendering are designed to track facial features as lighting changes and match real-world product colors, textures, and finishes. Requests can select makeup categories, patterns, colors, textures, and intensity, including matte, shimmer, and metallic finishes. Supported products include blush, concealer, eyeliner, eyebrows, foundation, lip color, skin smoother, bronzer, contour, eyeshadow, eyelashes or mascara, highlight, and lip liner. The REST API works asynchronously: submit an image and effects, receive a task ID, then check for status and results. Images can be supplied by public URL or uploaded file. Supported files are JPG, JPEG, or PNG under 10 MB, with a long side under 1,920 pixels and a detected face width of at least 100 pixels. Each V1.0 task uses one unit. Developers can register for a YouCam API account for free, then purchase or subscribe for units; pricing is on request.

Who it suits

The API suits beauty and fashion brands, retailers, and developers building applications with virtual makeup try-on. It supports integration into websites, e-commerce platforms, iOS and Android apps, applets, and mini-programs.

Good to know, and what to watch

  • Customizes makeup categories, colors, patterns, and intensity
  • Supports multiple makeup textures and finishes
  • Offers photo upload or publicly accessible image URLs
  • Integrates with websites and mobile apps
  • Failed query or engine tasks do not consume units
  • Each V1.0 task consumes one unit
  • Supported images must meet size and face-width limits
  • Pricing is on request

Getting started

  1. Open the Makeup Virtual Try-On API documentation
  2. Register a YouCam API account
  3. Obtain API units through purchase or subscription
  4. Authenticate requests with a Bearer API key
  5. Submit a JPG, JPEG, PNG, URL, or uploaded image with makeup effects
  6. Poll the returned task ID for the result or error

Limits to check

Each V1.0 task consumes one unit. Images must be under 10 MB, have a long side below 1,920 pixels, and show a detected face at least 100 pixels wide.

The verdict

This API provides a configurable makeup try-on workflow for photos, with a broad set of makeup categories and integration options. Confirm the image requirements and unit-based access against your intended use.

Questions people ask

How much does it cost?

The service is paid, with pricing available on request. Developers can register a YouCam API account for free, then purchase or subscribe to obtain units.

Is there a free trial?

Yes. A free YouCam API account is available for registration.

Which platforms can use it?

The API is listed for Android, iOS, web, and API use. Perfect Corp. also describes integrations with e-commerce platforms, applets, and mini-programs.

What image formats are accepted?

Public image URLs and uploaded JPG, JPEG, or PNG files are accepted. Files must be under 10 MB, below 1,920 pixels on the long side, with a detected face at least 100 pixels wide.

How are requests processed?

Submit an image and effects, receive a task ID, then poll for the result or an error.

What makeup can it apply?

Supported types include blush, concealer, eyeliner, eyebrows, foundation, lip color, skin smoother, bronzer, contour, eyeshadow, eyelashes or mascara, highlight, and lip liner.

What the maker publishes

API playground
The API documentation links to an official playground for interactively exploring and testing the Makeup Virtual Try-On API. source
API terms
Perfect Corp.'s terms say API users are responsible for maintaining the security of their API keys and consent to the collection and use of biometric information as described in its privacy policy. source
Authentication
Requests require an API key sent in the Authorization header as a Bearer token. source
Customization
Requests can specify makeup effects and palettes, including colors, patterns, intensity, and supported textures such as matte, shimmer, and metallic. source
Developer integrations
Perfect Corp. says its YouCam APIs can integrate with websites, e-commerce platforms, iOS and Android apps, applets, and mini-programs. source
Errors and units
The documentation says failed query or engine tasks do not consume units. source
Founded
2015 source
Free access
Perfect Corp. says developers can register a YouCam API account for free and then purchase or subscribe to obtain units. source
Image input
The API accepts a publicly accessible image URL or an uploaded image file; files obtained through the File API must be uploaded to the returned URL before use. source
Image limits
Supported files are JPG, JPEG, or PNG under 10 MB, with a long side under 1,920 pixels and a detected face width of at least 100 pixels. source
Integration
The API uses an asynchronous REST workflow: submit an image and effects, receive a task ID, then poll for status and results. source
Integration options
Perfect Corp. describes its AI APIs as RESTful and says they can be integrated into websites, e-commerce platforms, iOS and Android apps, applets, and mini-programs. source
Intended users
Perfect Corp. describes its business solutions as serving beauty and fashion brands and retailers; the API documentation says applications can use the makeup service. source
Intended users
The documentation describes the API as a way for applications to add virtual makeup effects, and the wider YouCam API platform as integrable into business websites, commerce platforms, and apps. source
Makeup customization
Requests can specify makeup effect categories, patterns, colors, textures, and color intensity. source
Photo handling
Perfect Corp.'s privacy policy says photos uploaded for cloud virtual try-on and AI processing are permanently deleted from its server after the service is completed. source
Privacy
Perfect Corp.'s privacy page says brand clients using Perfect AI API may receive and store generated outputs that may contain personal information. source
Purpose
The API applies customizable, true-to-life makeup effects to user-provided selfie images. source
Rendering
The documentation describes 3D face AI rendering, facial tracking that adapts to lighting, and matching for real-world product colors, textures, and finishes. source
Security and compliance
Perfect Corp.'s compliance page describes a GDPR commitment and identifies ISO/IEC 27001:2022 compliance; its HIPAA statement refers to its AI Skin Analyzer solution. source
Skin smoothing default
If a request omits the skin_smooth effect, the engine applies a default skin-smoothing value of 50; the documented parameters can be set to zero to disable it. source
Support
The API documentation lists [email protected] for issues. source
Usage unit
AI Makeup Virtual Try-On V1.0 consumes one unit per task. source
What it does
The API applies customizable virtual makeup effects to user provided selfie images using face analyzing technology. source

Checked against the maker's pages on 8 Oct 2026.