가이드 · 고스트 마네킹

고스트 마네킹 API란 무엇인가요? 인비저블 마네킹 샷

한 줄 요약

고스트 마네킹 API는 마네킹 착용 의류 사진을 받아 마네킹을 제거하고 내부를 재구성하여 반환하므로, 의류가 자체적인 형태를 유지하는 것처럼 보이게 합니다.

API 키 발급받기문서 보기
  • 일반적인 소요 시간: 1.5–4 min
  • 크레딧: 2K에서 4 크레딧 · 4K에서 5 크레딧
  • 처리 방식: 비동기, 폴링

이 페이지의 모든 수치는 다음 출처를 기반으로 합니다: Photta API 문서 · 확인 완료

요약

고스트 마네킹 사진(할로우 맨 또는 인비저블 마네킹이라고도 함)은 내부에 신체 없이 의류의 형태를 유지한 모습을 보여줍니다. 전통적으로는 스튜디오에서 촬영한 여러 프레임(마네킹에 입힌 의류를 찍고, 마네킹을 지운 뒤, 깃과 소매 안쪽을 다시 합성)을 후작업으로 이어 붙여 제작합니다.

고스트 마네킹 API는 이 작업을 단 한 번의 호출로 처리합니다. 마네킹 착용 사진을 전송하면, 서비스가 마네킹 형태를 제거하고 넥라인 안쪽, 소매 안감, 허리 밴드 등 의류 내부에 보여야 할 부분을 복원하여 완성된 이미지를 반환합니다. try-on과 마찬가지로 호출은 비동기 방식으로 진행됩니다. 제출(submit), 폴링(poll), 다운로드(download) 순입니다.

의류 상품 상세 페이지의 표준 처리 방식이므로, 의류마다 스튜디오 일정을 잡지 않고도 수천 개 품목에 걸쳐 일관된 룩을 구현해야 하는 카탈로그 팀과 마켓플레이스가 주로 호출합니다.

해당 작업을 수행하는 endpoint

수작업 작성이 아닌 Photta API 문서에서 직접 읽어온 내용입니다.

한눈에 보기

엔드포인트
POST /api/v1/ghost-mannequin
인증
Bearer API 키
처리 방식
비동기 — 상태 엔드포인트 폴링
일반적인 소요 시간
1.5–4 min
크레딧
2K에서 4 크레딧 · 4K에서 5 크레딧
화면비
3:4 · 1:1 · 4:3 · 9:16 · 16:9
입력 제한
이미지당 최대 10 MB; JPEG, PNG, WebP
멱등성
아니요

고스트 마네킹 API 선택 시 고려할 사항

  • 전송 데이터

    마네킹에 착용한 의류 사진과 선택 사항인 후면 뷰입니다. Photta는 이미지당 최대 10 MB까지 JPEG, PNG, WebP 형식을 지원합니다.

  • 제공되는 마감 방식

    Photta의 endpoint는 style을 입력받습니다. 3d는 의류의 3차원 볼륨감을 유지하고, flat_lay는 깔끔한 정면 레이아웃 형태로 평평하게 만듭니다.

  • 비용 안내

    Photta 기준 2K는 4 credits, 4K는 5 credits입니다. 각 티어별 try-on보다 1 credit 저렴하며, 작업 실패 시 자동으로 환불됩니다.

  • 배치 처리 지원 여부

    카탈로그 작업은 단건이 아니라 행거 단위로 들어옵니다. Photta에는 배열을 받아 사전에 credits를 예약하고 항목별 상태를 보고하는 배치 endpoint가 있습니다.

첫 번째 요청

cURL, Node.js, Python으로 작성된 동일한 호출 코드.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/ghost-mannequin \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/jacket-front.jpg",
  "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
  "image_side": "front",
  "angle": "side",
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, cream interior lining",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

고스트 마네킹 API 관련 자주 묻는 질문

고스트 마네킹 사진이란 무엇인가요?

눈에 보이는 신체나 옷걸이 없이 의류가 공중에 떠 있는 것처럼 형태를 유지하는 상품 컷입니다. 핏과 내부 구조를 동시에 보여주기 때문에 의류 상품 페이지의 기본 표준으로 사용됩니다.

endpoint에 무엇을 전송해야 하나요?

마네킹에 착용한 의류 사진입니다. 후면 뷰는 선택 사항이며, 옷이 열려 있거나 양면으로 입을 수 있는 제품일 때 복원 품질을 높여줍니다.

3d와 flat lay 중 무엇을 선택해야 하나요?

볼륨감, 어깨선, 소매 등 옷을 실제로 착용한 느낌을 살리고 싶다면 3d를 선택하세요. 마켓플레이스에서 자주 요구하듯 목록상 일관된 정면 형태를 원한다면 flat_lay를 선택하세요.

이미지 한 장당 비용은 얼마인가요?

Photta 기준 2K는 4 credits, 4K는 5 credits입니다. 배치 실행 시 전체 작업에 대해 동일한 이미지당 가격이 사전에 예약됩니다.

전체 카탈로그를 한 번에 처리할 수 있나요?

네, 배치 endpoint를 통해 가능합니다. 배치 크기와 동시 실행 가능한 배치 수는 요금제에 따라 결정되므로, 대규모 카탈로그는 여러 배치로 순차 실행됩니다.

다음 읽을거리

이 페이지의 모든 수치는 다음 출처를 기반으로 합니다: Photta API 문서 · 확인 완료

단일 의류로 직접 테스트해 보세요

한 장의 사진 입력, 한 장의 인비저블 마네킹 샷 출력.

계정 생성 후 API 키 발급받기엔드포인트 보기
  • 1.5–4 min
  • 2K에서 4 크레딧 · 4K에서 5 크레딧
  • 비동기, 폴링