고스트 마네킹 API

Photoroom의 고스트 마네킹 API는 의류 사진을 마네킹이 보이지 않는 깔끔한 상품 사진으로 바꿔 핏과 옷의 자연스러운 실루엣을 선명하게 보여줘요. 이런 스타일은 인비저블 마네킹이라고도 해요. Photoroom API에서 제공하는 20개 이상의 편집 항목 중 하나예요.

각 사진을 고스트 마네킹을 켠 상태로 Photoroom API에 보내세요. 한 번 호출할 때 이미지 한 장씩 보내면 마네킹이 보이지 않는 완성 이미지를 받아볼 수 있어요. 고스트 마네킹은 의류가 담긴 이미지에 사용하도록 만들어졌어요. 아래 코드 예시에서 API 호출을 확인할 수 있어요.

Photoroom API 하나로 깔끔한 의류 사진을 위한 고스트 마네킹과 옷 사진을 미리 설정했거나 직접 지정한 AI 모델을 활용한 라이프스타일 이미지로 바꾸는 버추얼 모델을 모두 이용할 수 있어요. 여기에 플랫 레이, AI 다림질, 배경 제거까지 하나의 연동으로 처리할 수 있어요.

상품 카탈로그나 업로드 흐름을 Photoroom API에 연결하고, 호출당 의류 사진 한 장을 전송하세요. 호출을 병렬로 실행하면 기본적으로 분당 최대 60장까지 처리할 수 있어요. 상품이 많은 카탈로그를 운영한다면 Enterprise 요금제에서 한도를 높일 수 있어요. 영업팀에 문의해 보세요.

고스트 마네킹은 월 100달러(이미지당 0.10달러)의 Plus API 요금제에 포함되어 있으며, Enterprise 요금제에서도 이용할 수 있어요. 영업팀에 문의하기. 호출당 비용은 함께 적용하는 편집 수와 관계없이 동일하고, 오류가 발생한 호출은 이미지 사용량에 포함되지 않아요. 워터마크가 표시되는 무료 호출을 한 달에 1,000회 제공하는 샌드박스 모드에서 먼저 테스트해 볼 수 있어요. 자세한 내용은 요금 페이지에서 확인하세요.

API 키를 발급받은 다음, ghostMannequin.mode를 ai.auto로 설정해 의류 사진을 보내세요:

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header 'x-api-key: YOUR_API_KEY_HERE' \
  --form imageFile=@/path/to/image.png \
  --form ghostMannequin.mode=ai.auto \
  --output result.png

모든 매개변수는 고스트 마네킹 문서에 있어요.

ghostMannequin.mode: ai.auto로 설정하면 고스트 마네킹을 사용할 수 있어요.

ghostMannequin.size: 생성된 이미지의 출력 크기와 가로세로 비율이에요. 기본값은 SQUARE_HD예요. 다른 값은 PORTRAIT_HD_16_9, PORTRAIT_HD_4_3, PORTRAIT_HD_3_2, LANDSCAPE_HD_3_2, LANDSCAPE_HD_4_3, LANDSCAPE_HD_16_9예요.

ghostMannequin.prompt: 스타일을 안내하는 선택적 텍스트 프롬프트예요. 예를 들면 고스트 마네킹이에요.

최대 30MB이고 가장 긴 변이 5,000픽셀 이하인 PNG, JPEG, WEBP 또는 AVIF 파일을 보내면 같은 형식으로 받을 수 있어요. 기본적으로 고스트 마네킹은 이미지를 1K(1024 x 1024) 해상도로 반환해요. Enterprise 요금제에서는 2K와 4K 출력 해상도를 사용할 수 있어요. 자세한 내용은 파일 크기, 해상도 및 형식 문서 페이지에서 확인하세요.

네. Photoroom에는 Claude와 같은 AI 어시스턴트를 위한 MCP 서버가 있어요. 지원하는 도구는 Photoroom MCP에서 확인해 보세요.

API 사용에 어려움이 있으신가요? API 커뮤니티에 참여해 엔지니어의 도움을 받거나, 자주 발생하는 문제는 문제 해결 페이지에서 확인해 보세요.

결제 관련 내용이나 민감한 정보가 포함된 문의는 커뮤니티에서 Photoroom에 직접 DM으로 보내 주세요. 언제든 기꺼이 도와드릴게요.