Photta API

Photta API REST 기반 가상 착용(try-on), 고스트 마네킹 및 제품 사진 생성

한 줄 요약

Photta API는 크레딧 기반 REST API입니다. 기능 엔드포인트로 제품 사진을 POST하고, 몇 초마다 statusEndpoint를 폴링한 뒤, 완성된 이미지를 다운로드하세요. 8가지 기능, 단 하나의 키, 단 하나의 크레딧 잔액으로 이용할 수 있습니다.

  • 기능 목록: 8개 기능
  • Rate limit: 600 requests/min
  • 인증: Bearer 키
  • 패턴: 비동기, 폴링

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

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')

기능 목록

기능별 엔드포인트 안내

API 문서에 명시된 메서드, 경로, credits 및 일반적인 소요 시간입니다. 이 페이지의 수치는 하단에 표시된 날짜 기준으로 공식 문서와 대조 검증되었습니다.

빠른 시작

회원가입부터 첫 이미지 생성까지 5분이면 충분합니다.

모든 기능은 동일한 패턴을 따릅니다: 인증, 요청 제출, 폴링. 한 번만 익히면 끝납니다.

  1. 단계 1: ai.photta.app에서 가입하고 개발자 대시보드에서 라이브 API 키를 생성하세요.

  2. 단계 2: Authorization 헤더에 키를 포함해 작업을 POST하세요 — API가 즉시 generation ID를 반환합니다.

  3. 단계 3: status가 completed로 바뀔 때까지 동일한 엔드포인트를 3초마다 폴링한 다음, 결과 URL을 다운로드하세요.

빠른 시작

질문과 답변

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

Photta API란 무엇인가요?

Photta API는 제품 사진으로 전문적인 패션 화보를 생성해 주는 크레딧 기반 REST 서비스입니다. 가상 의류 착용(try-on), 주얼리 착용, 고스트 마네킹 추출 등 Photta의 소비자용 앱을 구동하는 파이프라인과 동일하며, 개발자가 자체 툴을 구축할 수 있도록 8가지 기능으로 제공됩니다.

API 키는 어떻게 발급받나요?

ai.photta.app에서 가입한 후 대시보드의 개발자 섹션으로 이동하여 Generate API key를 클릭하세요. 라이브 키는 `photta_live_`로 시작하며 32자리의 16진수 문자가 뒤따릅니다. 키는 반드시 환경 변수로 관리하세요 — 소스 코드에 커밋하거나 브라우저에 그대로 노출해서는 안 됩니다.

무료 티어가 있나요?

신규 계정에는 모든 기능에 사용할 수 있는 체험용 credits가 지급됩니다. 실제 배포 단계에 이르면 월간 크레딧 한도가 더 높은 플랜을 구독하세요. rate limit은 모든 플랜에서 API 키당 분당 600건으로 동일합니다. 호출당 최소 요청 수 제한은 없습니다.

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

Try-on 및 고스트 마네킹 작업은 일반적으로 1.5분에서 4분 이내에 완료됩니다. 아이웨어 컷, 디테일 컷, 워크플로 이미지는 20~60초, 마네킹 생성은 30~60초가 소요됩니다. 모든 생성 엔드포인트는 비동기식으로 동작합니다. POST 요청 즉시 generation ID가 반환되며, 작업이 완료될 때까지 3~5초 간격으로 폴링하면 됩니다. 오래 유지되는 HTTP 연결을 따로 관리할 필요가 없습니다.

공식 Photta SDK가 있나요?

아직 없습니다. 공식 지원하는 연동 방식은 cURL, Node의 네이티브 fetch, Python의 requests 라이브러리를 통한 순수 REST API 호출입니다 — 세 가지 방식 모두 본 사이트에서 모든 기능에 대해 A부터 Z까지 문서화되어 있습니다.

레퍼런스

두 번 이상 다시 찾아보게 될 공식 문서의 핵심 내용입니다.

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

5분 만에 API 체험하기

Photta API 키를 발급받고 위 cURL 스니펫을 붙여넣기만 하면, 커피가 다 내려지기도 전에 첫 번째 모델 착용 컷을 받아볼 수 있습니다.

  • 8개 기능
  • 600 requests/min
  • Bearer 키
  • 비동기, 폴링