이커머스 제품 이미지를 위한 Recraft 배경 제거

제품 배경을 수작업으로 오려내는 일은 수십 개의 SKU를 넘어서면 확장이 불가능합니다. hiapi의 Recraft 배경 제거 모델은 이 작업을 단 한 번의 API 호출로 바꿉니다. 제품 사진을 전송하면 배경이 투명한 깔끔한 PNG가 반환되고, 이를 마켓플레이스나 스토어프론트에 필요한 어떤 배경에든 배치할 수 있습니다. 이 글은 recraft/remove-background에 대한 실제 배치 실행을 안내하며, 실제 요청, 실제 출력, 그리고 전체 제품 카탈로그에 적용할 수 있는 스크립트를 다룹니다.

배경 제거가 여전히 실제 병목인 이유

대부분의 제품 이미지 파이프라인은 비슷합니다. 사진작가나 공급업체가 보낸 사진에는 그때 손에 있던 임의의 배경(스튜디오 무이음 배경지, 창고 바닥, 운송 팔레트)이 담겨 있으며, 누군가 제품을 먼저 분리해야만 흰 배경 목록 페이지, 라이프스타일 합성 이미지, 또는 카테고리별로 특정 배경색을 요구하는 마켓플레이스 템플릿에 넣을 수 있습니다.

주당 소량의 이미지를 넘어서면 Photoshop에서 이 작업을 하는 것은 확장이 불가능하며, 일반적인 "AI 배경 제거" 웹 도구는 브라우저를 통해 제품 사진을 한 장씩 업로드해야 하므로 느리고 자동화하기 어렵습니다. API 기반 누끼 모델은 두 문제를 모두 해결합니다. 단일 이미지 처리 속도가 빠르고 스크립트에서 호출하기가 매우 간단하여 기존 제품 사진 카탈로그 파이프라인에 바로 통합할 수 있습니다.

recraft/remove-background가 실제로 하는 일

이 모델은 제품 사진 URL이라는 단 하나의 입력만 받습니다. 배경이 제거되고 투명 영역으로 대체된 PNG를 반환합니다. 프롬프트도, 마스크도, 조정할 추가 파라미터도 없습니다. 전체 요청은 다음과 같습니다:

{
  "model": "recraft/remove-background",
  "input": {
    "image_url": "https://your-cdn.example.com/products/sneaker-001.jpg"
  }
}

카탈로그 작업에서 좁은 입력 범위는 장점입니다. 프롬프트 엔지니어링 단계가 없으며, 동일한 호출이 전달하는 모든 제품 사진에 대해 동일하게 작동합니다. 이는 수천 개의 SKU를 무인으로 처리할 때 중요합니다.

실제 실행: 전후 비교

다음은 실시간 API를 통해 실행한 실제 제품 사진과 그것이 반환한 누끼입니다:

오른쪽의 체크무늬 패턴은 회색 배경이 아니라 투명을 나타냅니다. PNG 출력은 배경을 완전히 제거하므로 제품을 다운스트림의 어떤 것에도 합성할 수 있습니다. 흰색 목록 배경, 브랜드 색상 블록 또는 라이프스타일 장면 등입니다.

투명 PNG로 저장된 단독 누끼는 다음과 같습니다:

이 파일은 추가 마스크 작업 없이 목록 템플릿, 마켓플레이스 요구 사항을 충족하는 흰색 배경 프레임, 또는 디자인 도구의 레이어 스택에 바로 넣을 수 있습니다.

직접 호출

요청은 hiapi의 표준 비동기 작업 엔드포인트로 전송됩니다. 작업을 제출한 다음 완료될 때까지 폴링합니다:

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "recraft/remove-background",
    "input": {
      "image_url": "https://your-cdn.example.com/products/sneaker-001.jpg"
    }
  }'

그러면 taskId가 반환됩니다. status가 success가 될 때까지 GET https://api.hiapi.ai/v1/tasks/{taskId}를 폴링한 다음 즉시 output[0].url에서 PNG를 다운로드하십시오. 출력 URL은 만료되므로, 그에 대해 다른 작업을 하기 전에 바이트를 자체 스토리지로 가져와야 합니다.

전체 카탈로그에 대한 배치 처리

단일 누끼 호출은 흥미로운 부분이 아닙니다. 전체 제품 카탈로그에서 실행하는 것이 핵심입니다. 다음은 이미지 URL 목록을 스레드 풀에 분배하고, 각 작업을 기다린 다음, 소스 사진에서 누끼 URL로의 매핑을 반환하는 실제 배치 스크립트입니다:

