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')const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"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."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/apparel",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"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."
},
)
data = res.json()["data"] # data["id"], data["status"]기능 목록
기능별 엔드포인트 안내
API 문서에 명시된 메서드, 경로, credits 및 일반적인 소요 시간입니다. 이 페이지의 수치는 하단에 표시된 날짜 기준으로 공식 문서와 대조 검증되었습니다.
- POST/api/v1/tryon/apparel
가상 Try-On (의류)
바닥에 펼쳐놓은 의류 컷을 원하는 표정과 체형의 AI 마네킹에 착용시킵니다. 4가지 제품 유형, 5가지 화면비 지원.
2K에서 5 크레딧 · 4K에서 6 크레딧1.5–4 min
엔드포인트 보기 - POST/api/v1/tryon/jewelry
주얼리 Try-On
목걸이, 반지, 팔찌, 귀걸이를 주얼리 전용 마네킹에 타이트하게 클로즈업하여 연출합니다 — 반사광과 미세한 표면 디테일까지 완벽히 처리.
2K에서 5 크레딧 · 4K에서 6 크레딧1.5–4 min
엔드포인트 보기 - POST/api/v1/ghost-mannequin
고스트 마네킹
의류 사진에서 마네킹을 제거하고 내부 구조는 그대로 유지합니다. 3D 또는 바닥 컷 마감, 배치 처리에 최적화.
2K에서 4 크레딧 · 4K에서 5 크레딧1.5–4 min
엔드포인트 보기 - POST/api/v1/ghost-mannequin/batch
배치 고스트 마네킹
한 번의 호출로 의류 사진 전체를 일괄 전송하고 단일 배치 ID를 폴링하세요. 각 이미지는 개별적으로 과금되고 추적됩니다.
2K에서 4 크레딧 · 4K에서 5 크레딧1.5–4 min per image
엔드포인트 보기 - POST/api/v1/eyewear-studio
아이웨어 스튜디오
클로즈업 모델 위에 안경과 선글라스를 렌더링하며, 원본 제품 사진의 프레임 형태를 정확하게 유지합니다.
2K에서 5 크레딧 · 4K에서 6 크레딧20–60 sec
엔드포인트 보기 - POST/api/v1/detail-photos
디테일 컷
단 한 장의 제품 사진으로 스티칭, 원단, 하드웨어, 라벨의 클로즈업 컷을 생성합니다. 분석 엔진이 촬영할 영역을 자동으로 제안합니다.
3 크레딧20–60 sec
엔드포인트 보기 - POST/api/v1/mannequins/generate
마네킹 생성
옵션을 조합해 의류 또는 주얼리용 마네킹을 직접 생성한 뒤, 각 try-on 호출에서 해당 마네킹 ID를 재사용하세요.
4 크레딧30-60s
엔드포인트 보기 - POST/api/v1/workflows/{workflow_id}
워크플로우
주얼리 히어로 컷과 같은 프리셋 워크플로우를 단 한 번의 호출로 실행하여 완성된 이미지 세트를 받아보세요.
2K에서 4 크레딧 · 4K에서 5 크레딧20–60 sec / image
엔드포인트 보기
언어
아직 SDK는 제공되지 않으며 — 굳이 필요하지도 않습니다.
현재 Photta 문서에서 권장하는 방식과 정확히 일치하는, 바로 복사해 쓸 수 있는 세 가지 가이드입니다.
빠른 시작
회원가입부터 첫 이미지 생성까지 5분이면 충분합니다.
모든 기능은 동일한 패턴을 따릅니다: 인증, 요청 제출, 폴링. 한 번만 익히면 끝납니다.
단계 1: ai.photta.app에서 가입하고 개발자 대시보드에서 라이브 API 키를 생성하세요.
단계 2: Authorization 헤더에 키를 포함해 작업을 POST하세요 — API가 즉시 generation ID를 반환합니다.
단계 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까지 문서화되어 있습니다.
레퍼런스
두 번 이상 다시 찾아보게 될 공식 문서의 핵심 내용입니다.
레퍼런스
5분 안에 첫 번째 Photta 이미지를 생성하세요.
회원가입, API 키 생성, 첫 cURL 호출 실행, 완료될 때까지 폴링, 결과 저장까지. 엔드투엔드로 문서화된 5단계 가이드입니다.
읽기레퍼런스
Photta API 인증
Photta API 인증 방법: Authorization 헤더, 키 접두사, 키 생성 위치, 안전한 교체(rotate) 방법.
읽기레퍼런스
Photta API 가격 정책
2K 및 4K에서 각 Photta API endpoint에 소요되는 크레딧 비용, 과금 및 환불 방식, 그리고 무료 endpoint 목록입니다. 이미지당 별도의 현금 가격은 없습니다.
읽기레퍼런스
Photta API rate limits
Photta API rate limit, 윈도우, Retry-After 헤더, polling 주기, 플랜별 동시성 상한선 등 API 문서에 명시된 모든 내용입니다.
읽기레퍼런스
Photta API 오류
Photta API의 전체 오류 유형 목록과 상태 코드, 오류 본문 포맷, 그리고 재시도할 가치가 있는 오류에 대한 안내입니다.
읽기레퍼런스
Photta API 리소스 엔드포인트
마네킹, 포즈, 배경, 신발, 브랜드 라벨을 조회하고, 직접 업로드하며, 크레딧 잔액을 확인하세요. 모든 생성 작업의 기반이 되는 조회 기능입니다.
읽기가이드
가상 try-on API란 무엇인가요?
가상 try-on API는 단 한 장의 제품 사진으로 모델이 착용한 의류 이미지를 렌더링합니다. 입력값, 반환값, 비용 및 실행 소요 시간을 정리했습니다.
읽기가이드
고스트 마네킹 API란 무엇인가요?
고스트 마네킹 API는 의류 사진에서 마네킹을 제거하고 내부를 재구성합니다. 입력 요구 사항, 반환 결과 및 비용을 확인해 보세요.
읽기가이드
FASHN에서 Photta로 마이그레이션하기
가상 try-on 연동을 FASHN에서 Photta로 전환할 때 변경되는 사항: 인증 방식, request body, 폴링, credits 청구 방식.
읽기빌드
Photta API로 구축하기
Photta API를 위한 8가지 엔드투엔드 레시피: try-on 앱, Shopify 앱, WooCommerce 플러그인, Django 워커, 대량 카탈로그 처리, 노코드 자동화.
읽기비교
최고의 가상 try-on API
5개 가상 try-on API(Photta, FASHN, FitRoom, Pixazo, Ayna)의 동작 방식. 각 서비스의 공개 정보, 미공개 정보 및 세부 문서 확인 위치를 정리했습니다.
읽기
이 페이지의 모든 수치는 다음 출처를 기반으로 합니다: Photta API 문서 · 확인 완료
5분 만에 API 체험하기
Photta API 키를 발급받고 위 cURL 스니펫을 붙여넣기만 하면, 커피가 다 내려지기도 전에 첫 번째 모델 착용 컷을 받아볼 수 있습니다.
- 8개 기능
- 600 requests/min
- Bearer 키
- 비동기, 폴링