인증

API 키를 생성한 후 전체 비밀 키를 베어러 인증 자격 증명으로 전송하세요. 비밀 키는 한 번만 표시됩니다.

Authorization: Bearer fd_live_xxx

가상 착용 작업 제출

의류 이미지와 모델 이미지를 제출하세요. 성공적인 요청은 HTTP 202 응답과 함께 작업 ID를 반환합니다.

curl -X POST \
  "https://www.fashiondiffusion.ai/api/public/v1/virtual-try-on/tasks" \
  -H "Authorization: Bearer fd_live_xxx" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "garmentImageUrl": "https://cdn.example.com/garment.jpg",
    "modelImageUrl": "https://cdn.example.com/model.jpg",
    "imageCount": 1,
    "resolution": "2K",
    "ratio": "3:4",
    "mode": "FAST",
    "prompt": "Keep the garment shape and fabric texture"
  }'

두 이미지 모두 공개 HTTPS URL이어야 하며, 이미지 콘텐츠 유형을 반환해야 하며, 최대 20MB를 초과할 수 없습니다.

수락된 각 요청은 새 작업을 생성하고 요금이 부과됩니다. 이 버전은 멱등성 보호 기능이 없으므로, 중복 청구가 허용되지 않는 경우 타임아웃된 제출을 자동으로 재시도하지 마세요.

작업 조회

제출 엔드포인트에서 반환된 작업 ID를 사용하세요. API 키는 해당 사용자 및 현재 팀이 소유한 작업만 조회할 수 있습니다.

curl \
  -H "Authorization: Bearer fd_live_xxx" \
  "https://www.fashiondiffusion.ai/api/public/v1/tasks/{taskId}"

작업 상태는 QUEUED, RUNNING, SUCCEEDED, FAILED입니다. 성공 시 출력 이미지 URL이 outputs에 반환됩니다.

작업 목록

현재 사용자가 패션 디퓨전 공개 API를 통해 제출한 가상 착용 작업 목록을 표시합니다. 사용자의 모든 API 키로 제출된 작업이 포함됩니다.

curl \
  -H "Authorization: Bearer fd_live_xxx" \
  "https://www.fashiondiffusion.ai/api/public/v1/tasks?limit=20&createdAfter=2026-08-01T00%3A00%3A00Z"

limit는 1~100까지 허용되며 기본값은 20입니다. 다음 요청에서는 nextCursor를 cursor로 사용하세요. createdAfter는 선택적 ISO 8601 타임스탬프입니다.

오류

오류는 일관된 구조를 사용합니다. 요청 ID는 X-Request-Id 응답 헤더에도 반환됩니다.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "garmentImageUrl: Invalid url",
    "requestId": "request-uuid"
  }
}