텍스트를 사용하여 새로운 의상을 설명하고 AI 패션 모델에 자연스럽게 입혀보세요.

프롬프트 착용

프롬프트 착용 엔드포인트는 텍스트를 사용하여 새로운 의상을 설명하고 AI 패션 모델에 자연스럽게 입힐 수 있도록 합니다.

모델 이름: prompt-tryon

수명 주기: stable

처리 시간: ~15s–40s (스타일 또는 모델 참조를 사용할 때 증가)

출력 형식: Auto (JPEG or PNG)

전달 방식: URL

크레딧: 1 to 5 per generation (품질에 따라 다름)

요청

착용 구성은 범용 /v1/run 엔드포인트로 제출하세요:

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

요청 예시

인증 API 키는 Bearer 토큰(Authorization: Bearer YOUR_API_KEY) 또는 x-api-key 헤더(x-api-key: YOUR_API_KEY)를 통해 전달할 수 있습니다.

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "prompt-tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "prompt": "A stylish red summer dress with floral patterns.",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "16:9",
             "modelImageUrl": "https://example.com/model-reference.jpg",
             "styleId": "movie"
           }
         }'

응답

착용 생성은 백그라운드에서 비동기적으로 이루어집니다. 요청은 추적 객체와 함께 즉시 200 OK 상태를 반환합니다.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

결과 폴링 생성된 이미지 URL을 검색하려면 반환된 id를 사용하여 상태 엔드포인트(GET https://fititon.app/api/v1/status/{id})를 폴링해야 합니다. 자세한 지침은 API 설정 가이드를 참조하세요.

생성이 완료되면 폴링 엔드포인트는 최종 이미지 URL을 포함하는 다음 output 배열과 함께 status: "success"를 반환합니다:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://pub-r2.com/.../result-0.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00Z",
  "updated_at": "2026-07-17T11:00:45Z"
}

요청 매개변수

필수 매개변수

personImageRequiredstring

의상을 입히고 싶은 모델의 기본 이미지입니다. 공개적으로 접근 가능한 URL 또는 Base64로 인코딩된 이미지 문자열일 수 있습니다. 지원되는 형식: JPEG, PNG, WEBP. 최대 크기: 25MB.

전문가 팁: 팔이 보이는 정면 포즈는 가장 사실적인 드레이핑을 생성합니다.

형식 요구 사항 Base64 문자열을 제출할 때는 표준 데이터 URI 접두사(예: data:image/jpeg;base64,...)를 포함해야 합니다. /v1/run 엔드포인트는 JSON 페이로드만 허용합니다.

promptRequiredstring

모델이 입을 의상에 대한 텍스트 설명입니다.

전문가 팁: 최상의 결과를 위해 원단 유형(실크, 면, 데님)과 핏 스타일(슬림, 오버사이즈)을 포함하세요. 색상을 정확하게 지정하고("네이비 블루"가 "블루"보다 좋습니다) AI가 무엇을 변경해야 하는지 정확히 알 수 있도록 모델이 이미 입고 있는 것을 명시적으로 참조하세요.

선택적 매개변수

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

프롬프트 착용(Gemini 모델)의 출력 해상도 등급입니다. 해상도가 높을수록 더 많은 크레딧을 소모합니다. 기본값: 1k

sampleCountinteger

요청당 생성할 이미지 변형의 수입니다. 1에서 4 사이여야 합니다. 추가 이미지는 더 많은 크레딧을 소모하고 처리 시간을 선형적으로 증가시킵니다. 기본값: 1

ratiostring

생성된 이미지의 가로-세로 비율을 정의합니다. 비어 있으면 시스템은 personImage의 가로-세로 비율을 기본값으로 사용합니다.

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

modelImageUrlstring

선택 사항입니다. 원본 인물의 특징을 보존하는 대신 사용할 인간 참조 모델의 URL입니다.

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

styleIdstring

선택 사항입니다. 출력 이미지에 특정 사진 스타일을 적용합니다.

사용 가능한 스타일:

Style Name	Style ID (`styleId`)

유효한 값: y2k, studio, iphone, professional, lifestyle, analog, streetwear, flash, movie, minimalist, ugc, editorial.

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

런타임 오류

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

크레딧 비용

비용은 선택한 quality 등급에 따라 달라지며 sampleCount에 의해 곱해집니다.

공식: Cost = QualityCredits × sampleCount

매개변수	이미지당 크레딧
`quality="1k"`	1
`quality="2k"`	3
`quality="4k"`	5