의류 · 기능
의류 가상 피팅 API — Photta
REST 호출 한 번으로 바닥에 펼쳐놓은 의류 사진을 화보급 모델 착용 사진으로 변환합니다. 비동기 방식이며 생성당 1.5–4분 소요, 비용은 2K 해상도 시 5 credits, 4K 해상도 시 7 credits입니다.
요약
Photta의 의류 가상 피팅 API는 바닥에 펼친 의류 이미지, mannequin_id, pose_id를 전달받아 2K 또는 4K 모델 착용 사진을 반환합니다. `Authorization: Bearer photta_live_xxx` 헤더로 인증하고, `/api/v1/tryon/apparel`로 POST 요청을 보낸 뒤 반환된 생성 ID로 3~5초마다 폴링하여 상태가 `completed`가 되면 결과물을 다운로드하면 됩니다.
curl -X POST https://ai.photta.app/api/v1/tryon/apparel \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_type": "dress",
"product_images": ["https://example.com/dress.jpg"],
"mannequin_id": "mnq_athena_ts",
"pose_id": "pose_standing_front",
"resolution": "2K",
"aspect_ratio": "3:4"
}'기대 효과
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Aspect ratios
5
Product types
6
전체 코드
언어 선택
동일한 엔드포인트에 대한 세 가지 실행 가능한 가이드입니다. 모든 스니펫은 공식 Photta 문서와 일치합니다.
작동 원리
네 번의 API 호출로 하나의 제품 사진 완성
마네킹과 포즈를 선택하고, 작업을 제출하고, 완료될 때까지 폴링한 뒤 결과물을 다운로드하세요.
- 01
단계 1
API 키 생성
ai.photta.app에서 가입하고 개발자 탭에서 API 키를 생성하세요. 라이브 키는 `photta_live_`로 시작합니다. 키를 `PHOTTA_API_KEY`에 저장하고 절대 커밋하지 마세요.
- 02
단계 2
마네킹과 포즈 선택
GET `/api/v1/mannequins` 및 `/api/v1/poses`를 호출해 사용 가능한 옵션을 확인하세요. 브랜드에 맞는 체형, 표정, 인종, 포즈 카테고리를 필터링하여 ID를 선택할 수 있습니다.
- 03
단계 3
가상 피팅 작업 POST
`product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution`, `aspect_ratio`를 포함해 `/api/v1/tryon/apparel`로 POST 요청을 보냅니다. API는 202 Accepted와 생성 ID를 반환합니다.
- 04
단계 4
작업 완료까지 폴링
3초마다 GET `/api/v1/tryon/apparel/:id`를 호출합니다. `data.status`가 `completed`로 바뀌면 페이로드에 `output_url`과 `thumbnail_url`이 포함됩니다. 작업 지연에 대비해 최대 시도 횟수를 설정하세요.
- 05
단계 5
다운로드 및 저장
`output_url`에서 바이트를 가져와 자체 오브젝트 스토리지에 저장하세요. CDN URL은 고정적이지만, 렌더링을 위해 Photta의 CDN에 의존하지 않는 것이 좋습니다.
개발자 자주 묻는 질문
의류 가상 피팅 배포 전 개발자들이 자주 묻는 질문
Photta의 의류 가상 피팅 API란 무엇인가요?+
바닥에 펼쳐놓은 제품 이미지와 ID 쌍(마네킹 + 포즈)을 받아 실사 같은 모델 착용 이미지를 반환하는 REST 엔드포인트입니다. Photta 소비자용 앱과 동일한 파이프라인을 사용합니다. 상의, 하의, 상하의 세트, 원피스, 원피스 수영복, 점프수트 등 6가지 제품 유형을 지원합니다.
호출당 비용은 얼마인가요?+
2K 결과물은 5 credits, 4K 결과물은 7 credits입니다. 크레딧은 구독 플랜에 포함되어 있으며 추가 충전도 가능합니다. 생성이 실패한 경우에는 크레딧이 차감되지 않고 환불됩니다.
생성하는 데 시간이 얼마나 걸리나요?+
시작부터 끝까지 보통 1.5에서 4분 정도 소요됩니다. POST 요청은 1초 미만으로 생성 ID를 반환하며, 폴링하는 동안 배경에서 GPU 작업이 진행됩니다.
어떤 제품 유형을 지원하나요?+
6가지입니다: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. 각 유형은 서로 다른 `product_images` 구조를 요구합니다. 예를 들어 `top_and_bottom`은 `top_image`와 `bottom_image` URL이 모두 필요합니다.
자체 마네킹을 사용할 수 있나요?+
네. 마네킹 사진을 `/api/v1/mannequins/upload`로 업로드하거나, `/api/v1/mannequins/generate-model`로 새로운 AI 모델을 생성할 수 있습니다. 반환된 ID를 가상 피팅 요청에 바로 사용할 수 있습니다.
결과는 어떻게 폴링하나요?+
3~5초마다 GET `/api/v1/tryon/apparel/:id`를 호출하여 `data.status`가 `completed` 또는 `failed`가 될 때까지 확인하세요. 최대 시도 횟수를 설정할 때 120회 x 3초 정도로 구성하면 문서화된 소요 시간을 충분히 커버할 수 있습니다.
의류 · 기능
계정 생성 및 API 키 발급
Photta의 의류 가상 피팅 API는 바닥에 펼친 의류 이미지, mannequin_id, pose_id를 전달받아 2K 또는 4K 모델 착용 사진을 반환합니다. `Authorization: Bearer photta_live_xxx` 헤더로 인증하고, `/api/v1/tryon/apparel`로 POST 요청을 보낸 뒤 반환된 생성 ID로 3~5초마다 폴링하여 상태가 `completed`가 되면 결과물을 다운로드하면 됩니다.