가이드 · 가상 try-on

가상 try-on API란 무엇인가요? 그리고 무엇을 반환하는가

한 줄 요약

가상 try-on API는 의류 사진을 입력받아 모델이 해당 의류를 착용한 이미지를 반환합니다. 마네킹 및 포즈 정보와 함께 사진을 POST하고, 작업 상태를 polling한 후, 결과물을 다운로드합니다.

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

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

핵심 요약

가상 try-on API는 의류를 모델에 렌더링하는 HTTP endpoint입니다. 보유 중인 제품 사진(주로 바닥에 펼쳐 놓은 플랫 샷이나 마네킹 샷)을 전송하면 해당 의류를 착용한 이미지가 반환됩니다. 스튜디오도, 모델 섭외도, 색상 변경에 따른 재촬영도 필요 없습니다.

렌더링 시간은 일반적인 요청 대기 시간보다 길기 때문에 비동기 호출 방식으로 동작합니다. 원하는 모델 및 포즈와 함께 의류를 POST하면, API가 작업을 접수하고 id를 반환하며, 작업이 완료를 보고할 때까지 status endpoint를 폴링합니다. 완성된 이미지는 직접 다운로드하여 저장할 수 있는 URL로 제공됩니다.

주요 사용처는 스튜디오 촬영을 거치지 않는 제품의 착용 이미지가 필요한 카탈로그 팀, 판매자로부터 플랫 샷 사진을 전달받는 마켓플레이스, 그리고 구매자가 브랜드의 단일 피팅 모델 외의 체형에 의류를 대조해 볼 수 있도록 지원하는 앱 등입니다.

해당 작업을 수행하는 endpoint

수기로 작성하지 않고 Photta API 문서에서 직접 불러왔습니다.

한눈에 보기

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

try-on API 검토 시 고려해야 할 사항

  • 전송 데이터

    https URL 또는 base64 데이터 URI 형태의 의류 사진과 원하는 모델 및 포즈입니다. Photta는 이미지당 최대 10 MB의 JPEG, PNG, WebP 형식을 지원합니다.

  • 소요 시간

    단일 웹 요청 내에서 완료할 수 없을 만큼의 시간이 소요됩니다. Photta는 endpoint별 일반적인 완료 시간을 공개하고 있으며, 3초 간격의 폴링을 권장합니다. 웹훅은 제공되지 않습니다.

  • 비용 안내

    Photta는 호출당 credits를 차감합니다. 의류 try-on의 경우 2K 해상도는 5, 4K 해상도는 6 credits이며, 작업 시작 시 차감되고 실패 시 자동으로 환불됩니다.

  • 제한 사항

    키당 분당 600회 요청으로 공개된 rate limit과 플랜별 동시 렌더링 제한이 적용됩니다. 카탈로그 규모의 대량 작업을 실행하기 전에 두 항목을 모두 확인하는 것이 좋습니다.

첫 번째 요청

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

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

가상 try-on API 관련 질문

try-on API는 무엇을 반환하나요?

선택한 모델이 해당 의류를 착용한 이미지이며, 완료된 작업 내 URL로 전달됩니다. 전달용 URL은 영구 호스팅을 지원하지 않으므로 직접 다운로드하여 저장해야 합니다.

모델 사진이 필요한가요?

아니요. Photta가 제공하는 마네킹 카탈로그에서 직접 선택할 수 있으며, 속성을 기반으로 자체 모델을 생성하거나 업로드할 수도 있습니다. 필수 제공 데이터는 의류 사진뿐입니다.

가상 피팅룸과는 어떻게 다른가요?

피팅룸은 구매자를 대면하는 기능입니다. try-on API는 그 이면에서 동작하는 렌더링 단계로, 한 번의 호출로 하나의 이미지를 출력합니다. 이 API를 기반으로 피팅룸을 구축하거나, 순수하게 카탈로그 사진 제작용으로 활용할 수 있습니다.

try-on 호출 비용은 얼마인가요?

Photta 기준 2K 해상도는 5 credits, 4K 해상도는 6 credits입니다. 실패한 작업은 환불되므로 재시도 비용은 재시도 호출 자체에 대해서만 발생합니다.

이미지 한 장당 소요 시간은 얼마나 되나요?

endpoint에 일반적인 완료 시간이 공개되어 있으며, 작업 자체의 상태가 함께 보고됩니다. 소요 시간을 임의로 가정하지 말고 3초 간격으로 폴링하세요.

다음 읽을거리

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

보유한 제품 사진으로 직접 테스트해 보세요

한 번의 요청, 한 번의 폴링, 하나의 이미지.

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