Perfect Corp. AI Makeup Virtual Try-On API
docs.perfectcorp.com
What it is
Perfect Corp. AI Makeup Virtual Try-On API applies customizable makeup effects to user-provided selfie images. Its rendering uses 3D face AI and facial tracking that adapts to lighting, with matching for real-world product colors, textures, and finishes. Requests can specify makeup categories, patterns, colors, textures, and intensity. Supported product types include blush, concealer, eyeliner, eyebrows, foundation, lip color, skin smoother, bronzer, contour, eyeshadow, eyelashes or mascara, highlight, and lip liner. The REST API processes tasks asynchronously: send an image and effects, receive a task ID, then check for the result or an error. Images can come from a public URL or an uploaded file; supported files are JPG, JPEG, or PNG under 10 MB, with a long side below 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. Integration options include websites, e-commerce platforms, iOS and Android apps, applets, and mini-programs. Requests require a Bearer token API key. Perfect Corp. says uploaded photos for cloud processing are deleted from its server after the service completes.
Spec sheet
- What it does
- The API applies customizable virtual makeup effects to user provided selfie images using face analyzing technology.Read 8 Oct 2026 · docs.perfectcorp.com
- Purpose
- The API applies customizable, true-to-life makeup effects to user-provided selfie images.Read 8 Oct 2026 · docs.perfectcorp.com
- 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.Read 8 Oct 2026 · docs.perfectcorp.com
- Privacy
- Perfect Corp.'s privacy page says brand clients using Perfect AI API may receive and store generated outputs that may contain personal information.Read 8 Oct 2026 · perfectcorp.com
- Support
- The API documentation lists [email protected] for issues.Read 8 Oct 2026 · docs.perfectcorp.com
- Founded
- 2015Read 28 Sep 2026 · docs.perfectcorp.com
- API playground
- The API documentation links to an official playground for interactively exploring and testing the Makeup Virtual Try-On API.Read 8 Oct 2026 · docs.perfectcorp.com
- 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.Read 8 Oct 2026 · perfectcorp.com
- Authentication
- Requests require an API key sent in the Authorization header as a Bearer token.Read 8 Oct 2026 · docs.perfectcorp.com
- Customization
- Requests can specify makeup effects and palettes, including colors, patterns, intensity, and supported textures such as matte, shimmer, and metallic.Read 8 Oct 2026 · docs.perfectcorp.com
- Developer integrations
- Perfect Corp. says its YouCam APIs can integrate with websites, e-commerce platforms, iOS and Android apps, applets, and mini-programs.Read 8 Oct 2026 · docs.perfectcorp.com
- Errors and units
- The documentation says failed query or engine tasks do not consume units.Read 8 Oct 2026 · docs.perfectcorp.com
- Free access
- Perfect Corp. says developers can register a YouCam API account for free and then purchase or subscribe to obtain units.Read 8 Oct 2026 · docs.perfectcorp.com
- 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.Read 8 Oct 2026 · docs.perfectcorp.com
- 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.Read 8 Oct 2026 · docs.perfectcorp.com
- Integration
- The API uses an asynchronous REST workflow: submit an image and effects, receive a task ID, then poll for status and results.Read 8 Oct 2026 · docs.perfectcorp.com
- 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.Read 8 Oct 2026 · app-cdn-01.perfectcorp.com
- Makeup customization
- Requests can specify makeup effect categories, patterns, colors, textures, and color intensity.Read 8 Oct 2026 · docs.perfectcorp.com
- 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.Read 8 Oct 2026 · perfectcorp.com
- Rendering
- The documentation describes 3D face AI rendering, facial tracking that adapts to lighting, and matching for real-world product colors, textures, and finishes.Read 8 Oct 2026 · docs.perfectcorp.com
- 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.Read 8 Oct 2026 · perfectcorp.com
- 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.Read 8 Oct 2026 · docs.perfectcorp.com
- Usage unit
- AI Makeup Virtual Try-On V1.0 consumes one unit per task.Read 8 Oct 2026 · docs.perfectcorp.com
- Workflow
- The API runs makeup processing asynchronously: submit an image and effects, receive a task ID, then poll for the result or an error.Read 8 Oct 2026 · docs.perfectcorp.com
Strong points and limits
Strong points
- Customizes makeup colors, textures, patterns, and intensity
- Supports a broad range of makeup categories
- REST workflow returns a task ID for status checks
- Free account registration is available
- Uploaded photos are deleted after processing, per policy
Limits
- Each V1.0 task consumes one unit
- Pricing is available on request
- Images must meet file and face-width limits
- API key security is the user's responsibility
Who it suits
The API suits beauty and fashion brands, retailers, and developers adding photo based makeup try-on to digital experiences. It requires API integration and images that meet the stated format, size, and face-width limits.
Verdict
The API combines detailed makeup customization with asynchronous processing and several integration options. Buyers should account for per-task units, image requirements, and API key handling when planning an implementation.
Where Specifiction places it
- Virtual Try-On Software#15 of 268.1