remove.bg API가 종료돼요. 한 줄만 바꾸고 코드는 그대로 두세요.
remove.bg의 독립 웹사이트와 셀프서비스 API가 에 종료돼요. API는 Leonardo.Ai(Canva 계열사)로 이전되어 연동을 변경해야 해요(Leonardo.Ai 공지). removebackground.dev는 같은 요청을 그대로 받아요. 코드가 저희 URL을 가리키게 하고 저희 키를 사용하면 끝이에요.
remove.bg 셀프서비스 API 종료일:
바뀌는 건 단 한 줄
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebg같은 X-Api-Key 헤더에 removebackground.dev 키를 넣으세요. 파라미터 이름도, 응답 헤더도, {"errors": [...]} 오류 형식도 같아요.
변경 전과 후
네 가지 언어로 작성한 일반적인 연동 예시예요. 키는 REMOVEBG_API_KEY에서 가져오므로, 수정할 부분은 강조 표시된 URL뿐이에요.
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://api.remove.bg/v1.0/removebg
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://removebackground.dev/v1.0/removebg
Zapier, Make 또는 n8n을 사용하시나요?
remove.bg를 호출하는 HTTP 요청 단계(Zapier Webhooks, Make HTTP, n8n HTTP Request)를 열고, URL을 https://removebackground.dev/v1.0/removebg로, X-Api-Key 값을 removebackground.dev 키로 바꾸세요. 나머지 필드는 그대로 두면 돼요.
파라미터 호환성
remove.bg 요청에서 보내는 모든 항목을 그대로 받아요. 일부 옵션은 여기서는 효과가 없으며, 아래에 그렇게 표시되어 있어요.
| 파라미터 | 상태 | 참고 |
|---|---|---|
image_file / image_file_b64 / image_url | 지원 | multipart, urlencoded 또는 JSON 본문. JPG, PNG, WebP 최대 25 MB. |
size | 지원 | auto, full, 4k, 50MP는 원본 해상도(최대 25 MP), preview, small, regular는 약 0.25 MP, medium은 1.5 MP, hd는 4 MP. 항상 1 크레딧이에요. |
format | 지원 | auto(투명하면 PNG, 아니면 JPG), png, jpg, webp, zip(color.jpg + alpha.png). |
crop / crop_margin | 지원 | 피사체 기준 px 또는 %, CSS 방식의 값 1~4개("10% 20%" = 세로, 가로). 각 변 최대 500px 또는 50%. |
roi | 지원 | px 또는 %로 지정한 "x1 y1 x2 y2": 영역 안의 피사체만 남겨요. |
scale / position | 지원 | scale은 10%~100% 또는 original, position은 center, original 또는 "x% y%". |
channels | 지원 | rgba(누끼) 또는 alpha(흑백 마스크). |
bg_color | 지원 | #을 붙이거나 붙이지 않은 16진수(81d4fa) 또는 색상 이름. 8자리 16진수는 색상은 유지하고 알파 값은 무시해요. |
bg_image_url / bg_image_file | 지원 | 누끼를 배경 이미지 위에 합성하며, 배경 이미지는 출력 크기에 맞게 cover 방식으로 채워져요. |
Accept: application/json | 지원 | { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } }를 반환해요. |
type / type_level | 허용, 무시됨 | 피사체는 자동으로 감지되며, X-Type은 항상 "other"예요. |
semitransparency | 허용, 무시됨 | 부드러운 가장자리와 반투명 영역은 모델의 매트를 그대로 사용해요. |
shadow_type / shadow_opacity / add_shadow | 허용, 무시됨 | 그림자는 추가되지 않아요. |
오래 걸리는 요청 | 차이점 | 최대 110초까지 기다려요. 그때까지 이미지가 준비되지 않으면 재시도 가능한 503을 반환해요(처리가 완료되지 않으면 요금이 부과되지 않아요). |
응답 헤더
호출에 성공하면 이미지 바이트(image/png, image/jpeg, image/webp 또는 application/zip)와 함께 다음 헤더를 반환해요. Accept: application/json을 보내면 대신 result_b64를 받을 수 있어요.
| 헤더 | 의미 |
|---|---|
X-Width / X-Height | 결과물의 크기(픽셀). |
X-Credits-Charged | 이 이미지에 사용된 크레딧: 항상 1(실패한 이미지는 0). |
X-Type | 항상 "other"(피사체 감지는 자동). |
X-Foreground-Top / -Left / -Width / -Height | 결과물에서 피사체의 경계 상자(픽셀). |
X-Request-ID | 보낸 X-Request-ID 또는 생성된 ID를 그대로 반환해요. 추가 기능. |
X-Matte-Confidence / X-Matte-Ambiguous-Ratio | 마스크가 얼마나 깔끔한지(0~1)와 부드러운 픽셀의 비율. 추가 기능: 검토가 필요한 이미지를 표시하는 데 유용해요. |
오류
| 상태 | 의미 |
|---|---|
400 | 잘못된 파라미터 또는 이미지(invalid_size, invalid_crop_margin, missing_source, file_too_large, unknown_foreground 등의 코드). |
402 | insufficient_credits: 요금 페이지에서 충전하세요. |
403 | auth_failed: X-Api-Key가 없거나 유효하지 않아요. |
429 | rate_limit_exceeded. |
500 / 503 | 처리 실패, 시간 초과 또는 서비스를 잠시 사용할 수 없는 상태예요. 다시 시도하세요. 실패한 이미지는 무료예요. |
GET https://removebackground.dev/v1.0/account로 잔액을 확인하세요. 응답은 remove.bg의 계정 형식을 따라요. 자세한 내용은 API 레퍼런스를 확인하세요.
크레딧: 이미지 1장당 1개, 만료 없음
성공한 이미지는 크기나 옵션과 관계없이 1장당 1 크레딧이에요. 실패한 이미지는 무료예요. 신규 계정에는 테스트용 무료 크레딧 50개를 드려요.
- 크레딧 만료 없음한 번 충전하고 다음 주든 내년이든 사용하세요.
- 구독 없음일회성 팩이에요. 자동 갱신은 없어요.
- 실패한 이미지는 무료배경이 제거됐을 때만 크레딧이 차감돼요.
이전 체크리스트
- removebackground.dev API 키 받기가입하고(무료 크레딧 50개) 계정 페이지에서 키를 만드세요.
- 한 줄 바꾸기코드가 https://removebackground.dev/v1.0/removebg를 가리키게 하고, 새 키를 같은 X-Api-Key 헤더에 넣으세요.
- 이미지 한 장 테스트실제 요청을 한 번 실행하고, 지금 받는 결과물과 비교해 보세요.
- 트래픽 전환2026년 12월 1일 오전 9:00 CET 전에 배포하세요. 크레딧은 한 번 충전하면 만료되지 않아요.
remove.bg 이전 FAQ
remove.bg가 서비스를 종료하나요?
remove.bg의 독립 웹사이트와 셀프서비스 API가 2026년 12월 1일 오전 9:00 CET에 종료돼요. API는 Leonardo.Ai(Canva 계열사)로 이전되어 연동을 변경해야 해요. 출처: Leonardo.Ai 공지(https://www.leonardo.ai/news/removebg-api-leonardo).
가장 간단한 remove.bg API 대체 방법은 무엇인가요?
removebackground.dev에는 remove.bg 호환 엔드포인트가 있어요. https://api.remove.bg/v1.0/removebg를 https://removebackground.dev/v1.0/removebg로 바꾸고, 같은 X-Api-Key 헤더에 removebackground.dev 키를 보내면 나머지 코드는 그대로 유지할 수 있어요. 파라미터 이름, 응답 헤더, 오류 형식이 모두 같아요.
2026년 12월 전에 연동을 다시 작성해야 하나요?
아니요. 요청은 같은 파라미터(image_file, image_url, size, format, crop, bg_color…)를 그대로 사용하고 같은 종류의 응답을 받아요. X-Width, X-Height, X-Foreground-* 헤더가 포함된 이미지 바이트, 또는 result_b64가 담긴 JSON이에요. URL과 키만 바뀌어요.
Zapier, Make, n8n에서도 작동하나요?
네. HTTP 요청 단계(Zapier Webhooks, Make HTTP, n8n HTTP Request)에서 URL을 https://removebackground.dev/v1.0/removebg로, X-Api-Key 값을 removebackground.dev 키로 바꾸세요. 그 밖에는 바꿀 것이 없어요.
요금은 얼마인가요?
성공한 이미지는 크기나 옵션과 관계없이 1장당 1 크레딧이에요. 구독 없이 US$17, US$49 또는 US$99의 일회성 충전 방식이며, 크레딧은 만료되지 않아요. 실패한 이미지는 무료예요. 신규 계정에는 무료 크레딧 50개를 드려요.
어떤 remove.bg 파라미터를 지원하나요?
image_file, image_file_b64, image_url, size, format(auto, png, jpg, webp, zip), crop, crop_margin, roi, scale, position, channels, bg_color, bg_image_url, bg_image_file을 지원해요. type, type_level, semitransparency 및 shadow 관련 옵션은 허용되지만 무시되므로, 이를 보내는 요청도 그대로 작동해요.
예전처럼 잔액을 확인할 수 있나요?
네. 키와 함께 GET https://removebackground.dev/v1.0/account를 호출하면 remove.bg의 계정 형식으로 크레딧을 반환해요.
removebackground.dev는 remove.bg와 관련이 있나요?
아니요. remove.bg는 해당 소유자의 상표예요. removebackground.dev는 같은 API 요청을 받는 독립적인 서비스예요.
2026년 12월 1일 오전 9:00 CET 전에 전환하세요
remove.bg 셀프서비스 API 종료일:
키를 만들고, 한 줄을 바꾸고, 이미지 한 장으로 테스트하세요. 무료 크레딧 50개 포함.
remove.bg는 해당 소유자의 상표이며, removebackground.dev는 remove.bg와 관련이 없어요.