완전히 독특한 AI 패션 모델을 생성하거나, 가상 착용에 사용할 사용자 지정 참조 이미지를 업로드하세요.

모델 생성

모델 생성 기능을 사용하면 간단하고 직관적인 프롬프트나 참조 이미지를 사용하여 사실적인 패션 모델을 생성하거나, 기존 모델 이미지를 작업 공간에 업로드할 수 있습니다.

모델 이름: model-create

수명 주기: stable

처리 시간: ~10초–30초 (얼굴/포즈와 같은 고급 참조 사용 시 증가)

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

전달 방식: URL

크레딧: 모델당 1~5개 (1k: 1, 2k: 3, 4k: 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": "model-create",
           "inputs": {
             "type": "generate",
             "name": "Summer Collection Model",
             "prompt": "Full body shot, woman wearing a white t-shirt and dark blue biker shorts, studio lighting",
             "gender": "female",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

응답

모델 생성에는 최대 30초가 소요될 수 있으므로, /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/model-123.png"
  ]
}

요청 매개변수

필수 매개변수

typeRequired'generate' | 'upload'

AI를 통해 새 모델을 생성할지(generate) 또는 기존 이미지를 업로드할지(upload) 지정합니다.

nameRequiredstring

모델에 대한 설명적인 이름입니다. 이는 스튜디오에서 모델을 식별하는 데 사용됩니다.

promptstring

생성 시 필수 생성할 모델에 대한 텍스트 설명입니다. 원하는 패션 모델, 의류, 포즈 및 배경 장면을 설명합니다.

전문가 팁: faceModelId와 같은 참조를 사용하는 경우, AI는 참조의 정체성을 우선시하지만, 프롬프트를 사용하여 설정, 의상 및 신체 특성을 결정합니다. faceModelId가 제공된 경우에만 선택 사항입니다.

imageBase64string

업로드 시 필수 Base64로 인코딩된 이미지 문자열입니다. type이 upload로 설정된 경우 필수입니다.

형식 요구 사항 Base64 문자열에는 표준 데이터 URI 접두사(예: data:image/jpeg;base64,... 또는 data:image/png;base64,...)가 포함되어야 합니다. 원시 인코딩된 문자열만 제공되면 업로드가 실패합니다.

선택적 생성 매개변수

type이 generate로 설정된 경우 이 매개변수들이 적용됩니다.

genderstring

모델의 성별입니다. 생성 모델이 신체 속성을 결정하는 데 도움이 됩니다.

bodyTypestring

모델의 체형(예: "운동선수형", "빅 사이즈", "슬림형")입니다.

clothingstring

생성 중에 적용할 특정 의류 세부 정보로, 주요 prompt를 보강합니다.

posestring

포즈에 대한 텍스트 설명(예: "주머니에 손을 넣고 서 있는", "걷는")입니다.

faceModelIdstring

여러 생성 과정에서 특정 정체성을 고정하기 위한 기존 얼굴 모델의 UUID입니다. 출력은 참조 얼굴을 보존하면서 대상 프롬프트에 맞춰 조정됩니다.

참고: 얼굴 참조를 제공하면 AI가 정체성을 정렬하는 데 총 처리 시간이 몇 초 추가됩니다.

poseModelIdstring

기존 포즈 모델의 UUID입니다. 생성 시 신체 포즈와 자세에 대해 참조와 엄격하게 일치하도록 강제합니다.

참고: 포즈 참조를 제공하면 처리 시간이 증가합니다.

poseImageBase64string

저장된 poseModelId를 제공하는 대신 임시 포즈 참조로 사용할 Base64로 인코딩된 이미지 문자열입니다.

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

출력 해상도 등급입니다. 1k는 약 1메가픽셀 출력을, 2k는 약 4메가픽셀을, 4k는 약 16메가픽셀을 생성합니다. 해상도가 높을수록 더 많은 크레딧을 소모합니다. 기본값: 1k

aspectRatiostring

생성된 이미지의 가로-세로 비율을 정의합니다.

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

기본값: 3:4

sampleCountinteger

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

런타임 오류

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

크레딧 비용

개발자 API 요청의 경우, 비용은 선택한 출력 quality 등급에 따라 달라집니다.

품질 등급	모델당 크레딧
1k (기본값)	1
2k	3
4k	5