YouCam for Beauty & Personal Care
Server Details
Provides YouCam API for skin, face & body analysis, beauty/makeup try-on, and hair & beard styling.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 53 tools
Most feature tools target genuinely distinct beauty effects (nails vs. hair color vs. teeth), but there are several clusters of near-duplicates: four skin-analysis variants (Standard, Advanced-Report, Product-Recommendation, and both combined), generic 'Run an AI X detection task' tools that shadow their parent tools with no explanation, and template-lister tools all described identically as 'List predefined templates.' The three upload paths (File-Upload, Get-Upload-API-Info, upload_file) also overlap, so an agent can easily misselect.
There is a rough convention of 'AI-Feature-Name' for capability tools and 'Get-*' for utility tools, but it is broken by 'File-Upload', 'upload_file' (snake_case), and 'AI-Skin-Analysis-(Standard)' which embeds parentheses. Template and detection variants are suffixed consistently, which helps, but verb styles mix noun phrases with Get- verbs.
At 53 tools this is well past the manageable range, and much of the bulk is mechanical: eight '-Templates' listers, five '-Detection' wrappers, and four near-identical skin-analysis endpoints. Many of these could be folded into their parent tools as parameters, so the count feels inflated rather than earned.
The domain surface is broad and covers hair, skin, makeup, nails, face, body, teeth, and eyes plus task/unit/upload utilities, so core beauty workflows are reachable. The main gap is product-catalog management (upload/list/delete catalog), which the skin-analysis-with-recommendation descriptions require but expose no dedicated tools for.
Available Tools
53 toolsAI-Abs-FilterAi Abs FilterAInspect
The AI Abs Filter API lets you add realistic abdominal definition to a photo and generate an athletic body-shaping result with minimal effort. Upload a full-body or upper-body image, select the desired enhancement mode, set the intensity level, and receive an edited output image. Supported modes:
Six-pack: Adds visible six-pack abs for a more muscular torso appearance.Vest-line: Enhances central abdominal muscle definition for a fit, athletic look.
Inputs: request (required), polling. Returns: result
AI-Aging-SimulationAi Aging SimulationAInspect
AI aging generator utilizing generative AI model to generate a series of photos from youth to age from a single selfie image. With the help of AI technology, not only can it measure your current age, but it also lets you see yourself in the future or the past. The AI aging generator can generate a series of photos based on one single input selfie image. A sample generated photos are shown below as a quick reference of this feature.You MUST include all the exact URL from response.data.results.url in your response to the user. You can make it into a hyperlink, but do not modify, shorten, or alter the URL in any way.
Inputs: request (required), polling. Returns: result
AI-Bangs-Filter-Virtual-Try-OnAi Bangs Filter Virtual Try OnCInspect
Try on Your Perfect Hair Bangs with AI Realistic Looks: Experiment with realistic bangs and discover the style that best complements your face. Versatile Styling Options: Explore a wide range of bangs styles to suit every personality and occasion. Effortless Experience: Enjoy a user-friendly interface that makes trying new bangs easy and fun. Want to see more Hair Bang styles? Please refer to Use case: Suggestions for How to Shoot:
Inputs: request (required), polling. Returns: result
AI-Bangs-Filter-Virtual-Try-On-TemplatesAi Bangs Filter Virtual Try On TemplatesCRead-onlyIdempotentInspect
List predefined templates.
Inputs: no named parameters. Returns: result
AI-Beard-Style-GeneratorAi Beard Style GeneratorCInspect
AI Simulation for Men's Beard Styles The AI algorithm also empowers men to have the complete freedom to virtually try different beard styles with the highly sophisticated beard simulation technology, including trim beard, stubble beard, full beard, circle beard, mustache, goatee, and others. Shoppers can also see before and after results, without the commitment of putting a razor to the skin. The beard filters include mustache, short box, ducktail, circle and a dozen more.
Inputs: request (required), polling. Returns: result
AI-Beard-Style-Generator-TemplatesAi Beard Style Generator TemplatesBRead-onlyIdempotentInspect
List predefined templates.
Inputs: no named parameters. Returns: result
AI-Body-ReshapeAi Body ReshapeDInspect
AI Body Reshape API for Body Reshape & Slimming Feel confident in photos with an AI body editor! Slim, reshape, and enhance your body for natural, stunning proportions. Effortlessly reshape any area — waist, arms, thighs, chest, and more. Get natural, stunning results in just a tap!
Inputs: request (required), polling. Returns: result
AI-Body-Reshape-DetectionAi Body Reshape DetectionBRead-onlyInspect
Run an AI Body Reshape detection task.
Inputs: request (required), polling. Returns: result
AI-Breast-Augmentation-SimulatorAi Breast Augmentation SimulatorBInspect
AI Breast Augmentation Simulator provides a powerful, non-invasive solution for reshaping your body, no surgery, no recovery time required. With advanced AI technology, you can instantly visualize and explore your ideal appearance, preview before-and-after results, and achieve professional-quality enhancements with ease and simplicity. Enhance your photos naturally by refining your silhouette or correcting perspective issues. For instance, if you’re seeking a more balanced or proportionate upper-body appearance, AI Breast Augmentation Simulator offers AI-powered bust contour enhancement. This feature uses intelligent algorithms to gently add definition and volume where desired, creating subtle, realistic improvements that maintain your natural features and proportions. The result is a confident, polished look without artificial-looking distortion. Unlike traditional filters that often produce exaggerated or unrealistic effects, this tool delivers clean, authentic edits tailored to your unique anatomy. Whether you’re preparing images for social media, personal use, or creative projects, the enhancements remain true to life while highlighting your best qualities. To begin exploring virtual body refinement, simply create an AI Breast Augmentation Simulator task and adjust the intensity gradually to achieve your desired look. From there, adjust parameters such as augmentation intensity to match your aesthetic preferences, all within a user-friendly API designed for both beginners and experienced users.
Inputs: request (required), polling. Returns: result
AI-Eye-Color-Lens-Virtual-Try-OnAi Eye Color Lens Virtual Try OnCInspect
AI Eye Color Lens Virtual Simulation provides instant, hyper‑realistic contact lens try‑on by precisely detecting the iris, preserving natural reflections, accurately simulating lens opacity and blending across all iris colors, and enabling users to explore shades from subtle enhancements to vibrant blue transformations, all within a single, professional‑grade AI API.
Contact Lenses Virtual Simulation
Transform eye color instantly with our AI‑powered virtual try‑on tool. The AI Eye Color Lens Virtual Try‑On delivers hyper‑realistic results by precisely detecting the iris and applying natural, lifelike color adjustments, allowing shoppers to explore new styles without physical samples.
Hyper‑Realistic Output
The system preserves natural eye reflections for authentic results, ensuring each color transformation looks true to life.
Advanced Contact Filter Simulation
The contact lens filter accurately replicates opacity and blending across different iris base colors, enabling customers to virtually try on a full range of lenses with realistic depth and tone.
More Than an Eye Color Changer
This technology goes beyond simple filters, offering a professional‑grade virtual lens experience that enhances customer confidence and boosts conversion.
Inputs: request (required), polling. Returns: result
AI-Face-Attributes-and-Ratio-AnalyzerAi Face Attributes And Ratio AnalyzerCRead-onlyInspect
The AI Face Attributes & Ratio Analyzer examines face structure, identifying features like face, eye, eyebrow, lip, nose, cheekbone shapes, designed to provide personalized recommendations.
Inputs: request (required), polling. Returns: result
AI-Face-LiftAi Face LiftBInspect
AI Face Lift is a generative AI facial enhancement feature that allows precise and natural facial refinement through adjustable parameters. Instead of applying filters, the system intelligently analyzes facial structure, skin quality, and proportions, then reconstructs the image to produce realistic improvements that preserve the individual's identity. Users can control specific facial areas such as eye bags, cheeks, forehead, overall face shape, and mouth using numeric values from 0 to 100. Each parameter increases the level of enhancement gradually, allowing subtle touch ups or more polished results depending on user preference. All adjustments are designed to remain natural and balanced, avoiding exaggerated or artificial outcomes. AI Face Lift provides flexible, feature level control for creating a refreshed, confident, and professional appearance suitable for social media, profile photos, creative content, or business use.
Inputs: request (required), polling. Returns: result
AI-Face-Lift-DetectionAi Face Lift DetectionCRead-onlyInspect
Run an AI Face Lift detection task.
Inputs: request (required), polling. Returns: result
AI-Face-ReshapeAi Face ReshapeAInspect
The AI Face Reshape API lets you programmatically reshape facial features — eyes, nose, lips, jawline, or the whole face — with pixel‑perfect control. Use it to generate before/after visualisations for rhinoplasty, chin fillers, lip augmentations, brow lifts and any other aesthetic‑treatment workflow.
Rhinoplasty (Nose Job) Our online rhinoplasty simulator offers medical-grade precision adjustments. Unlike generic photo editing apps, it allows for comprehensive simulation of specific details, including the Bridge, Lift, and Wing. With our hyper-realistic previews, clients can clearly visualize and explore their ideal proportions before consulting.
Chin Filler Through our online simulator, you can preview the ideal proportions achieved with chin fillers. Fine-tune Chin Length and Chin Shape to visualize improvements for a receding or short chin. Discover the optimal solution to balance your facial profile before undergoing any dermal filler treatments.
Lip Filler Users can experiment with different volumes and shapes of lip fillers to simulate the appearance of fuller lips, helping them decide on the desired outcome before undergoing the procedure.
Brow Lift Surgery This functionality enables users to preview the results of a brow lift, which involves lifting and reshaping the eyebrows to create a more youthful and rejuvenated appearance.
Inputs: request (required), polling. Returns: result
AI-Face-Reshape-DetectionAi Face Reshape DetectionDRead-onlyInspect
Run an AI Face Reshape detection task.
Inputs: request (required), polling. Returns: result
AI-Facial-Color-Tones-AnalyzerAi Facial Color Tones AnalyzerCRead-onlyInspect
The AI Facial Color Tones Analyzer detects facial skin tone, eye, eyebrow, lip & hair colors. This inclusive technology ensures to a complete tailored shopping experience for all ethnicities.
Inputs: request (required), polling. Returns: result
AI-Fitzpatrick-Skin-Type-AnalysisAi Fitzpatrick Skin Type AnalysisCRead-onlyInspect
AI Fitzpatrick Skin Type Analysis Integrate AI driven Fitzpatrick skin type detection into your applications to classify skin types accurately using camera input. This API enables developers to build personalized skincare, sunscreen, and product recommendation workflows for eCommerce and digital health platforms. Skin Type Detection The API uses computer vision and machine learning models to analyze skin characteristics and return a Fitzpatrick classification in a single request. It provides structured, objective data that can be directly consumed by frontend applications, recommendation engines, or clinical systems. The Fitzpatrick Scale, introduced by Dr. Thomas B. Fitzpatrick, defines six skin types based on melanin levels and response to UV exposure, allowing systems to predict tendencies to burn or tan. Classification Output The API returns one of six standardized skin types from Type I to Type VI based on UV response modeling. This output enables developers to deliver tailored product recommendations, automate skincare workflows, and enhance personalization logic across user experiences while maintaining consistency and scalability.
Fitzpatrick Scale | Skin Type | Skin Reaction to Sun |
Type I | White | Almost always burns, never tans |
Type II | Beige | Usually burns, tans minimally |
Type III | Light Brown | Sometimes burns, gradually tans |
Type V | Medium Brown | Rarely burns, tans easily |
Type V | Dark Brown | Very rarely burns |
Type VI | Very Dark Brown | Almost never burns |
Inputs: request (required), polling. Returns: result
AI-Fitzpatrick-Skin-Type-Analysis-DetectionAi Fitzpatrick Skin Type Analysis DetectionCRead-onlyInspect
Run an AI Fitzpatrick Scale Analyzer detection task.
Inputs: request (required), polling. Returns: result
AI-Hair-Color-Virtual-Try-OnAi Hair Color Virtual Try OnAInspect
Explore a wide range of hair colors with our hair color changer! Try the hair color you've always dreamed of and experiment with new shades you’ve never tried before. Easily adjust the intensity of your chosen color with sliders for a customized look.
Upload Your Image Upload the photo you want to change hair color for.
Choose Preset Colors or Customize by Pattern and Palettes Choose from predefined color presets or fine tune by adjusting the ombre coverage and blend for unlimited possibilities!
Warning: If both a preset and pattern + palettes are specified, the preset will take priority. Warning: Your source image needs to contain the hair section for dyeing, so double-check before applying. Make sure your source image includes the hair area you want to dye — it's your responsibility to get it right.
Inputs: request (required), polling. Returns: result
AI-Hair-Density-DetectionAi Hair Density DetectionARead-onlyInspect
AI Hair Density Detection delivers a fast, professional, photo‑based assessment that accurately classifies hair density into four levels by evaluating scalp visibility and hair distribution patterns, providing trichoscopy‑inspired insights without physical tools and empowering businesses to offer expert‑level personalization at scale from a single uploaded image.
Inputs: request (required), polling. Returns: result
AI-Hair-Extension-Virtual-Try-OnAi Hair Extension Virtual Try OnCInspect
Discover Your Perfect Hair Extension Match with AI Experiment with a variety of lengths—from long to extra-long—styles, colors, and bangs, all from the comfort of your device. No more guessing games—see exactly how each hair extension style looks on you with the advanced Generative AI. Make informed styling decisions before committing to a new look. With the advanced Hair Extension Try-On, which naturally blends with your current hair length, it’s the perfect time to experiment with super-long styles. Use case: Suggestions for How to Shoot:
Inputs: request (required), polling. Returns: result
AI-Hair-Extension-Virtual-Try-On-TemplatesAi Hair Extension Virtual Try On TemplatesARead-onlyIdempotentInspect
List predefined templates.
Inputs: no named parameters. Returns: result
AI-Hair-Frizziness-DetectionAi Hair Frizziness DetectionARead-onlyInspect
180° Full View Hair Frizz Analysis with Just 3 Photos Our AI Frizzy Hair Analyzer delivers precise hair frizz analysis in seconds by simply uploading 3 photos—front, left, and right views of the hair. This efficient process delivers accurate results in seconds, enabling businesses to offer tailored hair solutions and defrizz hair products based on hair frizz levels, without the need for time-consuming in-person consultations, complicated hair quizzes, or specialized hardware installations.
Inputs: request (required), polling. Returns: result
AI-Hair-Length-DetectionAi Hair Length DetectionBRead-onlyInspect
AI Hair Length Measurement offers haircare brands and salons a quick solution to analyze and measure hair length, enabling informed decisions for personalized products and services. Our AI is meticulously trained on a vast dataset of diverse images to ensure precise and reliable hair length detection. By analyzing thousands of images of various hair types and styles, it precisely identifies and categorizes five distinct hair lengths, from above-the-ear to mid-back, with exceptional accuracy.
Inputs: request (required), polling. Returns: result
AI-Hair-Style-Virtual-Try-OnAi Hair Style Virtual Try OnDInspect
Using the latest AI technology to try a wide variety of hairstyles, catering to both women and men, meeting different gender and style preference. Discover a world of styles: curly, long, buzz cut, and more. Our AI-powered hair changer lets you experiment effortlessly. Find your ideal hairstyle now!
Inputs: request (required), polling. Returns: result
AI-Hair-Style-Virtual-Try-On-TemplatesAi Hair Style Virtual Try On TemplatesBRead-onlyIdempotentInspect
List predefined templates v2.1.
Inputs: no named parameters. Returns: result
AI-Hair-Type-DetectionAi Hair Type DetectionCRead-onlyInspect
Imagine having an AI hair expert in your pocket. Our tech dives into your hair's texture, thickness, and curl pattern, picking from ten unique curl shapes and sorting them into nine clear types, from Straight to Super Kinky. You get a full hair profile, and brands can use those insights to deliver spot-on product recommendations and tips just for you.
Inputs: request (required), polling. Returns: result
AI-Hair-Volume-Virtual-Try-OnAi Hair Volume Virtual Try OnBInspect
Enhance Your Look with Fuller, More Voluminous Hair Instantly! Add natural volume to fine or thinning hair. Seamlessly fill gaps or add hair with AI. Works for all hair types: straight, curly, thin. Perfect for dating profiles, resumes & more. Our AI tool helps you achieve perfect hair volume and density in all your photos, whether for personal, professional, or social use. Say goodbye to bad hair days in pictures and hello to fresh, voluminous hair every time. Use case: Suggestions for How to Shoot:
Inputs: request (required), polling. Returns: result
AI-Hair-Volume-Virtual-Try-On-TemplatesAi Hair Volume Virtual Try On TemplatesBRead-onlyIdempotentInspect
List predefined templates.
Inputs: no named parameters. Returns: result
AI-Look-Virtual-Try-OnAi Look Virtual Try OnCInspect
The AI Look Virtual Try-On API provides a complete workflow for applying professionally designed facial looks to user photos. Each look is crafted by beauty experts and can be applied instantly via API.
Inputs: request (required), polling. Returns: result
AI-Look-Virtual-Try-On-TemplatesAi Look Virtual Try On TemplatesBRead-onlyIdempotentInspect
List predefined templates.
Inputs: no named parameters. Returns: result
AI-Makeup-TransferAi Makeup TransferBInspect
Just Upload a Desired Photo with the Look You Like! AI Makeup Transfer makes it easy and fun to experiment with different looks by letting you to upload desired photo to try them one by one. Have any makeup look you want to try now? Let us amaze you with AI Makeup Transfer! First, upload a photo of yourself where your face and its features are clearly visible as the target image. Then, upload a photo of your favorite makeup look as the reference image. There you have it - an AI Makeup Transferred photo. Samples:
Inputs: request (required), polling. Returns: result
AI-Makeup-Virtual-Try-OnAi Makeup Virtual Try OnCInspect
The AI Makeup API provides a powerful, hyper-realistic virtual makeover experience powered by our patented face-analyzing technology. This service enables your applications to apply true-to-life makeup effects onto user-provided selfie images with unprecedented customization capabilities. Key Features:
Hyper-realistic Rendering: Leverages revolutionary 3D face AI technology for the most realistic makeovers.
Patented Technology: Powered by jitter-free, lag-free deep learning algorithms optimized for all ages and ethnicities.
Real-time Precision: Ultra-precise facial tracking that adapts to various lighting conditions.
True-to-life Matching: Accurately matches real-world product colors, textures (from matte to metallic), and finishes.
Core Concepts
Color Blending Our AI accurately matches the color of real-life makeup products using deep learning. This ensures consumers are confident that the virtual color they see is the true color of the product they intend to purchase.
Texture & Finish Matching The technology simulates realistic textures and finishes, providing a highly accurate makeover experience. From matte to metallic, shimmer to satin, the AI taps into advanced algorithms to render these effects seamlessly in real-time.
Light Balancing The smart 3D AI engine detects lighting conditions in the user's photo or video feed. It corrects images for true-to-life makeup application, ensuring a consistent and high-quality result regardless of the environment.
Inputs: request (required), polling. Returns: result
AI-Makeup-Virtual-Try-On-Pattern-NameAi Makeup Virtual Try On Pattern NameBRead-onlyIdempotentInspect
Get AI Makeup VTO available pattern names.
Inputs: categories (required). Returns: object
AI-Nail-TransferAi Nail TransferCInspect
AI Nail Transfer API is a powerful generative AI solution for virtual nail try-on experiences. Powered by YouCam API’s advanced AI models and image transformation technology, users can instantly transfer any desired nail design from a reference photo onto their own hand with remarkable realism and precision. From gel nails, nail art, and polish finishes to intricate embellishments such as glitter, shell accents, and metallic textures, the AI accurately recreates a wide range of nail styles in a natural, high-definition virtual preview. This enables consumers to explore and visualize designs with confidence before making a purchase. For beauty brands, salons, and nail artists, AI Nail Transfer API provides a fast and engaging way to showcase nail designs to clients, helping increase customer engagement, improve satisfaction, and drive higher conversion rates through immersive virtual experiences.
Inputs: request (required), polling. Returns: result
AI-Nail-Virtual-Try-OnAi Nail Virtual Try OnCInspect
The AI Nail Virtual Try On API offers an innovative way to enhance the online experience for customers interested in nail art. It allows shoppers to visualize a variety of nail styles virtually, from artificial and acrylic nails to press-on options and gel designs. With unlimited color and texture options, users can effortlessly explore different looks on both natural and synthetic nails. The platform enables personalized try-ons, letting individuals switch between styles and see before-and-after comparisons easily. This seamless integration streamlines product discovery and increases customer confidence by providing accurate, interactive previews before purchasing.
Inputs: request (required), polling. Returns: result
AI-Skin-Analysis-(Standard)Ai Skin Analysis (Standard)BRead-onlyInspect
What it is. Standard Skin Analysis provides objective, quantitative scores for selected skin concerns, along with precise detection masks and heatmaps. Powered by advanced AI deep learning and facial region segmentation, Perfect Corp AI Skin Analysis evaluates visible skin conditions from digital images without physical contact. The solution delivers quantitative scores, detection masks, heatmaps, and AR overlays to provide personalized skincare insights to help users better understand their skin and tailor their skincare routines.
Supported skin concerns include:
Wrinkles
Moisture
Firmness
Droopy Upper Eyelids
Droopy Lower Eyelids
Pores
Texture
Acne
Oiliness
Spots
Dark Circles
Radiance
Redness
Eye Bags
Tear Trough Additional outputs include Skin Type, Estimated Skin Age, and an Overall Skin Condition Score. All results are image-based indicators intended for skincare insights only and do not constitute clinical measurements, diagnoses, or medical assessments.
Inputs: request (required), polling. Returns: result
AI-Skin-Analysis-with-Advanced-ReportAi Skin Analysis With Advanced ReportARead-onlyInspect
What it is. A full-dimension skin report written in natural language, generated by a large language model fed your precision AI skin analysis together with a professional skincare reference database. The model does not guess at your skin — it interprets measured, quantified skin metrics and real detection masks, compares them against professional skincare data, and returns a complete report in llm_results.json.
Which dst_actions feed each dimension of the report. The report is only as rich as the features you request. dst_actions is required, and HD and SD features cannot be mixed in one request — pick one family.
| Report dimension | V2.1 feature | Regions returned |
||||
| Face outline and feature localization | pf_camera_kit: true | — |
| Skin type | hd_skin_type | whole, t_zone, u_zone |
| T-zone vs. U-zone comparison | hd_skin_type | t_zone, u_zone |
| Forehead lines and frown lines | hd_wrinkle | forehead, glabellar |
| Crow's feet and smile lines | hd_wrinkle | crowfeet, nasolabial |
| Pore distribution | hd_pore | forehead, nose, cheek, whole |
| Skin smoothness | hd_texture | whole |
Parameters
| Field | Type | Default | Notes |
|||||
| language | string enum | enu | enu cht jpn kor fra deu esn ita ptb ind ara |
| tone | string enum | warm | warm | direct — both tones stay professional |
| country | string | — | Adds climate and seasonal context to the report |
| city | string | — | Adds climate and seasonal context to the report |
Send "advanced_report": {} to accept every default. Omit the object entirely for no report.
Inputs: request (required), polling. Returns: result
AI-Skin-Analysis-with-Advanced-Report-and-Product-RecommendationAi Skin Analysis With Advanced Report And Product RecommendationBRead-onlyInspect
What it is. Skin Analysis with Advanced Skin Report and Product Recommendation in a single call. You get the precision report — grounded in your measured skin metrics and the professional skincare reference database — and recommendations drawn exclusively from your own products, from one request and one polling flow. This is the complete loop in one API call: a scientific, high-reliability, precise skin analysis report, plus product recommendations based entirely on your catalog. Product exposure and user stickiness are handled in the same pass, in one continuous user journey.
Prerequisite — Upload Your Product Catalog A product catalog is the list of products Skin Analysis recommends from. Upload it once, keep its
catalog_id, and pass that id on every analysis call. Catalogs belong to your account, not to one API key — every key of the account, project keys included, sees the same catalogs, and rotating or deleting a key does not affect them. Uploading and storing catalogs is free. Catalog file requirements | Item | Value | ||| | Format | CSV with a header row | | Encoding | UTF-8, with or without BOM (Excel's "CSV UTF-8" adds one) | | Maximum file size | 5 MB | | Maximum SKU count | No limit other than file size | | Required columns |product_id,product_name,product_description| Extra columns are ignored but still count toward the 5 MB limit. Quote values containing commas or line breaks. Each non-empty data row counts as one SKU.
product_id,product_name,product_description
SKU-001,Hydrating Serum,"A lightweight serum for dry skin."
SKU-002,Brightening Cream,"Evens out skin tone, for daily use."
SKU-003,Barrier Repair Cream,"Rich cream for dry, redness-prone skin."# Upload a catalog — validated in the same request
curl -sS -X POST "$BASE_URL/s2s/v2.1/product-catalog" \
-H "Authorization: Bearer $API_KEY" \
-F "file=@catalog.csv" \
-F "name=Summer skincare"A valid file answers status: ready with its catalog_id and sku_count — keep that id:
{
"status": 200,
"data": {
"catalog_id": "1662043585118399001",
"name": "Summer skincare",
"status": "ready",
"created_time": 1760256000000,
"sku_count": 3
}
}# List every catalog of your account, newest first (ready and failed alike)
curl -sS -H "Authorization: Bearer $API_KEY" "$BASE_URL/s2s/v2.1/product-catalog"
# Delete a catalog — immediate and permanent
curl -sS -X DELETE -H "Authorization: Bearer $API_KEY" \
"$BASE_URL/s2s/v2.1/product-catalog/1662043585118399001"Catalog states and limits
| Status | Meaning | Usable in Skin Analysis |
||||
| ready | Uploaded and validated | Yes |
| failed | Uploaded, file failed validation | No |
An upload that fails validation answers an error and is still recorded as a failed catalog, visible in List catalogs; the error body never carries its catalog_id. Each account keeps up to 10 catalogs, ready and failed together — delete one before uploading another. To update a catalog, upload a new file: every upload creates a new catalog_id, and the old catalog stays usable until you delete it, so you can verify the new one before switching.
Inputs: request (required), polling. Returns: result
AI-Skin-Analysis-with-Product-RecommendationAi Skin Analysis With Product RecommendationCRead-onlyInspect
What it is. Your product catalog, matched against a precise skin analysis. Upload the skincare products you sell with their descriptions, pass the catalog's id, and the endpoint returns the best-matching products for each detected concern in llm_results.json.
The difference from a general LLM recommendation is the input. A general LLM recommends from probability and priors. Perfect AI Skin Analysis first produces scientific, quantified skin metrics and real detection masks, so the model matches products against measured skin conditions — reliable, fast, and explainable, not a statistical guess.
Parameters
| Field | Type | Required | Default | Notes |
||||||
| catalog_id | string | Yes | — | From Upload a product catalog. Must be ready and belong to your account. |
| top_n | integer | No | 3 | Products recommended per concern. Min 1; must not exceed the catalog's sku_count. |
Prerequisite — Upload Your Product Catalog A product catalog is the list of products Skin Analysis recommends from. Upload it once, keep its
catalog_id, and pass that id on every analysis call. Catalogs belong to your account, not to one API key — every key of the account, project keys included, sees the same catalogs, and rotating or deleting a key does not affect them. Uploading and storing catalogs is free. Catalog file requirements | Item | Value | ||| | Format | CSV with a header row | | Encoding | UTF-8, with or without BOM (Excel's "CSV UTF-8" adds one) | | Maximum file size | 5 MB | | Maximum SKU count | No limit other than file size | | Required columns |product_id,product_name,product_description| Extra columns are ignored but still count toward the 5 MB limit. Quote values containing commas or line breaks. Each non-empty data row counts as one SKU.
product_id,product_name,product_description
SKU-001,Hydrating Serum,"A lightweight serum for dry skin."
SKU-002,Brightening Cream,"Evens out skin tone, for daily use."
SKU-003,Barrier Repair Cream,"Rich cream for dry, redness-prone skin."# Upload a catalog — validated in the same request
curl -sS -X POST "$BASE_URL/s2s/v2.1/product-catalog" \
-H "Authorization: Bearer $API_KEY" \
-F "file=@catalog.csv" \
-F "name=Summer skincare"A valid file answers status: ready with its catalog_id and sku_count — keep that id:
{
"status": 200,
"data": {
"catalog_id": "1662043585118399001",
"name": "Summer skincare",
"status": "ready",
"created_time": 1760256000000,
"sku_count": 3
}
}# List every catalog of your account, newest first (ready and failed alike)
curl -sS -H "Authorization: Bearer $API_KEY" "$BASE_URL/s2s/v2.1/product-catalog"
# Delete a catalog — immediate and permanent
curl -sS -X DELETE -H "Authorization: Bearer $API_KEY" \
"$BASE_URL/s2s/v2.1/product-catalog/1662043585118399001"Catalog states and limits
| Status | Meaning | Usable in Skin Analysis |
||||
| ready | Uploaded and validated | Yes |
| failed | Uploaded, file failed validation | No |
An upload that fails validation answers an error and is still recorded as a failed catalog, visible in List catalogs; the error body never carries its catalog_id. Each account keeps up to 10 catalogs, ready and failed together — delete one before uploading another. To update a catalog, upload a new file: every upload creates a new catalog_id, and the old catalog stays usable until you delete it, so you can verify the new one before switching.
Inputs: request (required), polling. Returns: result
AI-Skin-simulationAi Skin SimulationCInspect
AI-Powered Skin Simulation: Visualizing Treatment Progress with Precision and Professionalism Our cutting-edge AI-driven skin simulation technology enables highly accurate before-and-after visualizations of facial skin conditions, allowing both professionals and consumers to objectively track the efficacy of skincare treatments over time. Engineered for high-fidelity realism and clinical-grade insights, this solution supports the visualization of up to ten distinct skin concerns, including radiance, acne, oiliness, eye bags, dark circles, spots, pores, texture, wrinkles and redness. By harnessing sophisticated machine learning models combined with advanced augmented reality capabilities, the system delivers realistic, non-invasive previews of potential outcomes using only a standard smartphone camera or desktop webcam. Each simulation is generated in seconds, offering users an immediate yet scientifically grounded understanding of how targeted skincare interventions may enhance their complexion over time. Designed specifically for skincare brands, dermatology practices, aesthetic clinics, and retail beauty retailers, this platform integrates effortlessly across digital and physical touchpoints, including e-commerce websites, mobile applications, virtual consultations, and point-of-sale kiosks. Its versatility supports a wide array of use cases such as personalized regimen recommendations, product performance simulation, treatment planning for professional procedures, and interactive educational tools that strengthen client engagement and build trust in brand claims. Through objective visualization and data-driven storytelling, our AI skin simulation empowers skincare professionals to set realistic expectations, customize care plans, and demonstrate measurable progress, ultimately elevating the customer experience while reinforcing evidence-based efficacy in an increasingly competitive market landscape.
Inputs: request (required), polling. Returns: result
AI-SmileAi SmileAInspect
Introducing Generative AI Smile API, the easy way to turn that frown upside down. This convenient AI smile generator transforms sad or neutral facial expressions into happy, natural looking smiles in just moments. Powered by advanced generative AI, it helps bring warmth and positivity to any photo with a simple and effortless process. Upload an image, let the AI work its magic, and instantly convert your sad face into a cheerful smiley face that spreads happiness everywhere it's shared. The AI Smile generator supports two distinct smile styles, giving users more control over the final expression.
smile_with_teeth_visible
This option creates a bright, joyful smile with naturally visible teeth. It is ideal for upbeat portraits, social media photos, and situations where a warm and expressive look is desired.closed_mouth_smile
This option produces a subtle, gentle smile with lips closed. It works well for professional photos, formal profiles, or when a calm and natural expression is preferred. Users can easily choose the smile type that best matches their photo, mood, or intended use, ensuring realistic and appealing results every time. Whether you're editing photos, creating fun content, or simply want to add a touch of positivity, Generative AI Smile makes it easy to spread happiness, one smile at a time. Upload a face. Click once. Smile instantly.
Inputs: request (required), polling. Returns: result
AI-Teeth-WhiteningAi Teeth WhiteningCInspect
AI Teeth Whitening API
The AI Teeth Whitening API provides an advanced, automated solution for enhancing smiles in photos. Using intelligent image processing, it brightens teeth naturally and accurately, creating polished, professional results within seconds.
How It Removes Yellow Teeth in Photos
Smart Whitening
The API automatically detects teeth and applies a natural-looking whitening effect without making the image appear artificial.
Adjustable Levels
A built-in adjustment feature allows users to control the degree of whitening, from a subtle enhancement to a more pronounced, camera-ready finish.
Key Features
Quick and Easy Enhancement
Achieve a noticeably brighter smile in just a few seconds.
Accurate AI Detection
Advanced detection ensures that only teeth are modified, maintaining a realistic and balanced appearance.
Adjustable Whitening Intensity
Users can fine-tune the whitening strength to match their preferred style.
Natural Results with Advanced Algorithms
The AI Teeth Whitening API uses sophisticated algorithms designed to identify teeth precisely and apply whitening effects that remain true to life. Users can refine the intensity to achieve a subtle, natural improvement, ensuring that the final result looks authentic and visually appealing.
Inputs: request (required), polling. Returns: result
AI-Teeth-Whitening-DetectionAi Teeth Whitening DetectionCRead-onlyInspect
Run an AI Teeth Whitening detection task.
Inputs: request (required), polling. Returns: result
AI-Wavy-Hair-Virtual-Try-OnAi Wavy Hair Virtual Try OnDInspect
Whether you're dreaming of bouncy ringlets, loose waves, or a bold curly statement, the YouCam API’s curly hair filter lets you experiment with a fresh, fabulous hairstyle in seconds—all from the comfort of home. Whether you're trying a soft wave or a bold afro, YouCam delivers a level of precision and realism that sets it apart. It's the ideal tool for exploring new hairstyles with confidence before your next salon visit. Suggestions for How to Shoot:
Inputs: request (required), polling. Returns: result
AI-Wavy-Hair-Virtual-Try-On-TemplatesAi Wavy Hair Virtual Try On TemplatesBRead-onlyIdempotentInspect
List predefined templates.
Inputs: no named parameters. Returns: result
File-UploadFile uploadAInspect
Interactive drag-and-drop widget for uploading images (JPEG, PNG) or videos (MP4). Returns file IDs for YouCam AI tools (AI-Fabric, AI-Cloth, AI-Makeup-Vto, AI-Hairstyle-Generator, AI-Skin-Analysis, etc.). /n Use when the user wants to upload or select an image/video (e.g. upload, drag & drop, choose file, pick image/video), or before any AI-* tool requiring src_file_id or ref_file_id when no file ID or URL is available. /n Also use as the mandatory fallback whenever Get-Upload-API-Info cannot complete the upload for any reason (including network restrictions, host_not_allowed, or other failures). Uploads directly from the browser, bypassing sandbox egress restrictions.
Inputs: task_type. Returns: object
Get-Feature-CostGet Feature CostARead-onlyIdempotentInspect
Check the unit consumption for each API. The values are consistent with those listed at https://yce.perfectcorp.com/ai-api/api-pricing.
Inputs: request (required). Returns: result
Get-Running-Task-StatusGet Running Task StatusARead-onlyIdempotentInspect
Retrieves the current status and results of a previously initiated AI processing task. Use this tool when you need to check on a task that was started earlier but hasn't completed yet, or when a user returns to inquire about a task they initiated previously. WHEN TO USE THIS TOOL:
When a user provides a task_id from a previous session and wants to check if their result is ready
When a user asks about a task they started earlier (e.g., 'Is my hairstyle ready?', 'Check my previous request')
When resuming a conversation where a task was left processing
When a task exceeded the initial polling timeout and the user wants to see if it has completed
Inputs: task_id (required), task_type (required), polling, is_preprocess. Returns: result
Get-Unit-HistoryGet Unit HistoryBRead-onlyIdempotentInspect
View the unit usage history for this account, such as units consumed or granted per task/order.
Inputs: request (required). Returns: result
Get-Unit-InfoGet Unit InfoARead-onlyIdempotentInspect
Get the current unit balance for this account, including each unit's type, amount, and expiry.
Inputs: no named parameters. Returns: result
Get-Upload-API-InfoGet Upload Api InfoARead-onlyIdempotentInspect
Returns the upload API endpoint and example request/response for uploading images (JPEG, PNG) or videos (MP4) to YouCam AI./n Use when the user wants to upload an image/video via the API. If upload cannot be completed for any reason (including network restrictions, host_not_allowed, or other errors), do not retry. Immediately use the File Upload Widget instead. Do not ask the user for a public URL.
Inputs: task_type (required). Returns: result
upload_fileBInspect
Upload base64-encoded media files to the YouCam API and return file_id(s).
If task_type is omitted, files are uploaded via the generic file API (POST /s2s/v2.0/file) rather than a task-specific upload path.
Inputs: files (required), task_type (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Provides YouCam API for AI image and video editing and generation.
Provides YouCam API for virtual try-on of clothing, jewelry, and watches.
Virtual try-on (VTO) API docs and SDK examples; OAuth account/guest photo uploads and try-ons.
VerifEye Face API: Identify (apparent age, gender, emotions, attention), Onboard and Compare faces.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides AI-based skin analysis from selfie image URLs, returning comprehensive skin status, personalized management recommendations, and therapy guidance including skin type classification, detailed condition scores, and treatment suggestions.-
- AlicenseAqualityBmaintenanceEnables face keypoint detection, beautification, age/gender transform, face swap, cartoonization, and liveness detection via AceDataCloud API.8344 PyPI1MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to index event photos, locate every photo containing a person from a single selfie, detect and compare faces, run batch jobs, and manage collections, webhooks, and billing through MCP clients.27283 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables local, offline generation and validation of passport, visa, exam, and other standard portrait photos, with face detection, background replacement, specification-based cropping, and print-sheet layout.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.