배경 제거 API로 누끼 작업 자동화하기

이제 removerbg의 자동 배경 제거를 웹사이트나 앱, 작업 흐름에 바로 연동할 수 있어요. 간단한 HTTP API예요. 이미지를 보내면 몇 초 만에 배경이 투명하게 지워진 깔끔한 누끼 이미지를 돌려받아요.

# 할 수 있는 일

- 이미지 업로드 — multipart form data 형식으로 PNG, JPEG, WebP를 최대 10MB까지 보낼 수 있어요. - 출력 형식 선택 — 투명한 PNG(기본값), 또는 품질을 조절할 수 있는 JPEG/WebP. - 원하는 방식으로 결과 받기 — 바이너리 이미지를 그대로 받거나, 임시 다운로드 URL이 담긴 JSON 응답으로 받을 수 있어요.

모든 요청은 최고 품질 모델로 처리되기 때문에 고를 등급 자체가 없어요. 언제나 가장 높은 품질의 누끼를 받게 돼요. 배경 제거가 성공할 때마다 크레딧 1개가 차감되고, 실패한 요청(잘못된 키나 크레딧 부족 등)에는 요금이 부과되지 않아요.

# 인증

대시보드에서 API 키를 만든 뒤 Bearer 토큰으로 보내세요:

`` Authorization: Bearer rmbg_YOUR_API_KEY ``

보낸 이미지가 어떻게 처리되는지 궁금하신가요? API도 제품의 다른 부분과 똑같은 원칙을 따릅니다 — remover.bg의 보안과 개인정보 보호 방식을 확인해 보세요.

# 빠른 시작

요청 한 번으로 배경을 지울 수 있어요:

`` curl -X POST "https://api.remover.bg/remove-bg?format=png" \ -H "Authorization: Bearer rmbg_YOUR_API_KEY" \ -F "file=@photo.jpg" \ --output result.png ``

JavaScript에서는 이렇게 씁니다:

``` const form = new FormData(); form.append("file", fileInput.files[0]);

const res = await fetch("https://api.remover.bg/remove-bg", { method: "POST", headers: { Authorization: "Bearer rmbgYOURAPI_KEY" }, body: form, });

if (!res.ok) throw new Error(await res.text()); const blob = await res.blob(); // your transparent PNG ```

# 옵션

- format — png(기본값), jpeg, webp 중 선택. - quality — JPEG/WebP 압축에 쓰이는 0부터 1 사이의 값. - trim — true(기본값)이면 비어 있는 투명 여백을 잘라냅니다. - response — 바이너리 파일은 image(기본값), 임시 링크가 담긴 JSON 응답은 url(링크는 약 24시간 유효).

> 모든 응답에는 X-Credits-Remaining 헤더가 들어 있어서 사용량을 계속 확인할 수 있어요.

# 대규모 처리

요청 하나가 이미지 하나를 처리하지만, 같은 엔드포인트로 카탈로그 전체를 감당할 수 있어요. 업로드 시점에 실행하거나, 야간 배치 스크립트로 돌리거나, PIM/DAM 파이프라인 안에 넣어도 돼요. 대량 배경 제거 가이드에서 이런 패턴들과 함께, 수천 장의 누끼를 일정한 품질로 유지하는 QA 샘플링 요령까지 다루고 있어요.

# 몇 분이면 시작할 수 있어요

API 문서와 바로 복사해 쓸 수 있는 코드 샘플이 있어서, 단 몇 분이면 실제로 동작시켜 볼 수 있어요. 여러분이 무엇을 만들었는지 꼭 들려주세요.