Q: Are selfies required, or can makeup be applied to non-portrait images?

Makeup and beauty-related AI features are designed for portrait images with clearly detectable faces . While the image does not strictly have to be a “selfie,” it must contain a clear, front-facing human face . Images without detectable faces will fail with errors such as error_no_face or error_face_parsing .

Q: Is there a minimum face size or resolution requirement?

There is no explicitly stated minimum face size in pixels , but the documentation requires: The face must be clearly visible The image resolution must be sufficient for face detection The face angle should not be too large Images with very small faces, low resolution, or extreme angles may fail with errors like error_large_face_angle or error_no_face .

Q: Can the API handle multiple faces in one image?

For most beauty- and face-related AI features, single-face images are required . If multiple people are detected, the task may fail with error_multiple_people , unless the specific feature explicitly supports multi-face processing.

Q: Can I control makeup intensity?

The documentation does not expose a universal “intensity” parameter for makeup effects. Makeup results are generated based on predefined AI models and parameters defined by the selected action or style. Fine-grained numeric intensity control is not guaranteed unless explicitly documented for a specific endpoint.

Q: Are colors predefined or customizable?

Makeup-related features generally use predefined styles or AI-selected colors . Color customization depends on the specific makeup or style-based feature: Style-based APIs use predefined styles Arbitrary custom color input is not generally documented as supported Developers must retrieve and use available styles via the style-query APIs where applicable.

Question 1

How accurate is the color matching between digital and physical products?

Accepted Answer

With 10+ years of AI training, our API ensures that the on-screen shades remain consistent with the physical product under various ambient lightings.

Question 2

Are selfies required, or can makeup be applied to non-portrait images?

Accepted Answer

Makeup and beauty-related AI features are designed for portrait images with clearly detectable faces.
While the image does not strictly have to be a “selfie,” it must contain a clear, front-facing human face. Images without detectable faces will fail with errors such as error_no_face or error_face_parsing.

Question 3

Is there a minimum face size or resolution requirement?

Accepted Answer

There is no explicitly stated minimum face size in pixels, but the documentation requires:

The face must be clearly visible
The image resolution must be sufficient for face detection
The face angle should not be too large

Images with very small faces, low resolution, or extreme angles may fail with errors like error_large_face_angle or error_no_face.

Question 4

Can the API handle multiple faces in one image?

Accepted Answer

For most beauty- and face-related AI features, single-face images are required.
If multiple people are detected, the task may fail with error_multiple_people, unless the specific feature explicitly supports multi-face processing.

Question 5

Can I control makeup intensity?

Accepted Answer

The documentation does not expose a universal “intensity” parameter for makeup effects.
Makeup results are generated based on predefined AI models and parameters defined by the selected action or style. Fine-grained numeric intensity control is not guaranteed unless explicitly documented for a specific endpoint.

Question 6

Are colors predefined or customizable?

Accepted Answer

Makeup-related features generally use predefined styles or AI-selected colors.
Color customization depends on the specific makeup or style-based feature:

Style-based APIs use predefined styles
Arbitrary custom color input is not generally documented as supported

Developers must retrieve and use available styles via the style-query APIs where applicable.

Makeup & Look Virtual Try-On API

World’s leading Makeup & Look Virtual Try-On capability, delivering ultra-realistic AR try-on experiences across Web, Mobile, and In-store to drive improved conversions and seamless integration.

High-Performance Virtual Try-On API Engine

Advanced AR Makeup Capabilities for Every Category

Lipstick & Lip Liner

Foundation & Concealer

Eye Makeup

Blush, Contour & Highlight

Full-Look Virtual Experience

Why Choose YouCam Online Editor API from Perfect Corp.?

The Global Standard

Unrivaled Engineering

10+ Years of Expertise

How Does the Makeup Virtual Try-On API Work?

Request Initialization

Real-Time Parameter Application

Instant Result Output