고스트 마네킹 · 기능
고스트 마네킹 API — Photta
의류 사진에서 마네킹을 제거하고 이음새, 안감, 태그 등 내부 구조를 온전하게 유지합니다. 할로우 맨 또는 플랫 레이 마감, 대량 작업 지원, 2K 기준 4 credits.
요약
Photta의 고스트 마네킹 API는 마네킹이 착용된 의류 사진을 받아 의류 내부가 재구성된 '투명 마네킹' 이미지를 반환합니다. `product_image_url`, `style`(hollow_man 또는 flat_lay), resolution을 포함해 `/api/v1/ghost-mannequin`으로 POST 요청을 보내세요. 상태가 `completed`가 될 때까지 3초마다 `/api/v1/ghost-mannequin/:id`를 폴링하세요.
curl -X POST https://ai.photta.app/api/v1/ghost-mannequin \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_image_url": "https://example.com/tshirt-on-model.jpg",
"style": "hollow_man",
"resolution": "2K"
}'기대 효과
Typical completion
1–3min
2K / 4K credits
4 / 6
Styles
2
Batch-ready
yes
전체 코드
언어 선택
동일한 REST 규약을 따릅니다. 고스트 마네킹 엔드포인트는 대량 카탈로그 작업을 위한 배치 프로세싱도 지원합니다.
작동 원리
사진 한 장으로 마네킹이 사라진 사진 완성
소스 업로드, 스타일 선택, 제출, 폴링, 다운로드.
- 01
단계 1
API 키 생성
고스트 마네킹은 다른 모든 Photta 기능과 동일한 자격 증명을 사용합니다. 하나의 키, 하나의 통합 크레딧.
- 02
단계 2
소스 사진 업로드
`product_image_url`에 공개 URL을 전달하거나 `/api/v1/uploads`를 통해 바이트 데이터를 먼저 업로드할 수 있습니다. JPG, PNG, WebP 형식을 지원합니다.
- 03
단계 3
고스트 마네킹 작업 POST
`product_image_url`, `style`(hollow_man 또는 flat_lay), `resolution`을 담아 `/api/v1/ghost-mannequin`으로 POST 요청을 보냅니다. 작업 완료 시 알림을 받으려면 `webhook_url`을 전달하세요. 폴링 방식도 여전히 기본으로 작동합니다.
- 04
단계 4
작업 완료까지 폴링
3초마다 GET `/api/v1/ghost-mannequin/:id`를 호출하세요. 고스트 마네킹은 새로운 인물을 렌더링하지 않기 때문에 가상 피팅보다 빨라서 보통 1에서 3분 정도 소요됩니다.
- 05
단계 5
다운로드 및 저장
출력물은 마네킹이 제거되고 의류 내부가 재구성된 PNG 파일입니다. PDP 고스트 샷, 3D 느낌의 제품 갤러리 및 플랫 레이 삽입용으로 최적입니다.
개발자 자주 묻는 질문
고스트 마네킹 배포 전 개발자들이 자주 묻는 질문
고스트 마네킹 사진이란 무엇인가요?+
의류가 투명한 인물 위에 떠 있는 것처럼 연출하여 형태와 내부 구조를 동시에 보여주는 PDP 처리 기법입니다. 과거에는 여러 스튜디오 샷을 합성해 만들었으나, Photta API는 마네킹 착용 사진 한 장만으로 단 한 번의 호출을 통해 이를 생성합니다.
고스트 마네킹 비용은 얼마인가요?+
2K 기준 4 credits, 4K 기준 6 credits로 각 티어에서 가상 피팅보다 1 credit씩 저렴합니다. 실패한 작업은 자동으로 환불됩니다.
할로우 맨(hollow-man)과 플랫 레이(flat-lay) 스타일의 차이는 무엇인가요?+
할로우 맨은 마네킹의 3D 체형을 유지합니다. 의류의 볼륨감, 어깨, 소매 라인이 자연스럽게 보이며 내부가 재구성됩니다. 플랫 레이는 의류를 평평한 2D 레이아웃으로 펼친 것처럼 처리하며, 캡슐 컬렉션이나 일관된 정면 형태를 요구하는 마켓플레이스 등록용에 적합합니다.
여러 장의 사진을 배치 작업(batch)으로 처리할 수 있나요?+
네. 소스 이미지 배열과 함께 `/api/v1/ghost-mannequin/batch`로 POST 요청을 보내세요. 응답으로 배치 ID와 개별 항목별 생성 ID를 받게 됩니다. 전체 상태를 확인하려면 `/api/v1/ghost-mannequin/batch/:id`를, 개별 항목은 각각의 ID로 폴링하세요.
내부 솔기나 라벨도 보존되나요?+
네. 모델은 단순히 표면을 환각해내는 것이 아니라 의류의 실제 내부(목선 안쪽, 소매 안쪽, 허리 안감 등)를 재구성합니다. 원본 사진에서 식별 가능한 태그와 인쇄된 라벨은 가능한 한 그대로 유지됩니다.
결과는 어떻게 폴링하나요?+
3초마다 GET `/api/v1/ghost-mannequin/:id`를 호출하세요. 배치 작업의 경우 상위 엔드포인트를 폴링하여 전체 상태와 개별 항목 상세 내용을 확인할 수 있습니다.
고스트 마네킹 · 기능
계정 생성 및 API 키 발급
Photta의 고스트 마네킹 API는 마네킹이 착용된 의류 사진을 받아 의류 내부가 재구성된 '투명 마네킹' 이미지를 반환합니다. `product_image_url`, `style`(hollow_man 또는 flat_lay), resolution을 포함해 `/api/v1/ghost-mannequin`으로 POST 요청을 보내세요. 상태가 `completed`가 될 때까지 3초마다 `/api/v1/ghost-mannequin/:id`를 폴링하세요.