참조 이미지 또는 설명 텍스트 프롬프트를 사용하여 패션 모델을 정확한 자세로 재배치합니다.

포즈 제어

포즈 제어 엔드포인트를 사용하면 모델의 기존 이미지를 가져와 모델이 다른 신체 포즈를 취하는 새로운 변형을 생성할 수 있습니다. AI는 모델의 얼굴 특징, 의류 및 배경을 세심하게 보존합니다.

모델 이름: pose-control

수명 주기: stable

처리 시간: ~15초–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": "pose-control",
           "inputs": {
             "modelImage": "https://example.com/model-standing.jpg",
             "quality": "2k",
             "poses": [
               {
                 "type": "template",
                 "cdnUrl": "https://example.com/pose-reference.jpg",
                 "title": "Hands on hips"
               },
               {
                 "type": "custom",
                 "text": "Sitting on a chair with legs crossed"
               }
             ]
           }
         }'

응답

생성에는 최대 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 배열이 포함됩니다. 이미지는 초기 요청에 제공된 poses 배열과 정확히 동일한 순서로 반환됩니다.

{
  "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/fititon-pose-123-0.png",
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-1.png"
  ]
}

요청 매개변수

필수 매개변수

modelImageRequiredstring

포즈를 변경하려는 인물의 원본 이미지입니다. 공개적으로 접근 가능한 URL 또는 Base64로 인코딩된 이미지 문자열일 수 있습니다.

전문가 팁: 머리부터 발끝까지 전신 사진이 가장 좋은 결과를 제공합니다. AI가 포즈를 제대로 변경하려면 전신을 봐야 합니다. 몸에 꼭 맞는 옷은 부피가 크거나 여러 겹의 옷보다 신체 구조를 더 잘 보여줍니다. 단순하고 깔끔한 배경은 AI가 신체 형태에 깨끗하게 집중할 수 있도록 합니다.

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

posesRequiredarray of objects

생성하려는 포즈를 정의하는 배열입니다. 동일한 요청에서 템플릿 포즈와 사용자 지정 포즈를 혼합하여 사용할 수 있습니다.

템플릿 포즈: 이미지를 구조적 참조로 사용합니다. 참조 포즈로 사용할 유효한 이미지 URL을 제공하거나, 아래에 나열된 공식 지원 템플릿 중 하나를 사용할 수 있습니다.
- type (문자열): "template"이어야 합니다.
- cdnUrl (문자열): 원하는 포즈를 보여주는 참조 이미지의 URL입니다.
- title (문자열, 선택 사항): 설명 레이블입니다.
사용자 지정 포즈: 텍스트 프롬프트를 사용하여 포즈를 정의합니다.
- type (문자열): "custom"이어야 합니다.
- text (문자열): 새로운 포즈를 설명하는 텍스트입니다(예: "팔짱을 끼고 서 있는").

공식 포즈 템플릿

cdnUrl을 통해 자체 참조 이미지를 제공할 수 있지만, 우리는 고도로 최적화된 포즈 템플릿의 엄선된 디렉토리를 제공합니다. 아래 URL을 클릭하여 포즈를 미리 볼 수 있습니다.

Female Poses

Title	Template URL (`cdnUrl`)

Male Poses

Title	Template URL (`cdnUrl`)

선택적 매개변수

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

출력 해상도 등급입니다. 기본값: 1k

ratiostring

생성된 이미지의 너비-높이 비율을 정의합니다. 비어 있는 경우 시스템은 원본 이미지의 종횡비를 기본값으로 사용합니다.

지원되는 값: '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 등급에 따라 달라집니다.

공식: 비용 = 품질 크레딧 × 포즈 수

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

예시: 1k 품질로 3개의 포즈 배열을 요청하면 총 3크레딧이 소요됩니다. 동일한 3개의 포즈를 4k 품질로 요청하면 총 15크레딧이 소요됩니다.