레퍼런스 · 리소스

Photta API 리소스 엔드포인트 모든 생성 작업에 필요한 ID 목록

한 줄 요약

리소스 엔드포인트는 마네킹, 포즈, 배경, 신발, 의류 속성, 브랜드 라벨 등 생성 호출에 필요한 ID와 계정 잔액 및 사용량을 반환합니다. 목록 조회에는 비용이 들지 않습니다.

API 키 발급받기 문서 보기

리소스 엔드포인트: 13개 리소스 엔드포인트
인증: Bearer 키
제한 사항: 600 requests/min

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

각 리소스 엔드포인트와 조회 호출 방법

각 섹션은 해당 ID를 사용하는 기능을 연결합니다.

GET/api/v1/mannequins

마네킹

의류 try-on에 사용할 수 있는 모델 목록을 반환합니다: Photta 시스템 마네킹, 직접 업로드한 마네킹, 마네킹 생성 API로 제작한 마네킹이 포함됩니다. 커스텀 마네킹을 업로드하려면 동일한 경로로 POST 요청을 보내세요. 업로드된 마네킹은 계정 내에서 비공개로 유지됩니다. 반환된 ID는 try-on 호출 시 `mannequin_id`에 입력합니다.

curl https://api.photta.app/api/v1/mannequins \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/mannequins", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/mannequins",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

가상 착용(Virtual try-on) API

POST/api/v1/mannequins/jewelry

주얼리 마네킹

주얼리 try-on용 클로즈업 모델 사진을 업로드합니다. 주얼리 작업은 넥라인, 귀, 손목, 손 등을 중심으로 프레임이 잡히므로 전신 의류용 세트 대신 별도의 주얼리 전용 마네킹 세트를 사용합니다.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/mannequins/jewelry \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
  "jewelry_type": "necklace",
  "gender": "female",
  "name": "Emma"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/mannequins/jewelry", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
    "jewelry_type": "necklace",
    "gender": "female",
    "name": "Emma"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/mannequins/jewelry",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
      "jewelry_type": "necklace",
      "gender": "female",
      "name": "Emma"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

주얼리 try-on API

GET/api/v1/poses

포즈

try-on 시 요청할 수 있는 포즈 목록을 반환하며, 카테고리 및 적합한 제품 유형별로 필터링할 수 있습니다. ID를 `pose_id`로 전달하세요. 생략하면 API가 의류에 어울리는 포즈를 자동으로 선택합니다.

curl https://api.photta.app/api/v1/poses \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/poses", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/poses",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

가상 착용(Virtual try-on) API

GET/api/v1/garment-attributes

의류 기장 및 핏

의류 try-on에서 지원하는 기장 및 핏 키 목록을 반환합니다. 카탈로그 전체에서 동일한 셔츠가 일관되게 렌더링되도록 자유 형식 텍스트 설명 대신 키를 전달하세요.

curl https://api.photta.app/api/v1/garment-attributes \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/garment-attributes", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/garment-attributes",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

가상 착용(Virtual try-on) API

GET/api/v1/backgrounds

배경

의류 try-on에 사용할 수 있는 시스템 배경 및 직접 업로드한 배경 목록을 커서 페이지네이션과 함께 반환합니다. 커스텀 배경을 업로드하려면 동일한 경로로 POST 요청을 보내세요. 계정 내에서 비공개로 유지됩니다.

curl https://api.photta.app/api/v1/backgrounds \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/backgrounds", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/backgrounds",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

아이웨어 가상 try-on API

POST/api/v1/brand-labels

브랜드 라벨

고스트 마네킹 작업에 재사용할 라벨 이미지를 업로드하고, 단일 작업 및 배치 작업에서 `brand_label_id`로 전달할 ID를 반환합니다. GET 요청으로 저장된 항목을 조회하고, 계정 한도에 도달하면 DELETE 요청으로 삭제할 수 있습니다.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/brand-labels \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "file": "@/path/to/pribrand-label.png",
  "name": "Pribrand Collar Label"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/brand-labels", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "file": "@/path/to/pribrand-label.png",
    "name": "Pribrand Collar Label"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/brand-labels",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "file": "@/path/to/pribrand-label.png",
      "name": "Pribrand Collar Label"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

고스트 마네킹 API

GET/api/v1/footwear

신발

의류 try-on을 위한 신발 옵션 목록을 반환하며, 유형 및 성별로 필터링할 수 있고 커서 페이지네이션을 지원합니다. 의류를 착용한 동일한 모델에게 신발을 매칭할 때 사용하세요.

curl https://api.photta.app/api/v1/footwear \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/footwear", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/footwear",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

가상 착용(Virtual try-on) API

GET/api/v1/account

계정

소스별로 세분화된 크레딧 잔액, 현재 플랜, 다음 크레딧 갱신 시점을 반환합니다. 402 에러로 잔액 부족을 확인하기보다 대량 배치 실행 전에 먼저 조회하세요.

curl https://api.photta.app/api/v1/account \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Workflows API

GET/api/v1/account/usage

사용량

현재 달력 월 청구 기간 동안의 생성 횟수와 크레딧 사용량을 성공 및 실패 작업별로 나누어 제공합니다. 요청 수를 자체적으로 집계하는 대신 이 엔드포인트를 사용해 그래프를 구성하세요.

curl https://api.photta.app/api/v1/account/usage \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account/usage", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account/usage",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

배치 고스트 마네킹 API

리소스 엔드포인트 관련 자주 묻는 질문

리소스 엔드포인트는 어떤 용도로 사용되나요?

마네킹, 포즈, 배경, 브랜드 라벨 등 생성 호출에 필요한 ID와 계정 상태를 반환합니다. 이 그룹의 어떤 엔드포인트도 이미지를 직접 생성하지 않습니다.

리소스 호출 시 크레딧이 차감되나요?

아닙니다. 목록 조회는 무료이며, 이 그룹에 속한 업로드(커스텀 마네킹, 배경, 브랜드 라벨) 역시 무료입니다. 이미지 생성에 대해서만 비용을 지불합니다.

긴 목록의 페이지네이션은 어떻게 처리하나요?

목록 엔드포인트는 limit과 cursor를 사용합니다. 마지막으로 확인한 ID를 `starting_after`로 전달하여 다음 페이지를 조회하세요. 매 요청마다 다시 조회하지 말고 응답 결과를 캐시해 두는 것을 권장합니다.

직접 보유한 마네킹과 배경을 업로드할 수 있나요?

네. POST `/api/v1/mannequins`, POST `/api/v1/mannequins/jewelry`, POST `/api/v1/backgrounds`, POST `/api/v1/brand-labels` 모두 자체 이미지 업로드를 지원하며, 업로드된 모든 데이터는 계정 내에서 비공개로 안전하게 유지됩니다.

이 ID들이 사용되는 위치

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

5분 만에 API 체험하기

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

계정 생성 후 API 키 발급받기 API

13개 리소스 엔드포인트
Bearer 키
600 requests/min