remove.bg API 연동을 이전하세요

1. 사용 중인 요청 확인

입력 방식, 출력 형식, 크기, 편집 매개변수를 정리하세요. 파일, HTTPS URL, 일반 base64를 지원하지만 remove.bg의 모든 옵션을 구현하지는 않습니다. 키는 서버에 보관하고 API 지원 요금제에서 새로 만드세요.

2. 엔드포인트와 키 교체

지원 요청은 구조를 유지하고 서버 주소와 X-API-Key를 바꾸세요. 라이브러리가 remove.bg 호스트를 고정한다면 엔드포인트 재설정 기능이나 직접 HTTP 호출을 사용하세요. remove.bg 키를 이 서비스에 보내지 마세요.

- POST https://api.remove.bg/v1.0/removebg
+ POST https://removebgtool.net/v1.0/removebg

X-API-Key: YOUR_NEW_API_KEY

# Generate one ID per image; reuse it when retrying this request.
REQUEST_ID="$(uuidgen)"
curl --fail-with-body --max-time 180 \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -F 'image_file=@image.jpg' \
  'https://removebgtool.net/v1.0/removebg' -o no-bg.png

3. 테스트 전 파라미터 대응 확인

호환성은 요청 형식에 대한 것이지 같은 분리 결과를 뜻하지 않습니다. type은 auto, type_level은 none, channels는 rgba여야 합니다. 값이 있는 미지원 매개변수는 조용히 무시하지 않고 거부합니다.

4. 응답과 과금 확인

저장 전에 Content-Type을 확인하세요. 기본은 이미지 바이트이며 요청 시 result_b64가 있는 JSON을 반환합니다. X-Credits-Charged와 X-Request-ID를 확인하세요. remove.bg 키와 잔액은 이전할 수 없습니다. 여기서는 미리보기와 전체 해상도에 같은 이미지당 요금이 적용됩니다.

5. 대표 이미지 세트로 테스트

제품·인물·낮은 대비 이미지와 모든 출력 형식, 용량 초과, 잘못된 키, 미지원 매개변수, 크레딧 부족을 테스트하세요. 409, 429, 시간 초과, 처리 실패 대응을 확인하고 조사에 필요한 요청 ID를 보관하세요.

Idempotency-Key는 선택 사항입니다. 같은 키·이미지·매개변수로 성공 결과를 10분간 추가 차감 없이 다시 받을 수 있습니다. 재응답은 기존 X-Credits-Charged와 X-Idempotent-Replayed: true를 반환합니다. 처리 중이면 409입니다. 실패·만료 키도 예약 상태로 남으므로 새 과금 요청은 새 키로 보내세요. 헤더가 없으면 각 요청은 별개입니다. 클라이언트 시간 제한은 180초로 설정하세요.

6. 단계적으로 전환하고 롤백 준비

먼저 자체 작업의 일부만 새 연동으로 보내세요. 성공률, 품질, 크레딧을 확인한 뒤 트래픽을 늘리고 이전 설정도 보관하세요. 트래픽 분배와 롤백은 앱에서 관리하며 이 서비스가 자동 전환해 주지는 않습니다.