Logo

제품을 모델로

플랫 레이 또는 고스트 마네킹 제품 사진을 전문적인 모델 착용 사진으로 변환합니다.

제품을 모델로

제품을 모델로 엔드포인트는 플랫 레이 또는 고스트 마네킹 제품 사진을 전문적인 모델 착용 사진으로 변환하며, 모델의 외모나 사진 스타일을 지정할 수 있습니다.

모델 이름: product-to-model

수명 주기: stable

처리 시간: ~10초–30초 (스타일 또는 모델 참조 사용 시 증가)

출력 형식: 자동 (JPEG 또는 PNG)

전달 방법: URL

크레딧: 생성당 1~5개 (품질에 따라 다름)

요청

제품 이미지를 범용 /v1/run 엔드포인트로 제출합니다.

POSThttps://fititon.app/api/v1/run

요청 예시

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "product-to-model",
           "inputs": {
             "productImage": "https://example.com/ghost-mannequin-shirt.jpg",
             "styleId": "editorial",
             "customPrompt": "Asian female model, outdoor city street, natural lighting",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "3:4"
           }
         }'

응답

이미지 생성에는 최대 20초가 소요될 수 있으므로, /v1/run 엔드포인트는 비동기 작업 id와 함께 201 Created 상태를 즉시 반환합니다. 최종 결과를 검색하려면 GET /v1/status/{id}를 사용하여 상태 API를 폴링해야 합니다. 또는 웹훅을 구성하여 알림을 자동으로 받을 수 있습니다. 당사의 웹훅 디스패처는 엄격한 15초 타임아웃을 적용합니다. 서버는 15초 이내에 2xx 상태 코드로 웹훅을 승인해야 하며, 그렇지 않으면 실패로 간주되어 나중에 재시도됩니다.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

status가 "succeeded"로 변경되면 output 필드에는 생성된 이미지를 가리키는 URL이 포함된 배열이 포함됩니다.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/product-model-123.png"
  ]
}

요청 매개변수

필수 매개변수

productImageRequiredstring

모델에 입힐 제품 이미지 (플랫 레이 또는 고스트 마네킹). 공개적으로 접근 가능한 URL 또는 Base64 인코딩된 이미지 문자열일 수 있습니다. 최대 크기: 25MB.

전문가 팁: 흰색 배경의 플랫 레이 사진은 가장 일관된 모델 착용 결과를 생성합니다. 마네킹 사진도 잘 작동합니다. 촬영 전에 의류의 일부가 아닌 태그, 가격표 또는 액세서리를 제거하십시오. 전체 의류가 보이고 펼쳐져 있는지 확인하십시오. 소매가 잘리지 않도록 하십시오.

형식 요구 사항 Base64 문자열을 제출할 때 표준 데이터 URI 접두사(예: data:image/jpeg;base64,...)를 포함해야 합니다.

선택적 매개변수

customPromptstring

원하는 모델(예: 성별, 민족, 포즈) 또는 장면을 설명하는 텍스트 지침입니다. 최대 길이: 500자.

modelImageUrlstring

생성에 사용할 인간 참조 모델의 URL입니다. 생략하면 무작위의 다양한 모델이 생성됩니다.

사용 가능한 사전 설정 모델:

참고: 참조 모델을 제공하면 전체 처리 시간이 증가합니다.

styleIdstring

적용할 사진 스타일 ID(예: "studio", "iphone", "editorial")입니다. 생략하면 중립적인 스튜디오 프레젠테이션이 기본값으로 적용됩니다.

사용 가능한 스타일:

Style NameStyle ID (`styleId`)

참고: 복잡한 스타일은 생성 시간을 증가시킬 수 있습니다.

quality'1k' | '2k' | '4k'

출력 해상도 계층입니다. 1k는 약 1메가픽셀 출력을, 2k는 약 4메가픽셀을, 4k는 약 16메가픽셀을 생성합니다. 기본값: 1k

sampleCountinteger

요청당 생성할 이미지 변형의 수입니다. 1에서 4 사이여야 합니다. 기본값: 1

ratiostring

생성된 이미지의 너비-높이 비율을 정의합니다. 비어 있으면 시스템은 패션 사진의 경우 3:4를 기본값으로 사용합니다.

지원되는 값: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

런타임 오류

이 기능의 런타임 오류는 오류 처리에 문서화된 공유 세트를 사용합니다. 처리 중에 오류가 발생하면 status가 "error"로 업데이트되고 error 필드에 특정 실패 이유가 포함됩니다.

크레딧 비용

개발자 API 요청의 경우 비용은 선택한 출력 quality 계층에 sampleCount를 곱한 값에 따라 달라집니다.

공식: 비용 = QualityCredits × sampleCount

품질 계층이미지당 크레딧
1k (기본값)1
2k3
4k5