ZennFes의 테마 목록을 살펴보던 중 「YouCam API를 활용한 구현 사례와 아이디어」라는 항목이 눈에 들어왔습니다. YouCam이라고 하면 메이크업 앱이라는 이미지가 있었는데, 개발자용 API가 있다는 것을 처음 알게 되었습니다.

뷰티 계열의 AR/AI를 API로 호출할 수 있다면 재미있는 앱을 만들 수 있을 것 같습니다. 실제로 만져보기 전에, 우선 어떤 것을 할 수 있는지 조사해 보았습니다.

YouCam API는 대만 기업 Perfect Corp.가 제공하는 뷰티·패션 특화 AI/AR 기능군을 REST API로 이용할 수 있는 서비스입니다.

해당 기업은 「YouCam Makeup」이라는 세계 누적 3억 다운로드를 넘어서는 메이크업 앱을 개발하고 있으며, 그곳에서 쌓은 AR 기술을 API로서 외부 개발자에게 개방하고 있습니다.

• YouCam Online Editor 접속
• 무료 계정 생성
• API Console에서 키 발급

무료 범위에서도 일정 크레딧을 받을 수 있으므로 프로토타입 제작에는 충분해 보입니다.

처리는 크레딧 소비형이며, 대략 다음과 같은 이미지입니다.

• 이미지 1장 처리: 1~2 크레딧
• 동영상: 1 크레딧으로 약 2초 분량 처리

자세한 내용은 요금 페이지에서 확인할 수 있습니다.

2024년에 V2가 출시되어 응답 형식이 단순해졌습니다. 이전에는 결과가 ZIP으로 반환되었으나, V2에서는 직접 JSON에 이미지 URL이나 스코어가 포함되는 형식이 되었습니다.

기본적인 흐름은 다음과 같습니다.

1. 이미지를 업로드 → task_id를 획득
2. task_id로 폴링 (Polling) (또는 webhook) → 처리 완료를 대기
3. 결과 이미지 URL / 스코어를 받음

import requests
import time
API_KEY = "your_api_key_here"
...

실제 엔드포인트 이름이나 파라미터는 공식 문서에서 확인이 필요하지만, 구조는 이런 이미지입니다.

조사하는 과정에서 Zenn의 다른 기사에서 실제로 테스트해 본 분들의 지견이 참고가 되었습니다.

SD 모드와 HD 모드는 혼용 불가: 피부 분석 요청 내에서 SD/HD 진단 항목을 섞으면 에러가 발생함 -
사전 검증 (Validation)을 넣는 것이 좋음: 업로드 직후에 "얼굴이 검출되었는지", "해상도·밝기는 문제가 없는지"를 확인한 후 API 호출로 넘어가는 설계가 안정적임 -
비동기 전제: 처리에 몇 초가 걸리기 때문에 폴링 (Polling) 또는 Webhook 구현이 필요

2026년 5월, Perfect Corp.는 YouCam API 플랫폼에 **「Ask AI」**라는 무료 AI 어시스턴트를 통합했습니다.

이는 MCP (Model Context Protocol) 대응 클라이언트 (Cursor나 VS Code의 Copilot, Claude Desktop 등)의 설정 파일에 API 키를 한 줄 추가하는 것만으로, 자연어로 YouCam API의 기능을 호출할 수 있게 해주는 것입니다.

// .cursor/mcp.json 등에 추가하기만 하면 됨
{
"mcpServers": {
...

영어 문서에 대한 진입 장벽이 낮아지는 것과, "이 이미지 피부 분석해 줘"라고 일본어로 지시하는 것만으로 작동한다는 점은 시작 단계의 허들을 상당히 낮춰준다고 느꼈습니다.

조사하면서 "이거 만들 수 있겠다"라고 생각한 아이디어를 몇 가지 메모했습니다.

피부 관리 다이어리
매일 피부 사진을 찍어 보내면 모공·기미·칙칙함 스코어를 기록하고 그래프화해 주는 앱. "최근 수면 부족이 피부에 나타나고 있구나"와 같은 회고를 할 수 있다면 재미있을 것 같다.

정기 촬영 → 피부 분석 API → 스코어를 DB에 저장 → 꺾은선 그래프로 시각화

메이크업 공유 및 가상 체험 서비스
메이크업 완성 이미지와 메이크업 설정 (립스틱 색상, 아이섀도 종류)을 세트로 게시·공유할 수 있는 서비스. YouCam API로 그 메이크업을 다른 얼굴에 재현할 수 있다면 "이 메이크업, 나에게 어울릴까?"를 확인하며 찾을 수 있다.

게시된 메이크업 파라미터 → 자신의 얼굴 사진에 적용 → 가상 시착 (Virtual Try-on)

스타일 매칭 도구
"이 옷에 어울리는 헤어 컬러는?"라는 질문에 답하는 도구. 의상 이미지에서 색상을 추출하여, 궁합이 좋은 헤어 컬러를 YouCam API로 시착하게 한다.

의상 색상 추출 (Color Palette) → 헤어 컬러 API (Hair Color API)로 여러 색상 시착 → 비교 표시

화장품 이커머스 (EC)에 통합하여, 얼굴형·피부톤 진단 결과에 따라 "당신의 얼굴형에는 이 립 형태가 잘 어울립니다"라는 추천 (Recommendation)을 제공한다.

조사해 본 결과, 뷰티·패션 특화 AI API라는 희귀한 포지션을 가진 서비스라는 것을 알 수 있었습니다. 범용 이미지 인식 AI (Image Recognition AI)로 동일한 작업을 수행하려면 얼굴 랜드마크 검출 (Face Landmark Detection)·메이크업 마스크 생성 (Makeup Mask Generation)·색상 합성 (Color Composition) 등 많은 파트를 직접 조합해야 합니다. 이를 API 하나로 해결할 수 있다는 점은 개발 비용 측면에서 상당히 도움이 될 것 같습니다.

한편, 크레딧 소비형 과금 방식이므로 트래픽을 예측하기 어려운 서비스에서는 사전에 비용 산출을 철저히 해둘 필요가 있습니다.

다음에는 실제로 API 키를 취득하여 피부 분석을 구동하는 단계까지 진행해 보고 싶습니다.

이 기사는 Zenn에서도 공개하고 있습니다.