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
- Open the Makeup Virtual Try-On API documentation
- Register a YouCam API account
- Obtain API units through purchase or subscription
- Authenticate requests with a Bearer API key
- Submit a JPG, JPEG, PNG, URL, or uploaded image with makeup effects
- 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.