작성자: 
헤어스타일 가상 체험에서 사용자가 원하는 것은 단순히 다른 사람의 헤어스타일을 그대로 복사하는 것이 아닙니다. 마음에 드는 커트, 레이어, 웨이브, 앞머리 등의 스타일을 자신의 얼굴과 현재 헤어 컬러에 적용해 보고 싶은 경우도 많습니다.
예를 들어 사용자가 마음에 드는 헤어스타일 사진을 업로드하고 가상 체험을 실행했다고 가정해 보겠습니다. 커트와 레이어는 마음에 들지만, 참조 이미지 속 모델의 플래티넘 블론드 헤어까지 적용되는 것은 원하지 않을 수 있습니다.
Perfect Corp의 AI 헤어스타일 API V2.1에서는 이러한 개발 요구사항을 보다 유연하게 처리할 수 있습니다. hair_color 파라미터를 사용하면 Customize 모드에서 참조 이미지의 헤어스타일을 적용하면서 사용자의 기존 헤어 컬러를 유지할 수 있습니다.
이번 업데이트를 통해 헤어스타일의 형태와 컬러를 분리해서 제어할 수 있게 되면서, 가상 헤어스타일 체험을 제공하는 뷰티 앱, 헤어 살롱 서비스, 헤어케어 이커머스 및 AI 스타일링 서비스에서 보다 세밀한 사용자 경험을 구현할 수 있습니다.
주요 내용
AI 헤어스타일 API V2.1에서 달라진 점
Perfect Corp의 Hair Style Virtual Try-On API는 크게 두 가지 방식으로 헤어스타일을 체험할 수 있습니다. 미리 준비된 스타일을 선택하는 Preset Style과 사용자가 직접 참조 이미지를 업로드하는 Customize입니다.
Preset Style은 서비스에서 제공하는 스타일을 선택하는 방식이기 때문에 스타일과 헤어 컬러가 미리 정의되어 있습니다. 반면 Customize는 사용자가 원하는 헤어스타일 사진을 직접 입력할 수 있어 보다 자유로운 가상 체험을 구현할 수 있습니다.
기존 Customize 방식에서는 참조 이미지의 헤어 컬러가 함께 적용되는 것이 기본 동작이었습니다. 따라서 사용자가 커트나 웨이브 형태만 참고하고 싶더라도 참조 이미지의 컬러까지 변경될 수 있었습니다.
AI 헤어스타일 API V2.1에서는 새로운 hair_color 파라미터를 통해 이 동작을 제어할 수 있습니다.
| 설정 | 결과 | 활용 목적 |
|---|---|---|
hair_color: "src" | 사용자 원래 헤어 컬러 유지 | 헤어스타일만 변경하고 싶을 때 |
hair_color: "ref" | 참조 이미지의 헤어 컬러 적용 | 스타일과 컬러를 함께 체험할 때 |
| 파라미터 생략 | ref가 기본값 | 기존 API 동작 유지 |
hair_color 파라미터 작동 방식
hair_color는 hairTransfer 효과에서 사용할 수 있는 파라미터이며, Customize 스타일을 사용할 때 헤어 컬러의 처리 방식을 지정합니다.
개발자는 다음 두 가지 값을 선택할 수 있습니다.
src: 사용자의 원래 헤어 컬러 유지
hair_color: "src"를 사용하면 참조 이미지에서 헤어스타일의 형태와 특징을 가져오면서 사용자의 기존 헤어 컬러를 유지할 수 있습니다.
예를 들어 사용자가 현재 갈색 머리를 하고 있고, 금발 모델의 레이어드 컷을 참조 이미지로 제공한다고 가정해 보겠습니다. src를 사용하면 결과에서 레이어드 헤어스타일은 적용하되 사용자의 갈색 헤어 컬러는 유지하는 방식으로 가상 체험을 구현할 수 있습니다.
ref: 참조 이미지의 헤어 컬러 적용
hair_color: "ref"는 참조 이미지의 헤어 컬러까지 적용하는 방식입니다. 이는 기존 Customize의 기본 동작과 동일합니다.
따라서 새로운 API 버전에서도 참조 이미지와 동일한 전체적인 룩을 구현하고 싶은 경우 ref를 사용할 수 있습니다.
파라미터를 생략하면?
hair_color를 요청에 포함하지 않으면 기본값은 ref입니다. 이는 기존 API의 동작을 그대로 유지하기 위한 하위 호환성 설계입니다.
즉, 이미 AI 헤어스타일 API를 연동한 서비스에서 기존 요청 코드를 수정하지 않아도 현재와 동일한 결과를 계속 사용할 수 있습니다.
Customize 모드의 API 요청 구조
개발자 관점에서 이번 업데이트의 핵심은 기존 Hair Style Virtual Try-On API의 전체 연동 구조를 변경하는 것이 아니라, Customize 요청에서 헤어 컬러의 처리 방식을 선택할 수 있는 파라미터가 추가되었다는 점입니다.
기본적인 흐름은 다음과 같습니다.
- 사용자 사진을 준비합니다.
- 사용자가 원하는 헤어스타일의 참조 이미지를 준비합니다.
hairTransfer를 사용해 Customize 스타일을 요청합니다.- 필요한 경우
hair_color값을 지정합니다. - API 작업이 완료되면 기존 Result 처리 방식으로 결과 이미지를 가져옵니다.
예를 들어 사용자의 기존 헤어 컬러를 유지하려는 경우 요청 데이터에는 다음과 같은 개념으로 hair_color를 추가할 수 있습니다.
{
"style": "customize",
"hair_color": "src"
}반대로 참조 이미지의 헤어 컬러까지 적용하려면 다음과 같이 설정할 수 있습니다.
{
"style": "customize",
"hair_color": "ref"
}실제 API 요청에 필요한 전체 파라미터와 데이터 형식은 Hair Style API 레퍼런스에서 확인할 수 있습니다.
서비스에 적용할 때 고려할 점
이번 업데이트는 단순히 API 파라미터 하나를 추가하는 것 이상의 의미가 있습니다. 개발자는 사용자가 헤어스타일과 헤어 컬러 중 무엇을 변경하고 싶은지를 서비스 UI에서 선택하도록 구성할 수 있습니다.
헤어스타일만 변경하는 UX
헤어스타일 카탈로그를 운영하는 서비스라면 사용자의 현재 헤어 컬러를 유지한 채 다양한 커트와 스타일을 비교할 수 있도록 구성할 수 있습니다.
예를 들어 사용자가 자신의 사진을 업로드한 뒤 “레이어드”, “숏컷”, “보브”, “웨이브” 등의 스타일을 차례로 선택하면 각 스타일을 현재 헤어 컬러에 적용해 비교할 수 있습니다.
헤어 컬러까지 함께 체험하는 UX
반대로 염색 서비스나 헤어 컬러 제품을 홍보하는 경우에는 참조 이미지의 컬러까지 적용하는 것이 더 적합할 수 있습니다.
이 경우 hair_color: "ref"를 사용해 헤어스타일과 컬러를 함께 변경하는 가상 체험을 제공할 수 있습니다.
두 가지 옵션을 UI로 제공하기
가장 유연한 방법은 사용자가 직접 선택하도록 만드는 것입니다.
헤어 컬러 설정
○ 현재 헤어 컬러 유지
○ 참조 이미지의 헤어 컬러 적용사용자가 첫 번째 옵션을 선택하면 src, 두 번째 옵션을 선택하면 ref를 API 요청에 전달하는 방식으로 구현할 수 있습니다.
이렇게 하면 하나의 헤어스타일 참조 이미지를 사용하면서도 스타일 체험과 염색 체험을 하나의 API 연동으로 분리할 수 있습니다.
AI 헤어스타일 API를 활용할 수 있는 실제 서비스 시나리오
헤어 살롱 및 예약 서비스
사용자가 예약 전에 자신의 사진에 다양한 헤어스타일을 적용해 볼 수 있도록 가상 상담 기능을 제공할 수 있습니다. 스타일 변경과 헤어 컬러 변경을 분리하면 상담 과정에서 더욱 다양한 옵션을 비교할 수 있습니다.
헤어케어 및 뷰티 이커머스
헤어 컬러 제품이나 스타일링 제품을 판매하는 이커머스에서는 제품과 관련된 헤어스타일을 사용자의 사진에 적용해 구매 전 결과를 미리 확인하도록 할 수 있습니다.
AI 헤어스타일 추천 서비스
LLM 기반 스타일 추천 기능과 AI 헤어스타일 API를 결합하면 “나에게 어울리는 헤어스타일을 추천해 줘”라는 자연어 요청에서 분석, 스타일 추천, 가상 체험까지 이어지는 서비스를 구현할 수 있습니다.
헤어스타일 카탈로그 및 콘텐츠 서비스
헤어스타일 이미지를 참조 이미지로 활용해 사용자의 사진에 다양한 스타일을 적용하면, 단순한 이미지 카탈로그를 넘어 사용자가 직접 결과를 확인할 수 있는 인터랙티브 콘텐츠를 만들 수 있습니다.
API Playground에서 직접 테스트하기
코드를 작성하기 전에 이번 업데이트를 확인하고 싶다면 YouCam API Playground에서 Hair Style API를 직접 테스트할 수 있습니다.
Playground에서 Hair Style을 선택하고 Version을 V2.1로 설정하면 Customize 영역에서 Hair Color 옵션을 확인할 수 있습니다.
여기에서 사용자의 헤어 컬러를 유지하는 옵션과 참조 이미지의 헤어 컬러를 적용하는 옵션을 전환하면서 결과를 비교할 수 있습니다.
Playground의 기본 UI에서는 사용자의 헤어 컬러를 유지하는 옵션이 기본으로 표시되지만, API 자체에서 hair_color를 생략했을 때의 기본값은 기존과 동일하게 ref입니다.
또한 참조 이미지의 입력 방식도 변경되지 않았습니다. 기존과 동일하게 URL, 파일 업로드 및 샘플 이미지를 이용해 기능을 테스트할 수 있습니다.
YouCam API Playground에서 AI 헤어스타일 API 테스트하기
V2.1 업데이트 전후 비교
| 항목 | V2.1 이전 | V2.1 |
|---|---|---|
| Customize 모드 | 지원 | 지원 |
| 참조 이미지 헤어 컬러 적용 | 기본 적용 | ref로 선택 가능 |
| 사용자 헤어 컬러 유지 | Customize에서 지원하지 않음 | hair_color: "src" |
| 새 파라미터 | 없음 | hair_color |
| 파라미터 생략 시 동작 | 참조 컬러 적용 | ref 적용 |
| Preset Style | 기존 동작 | 기존 동작 유지 |
기존 API 연동 서비스에서 적용하는 방법
이미 Hair Style API를 사용하고 있다면 이번 업데이트를 적용하기 위해 전체 API 연동 구조를 다시 구축할 필요는 없습니다.
기존 Customize 요청에서 hair_color를 생략하면 기본값이 ref로 유지되기 때문에 기존 동작을 그대로 유지할 수 있습니다.
반대로 사용자의 기존 헤어 컬러를 유지하는 새로운 경험을 제공하고 싶다면 Customize 요청에 hair_color: "src"를 추가하면 됩니다.
따라서 기존 서비스에 적용할 때는 다음과 같은 단계로 접근하는 것을 권장합니다.
- 현재 Customize API 요청과 결과를 확인합니다.
- 사용자의 기존 헤어 컬러를 유지해야 하는 UX가 필요한지 결정합니다.
- 필요한 경우
hair_color: "src"를 추가합니다. - 기존
ref동작과src동작의 결과를 비교합니다. - API Playground에서 다양한 사용자 및 참조 이미지를 테스트합니다.
- 검증이 완료되면 프로덕션 환경에 적용합니다.
특히 헤어스타일 카탈로그를 운영하는 서비스라면 다양한 헤어 컬러를 가진 사용자의 사진으로 테스트해 보는 것이 좋습니다. 참조 이미지와 사용자 이미지의 헤어 컬러가 크게 다른 경우에도 서비스가 의도한 사용자 경험을 제공하는지 확인할 수 있습니다.
AI 헤어스타일 API 시작하기
이번 업데이트는 AI 헤어스타일 API를 활용하는 개발자가 헤어스타일과 헤어 컬러를 보다 세밀하게 제어할 수 있도록 하는 기능 개선입니다.
hair_color 하나의 파라미터만으로도 Customize 모드에서 다음과 같은 두 가지 경험을 구현할 수 있습니다.
- 헤어스타일만 변경:
hair_color: "src" - 헤어스타일과 헤어 컬러를 함께 변경:
hair_color: "ref"
기존 API 연동은 그대로 유지하면서 새로운 옵션만 선택적으로 추가할 수 있기 때문에, 기존 서비스를 운영하면서도 사용자에게 더욱 유연한 가상 헤어스타일 체험을 제공할 수 있습니다.
전체 파라미터와 요청 데이터 형식은 Hair Style API 레퍼런스 문서에서 확인할 수 있습니다.
코드 작성 전에 기능을 확인하고 싶다면 YouCam API Playground에서 Hair Style V2.1을 선택해 새로운 Hair Color 옵션을 직접 테스트해 보세요.
