배경 제거 API란?
ImgGen AI 배경 제거 API는 사진의 전경 피사체를 배경에서 분리해 투명 PNG를 반환하는 REST 엔드포인트입니다. HTTPS로 이미지를 업로드하면 AI가 피사체를 자동으로 감지하고, 잘라낸 결과가 JSON 응답 안에 base64로 인코딩되어 돌아옵니다. 마스크나 수동 선택은 필요 없습니다.
이것은 ImgGen AI 이미지 편집 API의 일곱 개 엔드포인트 중 하나이며, 모두 같은 API 키와 같은 기본 URL, 동일한 요청·응답 형식을 공유합니다. 코드가 아니라 브라우저에서도 이 기능이 필요하다면, 같은 AI 모델이 Background Remover 도구를 구동합니다.
요청 파라미터
https://app.imggen.ai/v1/remove-background 으로 POST 요청을 보내고, Authorization 헤더의 API 키로 인증하세요.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| image | file | 필수 | — | The input image to process. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
배경 제거 API는 어떻게 연동하나요?
ImgGen 계정에서 API 키를 만들고 환경 변수로 지정한 뒤 엔드포인트를 호출하세요. 같은 요청을 cURL, Node.js, Python으로 보여드립니다.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))응답
성공한 호출은 JSON을 반환합니다. 결과는 base64로 인코딩되어 있으니 디스크나 오브젝트 스토리지에 쓰기 전에 디코딩하세요. 성공한 응답에는 호출 후 잔액을 담은 X-Credit-Remaining 헤더도 함께 옵니다.
{
"success": true,
"message": "Background removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}알아두면 좋은 제한과 동작
이 엔드포인트는 파일 최대 25MB의 JPEG(JPG), PNG, WebP를 받고 60초 이내에 동기적으로 응답합니다. 폴링할 작업도, 설정할 웹훅도 없습니다.
투명 PNG 출력
결과는 실제 알파 채널과 함께 반환되므로, 두 번째 요청 없이 어떤 배경·색상·템플릿 위에도 합성할 수 있습니다.
마스크 불필요
피사체 감지는 자동이며 전경이 배경에서 알아서 분리됩니다. 칠하거나 따라 그리거나 두 번째 파라미터로 넘길 것이 없습니다. 입력 이미지를 보내고 결과를 읽으면 끝입니다.
아무것도 저장하지 않음
입력은 호출이 진행되는 동안만 임시 객체에 보관되고 이후 삭제됩니다. 보관이 허용되지 않는 고객 사진을 처리할 때 유용합니다.
배경 제거 API는 어디에 쓰이나요?
여러 팀이 이 엔드포인트를 실제 서비스에 넣어 프로그래밍 방식으로 대규모 이미지를 처리하는 사례입니다.
이커머스 카탈로그
공급사 상품 이미지의 배경을 업로드 시점에 제거해, 수작업 편집 단계 없이 모든 상품 페이지에 깔끔하고 일관된 컷아웃을 노출하세요.
마켓플레이스와 중고 거래
판매자가 올린 사진을 자동으로 정규화하세요. 모든 업로드를 엔드포인트에 통과시키고 투명 PNG를 원본과 함께 저장하면 됩니다.
주문형 인쇄
목업에 합성하기 전에 아트워크와 피사체를 분리해, 어떤 제품 크기에서도 미리보기가 제대로 렌더링되도록 하세요.
디자인·편집 SaaS
모델을 학습시키거나 호스팅하거나 AWS 등에서 직접 추론을 돌리지 않고도, 자사 제품 안에서 원클릭 배경 제거를 사용자에게 제공하세요.
배경 제거 API의 비용은 얼마인가요?
성공한 호출 한 번에 1크레딧가 들며, 따라서 이미지당 실질 비용은 이용 중인 플랜에 따라 정해집니다. 크레딧은 플랜에서 차감되고 모든 엔드포인트와 웹 편집기가 함께 쓰므로, 도구별로 별도 할당량을 살 필요가 없습니다. 실패한 호출은 자동으로 환불됩니다. 자세한 내용은 요금 페이지를 확인하세요.
| 플랜 | 가격 | 크레딧 | API |
|---|---|---|---|
| Free | $0 | 1회성 무료 크레딧 50 | API 접근 없음 |
| Starter | $9.99 / month | 월 400 크레딧 | API 접근 포함 |
| Pro | $29.99 / month | 월 1,400 크레딧 | API 접근 + 우선 지원 |
| Enterprise | Custom | 맞춤 사용량 | 전용 인프라 |
크레딧 비용과 제한 최종 확인일 2026-08-27.
관련 엔드포인트 및 도구
배경 제거 API를 쓰는 팀이 다음으로 자주 찾는 것들입니다.
배경 제거 API 자주 묻는 질문
- 사진을 받아 배경이 제거되고 피사체가 투명 레이어 위에 남은 같은 사진을 반환하는 HTTP 엔드포인트입니다. 편집기가 아니라 API이므로 백엔드 작업, 큐 워커, 사용자 업로드 핸들러에서 호출해 아무도 브라우저를 열지 않은 채 수천 장을 처리할 수 있습니다.
- ImgGen 계정에서 API 키를 만든 다음, image 필드가 담긴 멀티파트 폼을 Authorization: Bearer 헤더와 함께 https://app.imggen.ai/v1/remove-background 로 POST 하세요. 응답은 JSON입니다. base64로 된 image 필드를 디코딩해 디스크나 오브젝트 스토리지에 쓰면 됩니다. 동작하는 cURL·Node.js·Python 예제가 이 페이지에 있습니다.
- 성공한 호출당 1크레딧으로, API에서 가장 저렴한 엔드포인트입니다. Starter는 월 400크레딧에 9.99달러로 배경 제거 약 400회에 해당하고, Pro는 1,400크레딧에 29.99달러입니다. 구독 중에는 미사용 크레딧이 이월되며, 실패한 호출은 자동 환불되므로 실제로 결과가 돌아온 이미지에 대해서만 청구됩니다.
- 계정을 만들면 신용카드 없이 무료 크레딧 50으로 AI 도구를 사용해 볼 수 있습니다. API 접근은 유료 Starter·Pro 플랜에 포함됩니다. 영구 무료 API 등급은 없으며, 나중에 조용히 제한을 거는 것을 광고하기보다 그 사실을 분명히 말씀드립니다.
- 이 API는 이미지 한 장당 최대 25MB의 JPEG(JPG), PNG, WebP 파일을 받습니다. 결과는 JSON 응답 안에 base64로 인코딩된 이미지로 반환됩니다.
- 아니요. 이 API는 상태를 저장하지 않습니다. 프로젝트를 만들지도, 파일을 저장하지도, 여러분의 이미지를 보관하지도 않습니다. 업로드된 파일은 임시 객체에 기록되어 처리된 뒤, 응답이 반환되는 즉시 삭제됩니다. 남는 것은 호출이 있었다는 사실과 소모된 크레딧 수를 기록한 사용 로그뿐입니다. 여러분의 이미지는 결코 모델 학습에 사용되지 않습니다.
- 네. 무료 플랜을 포함한 모든 플랜에 완전한 상업적 사용 권한이 포함되며, 어떤 결과물에도 워터마크가 들어가지 않습니다. API가 반환한 것은 무엇이든 판매하거나 인쇄하거나 게시할 수 있습니다.
- 이 엔드포인트는 투명 PNG를 반환하므로, 새 색상·그라디언트·배경을 합성하는 일은 두 번째 API 호출 없이 여러분의 파이프라인에서 하시면 됩니다. 직접 준비한 소재 대신 AI가 만든 배경을 원한다면 ImgGen 웹 편집기에 배경 생성기도 있습니다.
시작하기
배경 제거 API 호출을 시작하세요
키 하나로 일곱 개 엔드포인트가 모두 열립니다. 워터마크 없음, 완전한 상업적 권리, 그리고 보내신 어떤 것도 응답이 반환된 뒤에는 저장되지 않습니다.
API 키 받기