가상 카메라를 회전하여 모든 패션 이미지의 새로운 시야각을 생성합니다.

각도 생성

각도 생성 엔드포인트는 기존 이미지를 가져와 가상 카메라의 위치를 재조정하여 모델, 의류, 질감 및 조명을 보존하면서 새로운 시야각(예: 정면, 후면, 측면 프로필)을 생성할 수 있도록 합니다.

모델 이름: angle-generation

수명 주기: stable

처리 시간: ~10초–20초

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

전달 방식: URL, Base64 (미리보기)

크레딧: 생성된 각도당 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": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

응답

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

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

요청 매개변수

필수 매개변수

imageUrlRequiredstring

회전할 원본 이미지입니다. 공개적으로 접근 가능한 URL 또는 Base64로 인코딩된 이미지 문자열일 수 있습니다.

전문가 팁: 정면 사진은 가장 일관된 다각도 결과를 생성합니다. 비스듬하거나 측면을 향하는 원본 이미지는 피하세요. 정면 뷰는 AI가 작업할 수 있는 가장 많은 정보를 제공하는 반면, 비스듬한 샷은 AI가 누락된 구조적 세부 사항을 환각하게 만듭니다.

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

angleIdsRequiredarray of strings

생성하려는 각도 식별자 배열입니다. 사용 가능한 옵션은 다음과 같습니다:

"front": 정면 뷰
"back": 후면 뷰
"leftSide": 왼쪽 측면 (90°)
"rightSide": 오른쪽 측면 (90°)
"left45": 왼쪽 45°
"right45": 오른쪽 45°

선택적 매개변수

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

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

ratiostring

종횡비 재정의 (예: 16:9, 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 등급에 따라 달라집니다.

공식: 비용 = 품질 크레딧 × 각도 수

Quality Tier	Credits Per Angle
1k (기본값)	1
2k	3
4k	5

예시: 1k 품질로 ["back", "leftSide", "rightSide"]를 요청하면 총 3크레딧이 소요됩니다. 동일한 3개 각도를 4k 품질로 요청하면 총 15크레딧이 소요됩니다.