주얼리 · 기능
주얼리 가상 피팅 API — Photta
작고 빛 반사가 심한 표면 처리에 최적화된 모델을 사용하여 목걸이, 반지, 팔찌, 귀걸이를 착용한 클로즈업 샷을 생성합니다. 의류와 동일한 2K/4K 가격 및 비동기 패턴을 공유합니다.
요약
Photta의 주얼리 가상 피팅 API는 주얼리 사진과 `jewelry_type`(목걸이, 반지, 팔찌, 귀걸이)을 받아 클로즈업된 모델 사진을 반환합니다. `Authorization: Bearer photta_live_xxx`와 함께 `/api/v1/tryon/jewelry`로 POST 요청을 보내고, 3초마다 반환된 ID를 폴링하여 상태가 `completed`가 되면 결과물을 받으세요.
curl -X POST https://ai.photta.app/api/v1/tryon/jewelry \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jewelry_type": "necklace",
"jewelry_images": ["https://example.com/necklace.jpg"],
"mannequin_id": "mnq_jewelry_close_01",
"resolution": "2K",
"aspect_ratio": "1:1"
}'기대 효과
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Jewelry types
4
Close-up mannequins
built-in
전체 코드
언어 선택
동일한 세 가지 가이드를 따릅니다. 엔드포인트와 요청 본문 내용만 변경하면 됩니다.
작동 원리
의류 피팅 흐름을 작고 반사율이 높은 품목에 맞춰 재조정
클로즈업 모델을 선택하고, 제출하고, 폴링하고, 다운로드하세요.
- 01
단계 1
API 키 생성
의류와 동일합니다 — ai.photta.app → 개발자 → API 키 생성. 하나의 키와 통합 크레딧 잔액으로 모든 엔드포인트와 기능을 이용할 수 있습니다.
- 02
단계 2
클로즈업 모델 선택
`/api/v1/mannequins?jewelry_type=necklace`(또는 ring / bracelet / earrings)로 필터링하세요. Photta는 금속과 보석의 질감을 살리기 위해 피부 결이 정교하게 튜닝된 전용 클로즈업 모델 세트를 유지 관리합니다.
- 03
단계 3
주얼리 작업 POST
`jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`를 포함해 `/api/v1/tryon/jewelry`로 POST 요청을 보냅니다. 서비스가 주얼리 카테고리에 맞춰 위치를 자동 조정합니다.
- 04
단계 4
작업 완료까지 폴링
3초마다 GET `/api/v1/tryon/jewelry/:id`를 호출합니다. 응답 구조는 의류와 동일하게 `data.status`, `data.output_url`, `data.thumbnail_url`을 포함합니다.
- 05
단계 5
다운로드 및 저장
상품 상세 페이지용 썸네일은 1:1 비율이 가장 좋고, 화보용은 더 넓은 비율이 적합합니다. CDN 링크를 직접 연결하기보다는 바이트를 직접 저장하세요.
개발자 자주 묻는 질문
주얼리 가상 피팅 배포 전 개발자들이 자주 묻는 질문
어떤 주얼리 유형을 지원하나요?+
네 가지 명확한 카테고리를 지원합니다: 목걸이, 반지, 팔찌, 귀걸이. 각 카테고리에는 전용 클로즈업 모델 세트와 해당 형태에 맞게 튜닝된 배치 알고리즘이 적용됩니다. 반지와 귀걸이는 1:1 비율이 효과적이며, 목걸이는 3:4 비율에서 돋보입니다.
주얼리 가상 피팅 비용은 얼마인가요?+
의류와 동일합니다: 2K 5 credits, 4K 7 credits. 실패한 작업은 자동으로 환불됩니다. 클로즈업 모델 라이브러리 사용에 따른 추가 비용은 없습니다.
주얼리 엔드포인트는 의류 엔드포인트와 어떻게 다른가요?+
인증 방식, 폴링 패턴, 응답 구조는 모두 동일하며 요청 본문(request body)만 다릅니다. `product_type` 및 `product_images` 대신 `jewelry_type` 및 `jewelry_images`를 보내고, 주얼리 카테고리로 필터링된 모델을 선택합니다. 그 외(2K/4K, 화면 비율, 크레딧)는 모두 공유됩니다.
자체 주얼리 모델을 업로드할 수 있나요?+
네. `/api/v1/jewelry-mannequins/upload`는 커스텀 클로즈업 참조 사진을 받고, `/api/v1/jewelry-mannequins/generate`는 프롬프트를 통해 새 모델을 생성합니다. 두 방법 모두 가상 피팅 요청에 사용할 수 있는 ID를 반환합니다.
금속 반사와 보석 광택은 어떻게 처리되나요?+
클로즈업 파이프라인은 정반사 하이라이트와 미세 구조에 대한 메타데이터를 포함합니다. 금, 은, 고광택 플래티넘은 일반적인 피팅 파이프라인에서 발생하는 고스팅이나 색 번짐 현상 없이 정확하게 렌더링됩니다. 최상의 결과를 위해 깨끗한 스튜디오 배경 이미지를 권장합니다.
결과는 어떻게 폴링하나요?+
3~5초마다 GET `/api/v1/tryon/jewelry/:id`를 호출하세요. 의류와 동일한 상태 수명 주기(`processing` → `completed` 또는 `failed`)를 가집니다. 대부분의 작업은 1.5에서 4분 이내에 완료됩니다.
주얼리 · 기능
계정 생성 및 API 키 발급
Photta의 주얼리 가상 피팅 API는 주얼리 사진과 `jewelry_type`(목걸이, 반지, 팔찌, 귀걸이)을 받아 클로즈업된 모델 사진을 반환합니다. `Authorization: Bearer photta_live_xxx`와 함께 `/api/v1/tryon/jewelry`로 POST 요청을 보내고, 3초마다 반환된 ID를 폴링하여 상태가 `completed`가 되면 결과물을 받으세요.