Logo

배경 교체

피사체를 분리하고 완전히 새롭고 사실적인 배경을 생성합니다.

배경 교체

배경 교체 엔드포인트는 이미지에서 피사체를 분리하고 텍스트 프롬프트를 기반으로 완전히 새롭고 사실적인 배경을 생성할 수 있도록 합니다.

모델 이름: background-replace

수명 주기: stable

처리 시간: ~5s–15s

출력 형식: Auto (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": "background-replace",
           "inputs": {
             "subjectImage": "https://example.com/product.jpg",
             "scenePrompt": "Product sitting on a sandy beach during golden hour",
             "quality": "2k"
           }
         }'

응답

초기 추적 객체와 함께 201 Created 상태를 반환합니다. 생성은 비동기적으로 실행됩니다.

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

status가 "succeeded"로 변경되면 (GET 엔드포인트 폴링을 통해), 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/bg-replace-123.png"
  ]
}

요청 매개변수

필수 매개변수

subjectImageRequiredstring

분리하려는 피사체가 포함된 이미지입니다. 공개적으로 접근 가능한 URL 또는 Base64로 인코딩된 이미지 문자열일 수 있습니다. 최대 크기: 25MB.

전문가 팁: 대비되는 배경에 대해 선명하고 날카로운 가장자리를 가진 피사체는 가장 깔끔한 잘라내기를 얻습니다. 피사체가 배경과 섞이는 이미지(예: 흰색 벽에 흰색 셔츠)는 피하세요. 고대비 조명은 AI가 가장자리 감지에 의존하여 피사체를 완벽하게 분리하는 데 도움이 됩니다.

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

scenePromptRequiredstring

피사체 뒤에 생성하려는 새로운 배경 장면에 대한 텍스트 설명입니다.

선택적 매개변수

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

출력 해상도 등급입니다. 최종 생성된 이미지의 해상도를 정의합니다. 기본값: 1k

런타임 오류

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

크레딧 비용

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

공식: 비용 = 품질크레딧

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