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": ["..."],
    "mannequin_id": "mnq_athena_ts",
    "pose_id": "pose_standing_front",
    "resolution": "2K"
  }'

질문

가입 전 개발자들이 자주 묻는 질문

Photta API란 무엇인가요?+

Photta API는 제품 사진을 전문적인 패션 사진으로 변환해주는 크레딧 기반 REST 서비스입니다. Photta의 소비자용 앱에 사용되는 것과 동일한 파이프라인(가상 의류 피팅, 주얼리 피팅, 고스트 마네킹 추출)을 세 개의 엔드포인트로 노출하여 개발자가 직접 툴을 구축할 수 있게 합니다.

API 키는 어떻게 받나요?+

ai.photta.app에 가입한 후 대시보드의 개발자(Developers) 섹션에서 'API 키 생성'을 클릭하세요. 라이브 키는 `photta_live_`로 시작하며 뒤에 32자리의 16진수가 붙습니다. 환경 변수에 안전하게 보관하세요. 절대 소스 제어 시스템에 커밋하거나 브라우저에 노출해서는 안 됩니다.

무료 티어가 있나요?+

새 계정에는 모든 기능을 테스트해볼 수 있는 체험용 크레딧이 제공됩니다. 서비스 배포 준비가 되면 월간 크레딧 잔액이 더 많고 rate limits가 더 높은 요금제(Starter 30/min, Pro 60/min)를 구독하세요. 호출당 최소 수량 제한은 없으며, 사용하지 않은 크레딧은 해당 결제 기간 내에 소멸되지 않습니다.

생성 속도는 얼마나 빠른가요?+

가상 피팅 작업은 일반적으로 1.5에서 4분 이내에 완료됩니다. 고스트 마네킹은 더 빨라서 보통 1에서 3분 정도 소요됩니다. 모든 엔드포인트는 비동기식입니다. POST 요청은 1초 미만으로 생성 ID를 반환하며, 작업이 완료될 때까지 3~5초마다 폴링하면 됩니다. 장시간 유지해야 하는 HTTP 연결은 필요 없습니다.

공식 Photta SDK가 있나요?+

아직은 없습니다. 문서 로드맵에 따르면 API 활성 고객이 10명을 넘으면 Python SDK를, 20명을 넘으면 Node.js SDK를 출시할 계획입니다. 그때까지는 cURL, Node 기본 fetch 또는 Python requests 라이브러리를 통한 REST 통신 방식을 지원하며, 이 사이트에서 해당 방법들을 상세히 안내하고 있습니다.

Photta API

5분 만에 API 테스트하기

Photta API 키를 생성하고 위 cURL 스니펫을 붙여넣으세요. 커피가 다 내려지기도 전에 첫 번째 모델 착용 이미지를 얻을 수 있습니다.

API 키 발급 →문서 읽기