import concurrent.futures
import os
import time
import requests

API_KEY = os.environ["HIAPI_API_KEY"]
BASE_URL = "https://api.hiapi.ai/v1/tasks"


def remove_background(image_url: str) -> str:
    resp = requests.post(
        BASE_URL,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={"model": "recraft/remove-background", "input": {"image_url": image_url}},
        timeout=60,
    )
    resp.raise_for_status()
    task_id = resp.json()["data"]["taskId"]

    while True:
        poll = requests.get(
            f"{BASE_URL}/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
            timeout=30,
        )
        task = poll.json()["data"]
        if task["status"] == "success":
            return task["output"][0]["url"]
        if task["status"] == "fail":
            raise RuntimeError(f"{image_url}: {task['error']}")
        time.sleep(3)


def batch_remove_background(image_urls, max_workers: int = 5):
    results = {}
    with concurrent.futures.ThreadPoolExecutor(max_workers=max_workers) as pool:
        futures = {pool.submit(remove_background, url): url for url in image_urls}
        for future in concurrent.futures.as_completed(futures):
            url = futures[future]
            try:
                results[url] = future.result()
            except Exception as exc:
                print(f"failed: {url} -> {exc}")
    return results

max_workers=5는 카탈로그 작업에 합리적인 시작 동시성입니다. 계정의 속도 제한이 더 많은 병렬 작업을 허용한다면 이를 높일 수 있으며, 항상 이미지별 try/except를 유지하여 하나의 잘못된 소스 사진이 배치의 나머지를 지연시키지 않도록 하십시오. 각 결과 URL이 반환되는 즉시 영구 스토리지에 다운로드하십시오. 출력 URL이 나중에도 유효하다고 가정하지 마십시오.

카탈로그 규모에서의 비용

2026-09 기준, hiapi에서 recraft/remove-background의 가격은 이미지당 $0.01입니다. 각 SKU당 한 장의 메인 이미지가 있는 500개 SKU 카탈로그의 경우 전체 배치 누끼 비용은 $5에 불과하며, 각 SKU당 세 각도를 누끼해야 하는 카탈로그의 경우 $15입니다. 대규모 배치를 계획하기 전에 요율이 변경될 수 있으므로 실시간 가격 페이지를 확인하십시오.

자주 묻는 질문

프롬프트나 마스크가 필요한가요? 아니요. 유일한 입력은 image_url입니다. 이미지별로 조정할 것이 없으며, 이것이 대규모 카탈로그에서 무인으로 실행할 수 있는 이유입니다.

출력은 어떤 형태인가요? 배경이 투명 영역으로 대체된 PNG이며, 크기는 입력 사진의 피사체 프레이밍과 일치합니다. 목록 템플릿에 필요한 어떤 배경에도 합성하십시오.

스튜디오 사진뿐만 아니라 배경이 복잡한 라이프스타일 사진도 입력할 수 있나요? 예. 깔끔한 스튜디오 설정뿐만 아니라 모든 제품 사진 URL에 작동하지만, 대부분의 제품 사진에서처럼 피사체가 선명하게 분리되어 있을 때 가장 깔끔한 가장자리를 제공합니다.

작업은 얼마나 빠른가요? 단일 작업은 일반적으로 몇 초에서 1분 이내에 완료됩니다. 위의 배치 스크립트는 작업당 3초마다 폴링하고 여러 작업을 병렬로 실행하므로, 수백 장의 이미지가 단일 스크립트 실행으로 완료될 수 있습니다.

가격이 이미지 해상도에 따라 달라지나요? 이 모델은 해상도별 등급이 아닌 작업당 고정 요율을 청구합니다. 대규모 배치를 약정하기 전에 공개된 요율이 변경될 수 있으므로 가격 페이지에서 현재 요율을 확인하십시오.

다음 단계

recraft/remove-background 모델 페이지에서 직접 모델을 사용해 보거나, 기존 사진을 누끼하는 것뿐만 아니라 새로운 제품 장면을 생성해야 하는 경우 관련 생성 측 워크플로우인 Qwen Image로 이커머스 제품 이미지 생성를 확인하십시오. 작업 API가 지원하는 다른 모든 내용은 퀵스타트 문서에서 인증 및 전체 작업 수명 주기를 다룹니다.