2026-09-26미디어 도구

배경 제거 API: Sume RMBG 1.0으로 투명 PNG 만들기

공개 HTTPS 이미지 URL을 POST /v1/rmbg-1.0/remove로 보내면 알파 채널이 있는 PNG를 돌려받습니다. 크기와 관계없이 이미지당 요금은 하나입니다.

읽는 시간 4분Sume

Sume API로 이미지 배경을 제거하려면 공개 HTTPS image_url을 POST /v1/rmbg-1.0/remove로 보내세요. Sume RMBG 1.0(sume/rmbg-1.0)이 이를 Job으로 실행하며, 완료된 결과는 알파 채널이 있는 Sume 호스팅 PNG이므로 제거된 배경은 투명합니다.

RMBG 1.0은 Sume API 레퍼런스의 바탕이 되는 OpenAPI 문서에 명세되어 있습니다. Job, 결과, 과금은 API 레퍼런스와 핵심 개념 문서 페이지에서 다룹니다. 모두 2026-09-26에 확인한 내용입니다.

배경 제거 API는 어떻게 호출하나요?

이미지 URL을 담은 JSON을 보내세요. 필수 필드는 image_url 하나뿐입니다. 모델 필드는 없으며, 모델은 Sume가 고릅니다. 같은 본문은 POST /v1/models/sume/rmbg-1.0/runs에서도 동작합니다.

자주 쓰는 RMBG 1.0 요청 필드입니다. 전체 스키마는 Sume API 레퍼런스에 있으며, 2026-09-26에 확인했습니다.
필드	필수	설명
`image_url`	예	배경을 제거할 공개 HTTPS 이미지 URL.
`mode`	아니요	`async`(기본값), `sync`, `subscribe`, `webhook` 중 하나.
`wait_timeout_seconds`	아니요	`sync`나 `subscribe`의 블로킹 대기 시간, 0–30초.
`webhook_url`	아니요	공개 HTTPS 콜백 URL, 최대 2,048자.
`metadata`	아니요	Job 요청과 함께 저장되는 사용자 정의 객체.

curl -X POST https://api.sume.com/v1/rmbg-1.0/remove \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: rmbg-portrait-001" \
  -d '{
    "image_url": "https://example.com/inputs/portrait.png",
    "mode": "async"
  }'

결과에는 무엇이 담기나요?

완료된 Job은 Sume로 미러링된, 알파 채널이 있는 PNG 아티팩트를 제공합니다. result_ready가 true가 되면 GET /v1/jobs/:id/result를 가져오세요. 그 전에는 409 job_not_completed로 응답합니다. URL을 넣으면 Sume URL로 돌려받는 같은 패턴이 다른 Job에서는 어떻게 쓰이는지 영상 API 미디어 입출력에서 설명합니다.

각 아티팩트에는 불투명한 id, type, media.sume.com 아래의 url, content_type이 있습니다. width, height, size_bytes도 설정될 수 있습니다.
아티팩트 경로는 불투명합니다. URL은 저장하되, ID를 얻으려고 파싱하지는 마세요.

이미 투명한 이미지의 배경을 다시 제거하면 어떻게 되나요?

배경을 다시 제거하는 전형적인 경우처럼 입력에 이미 완전히 투명한 픽셀이 상당히 많으면, Sume는 가장자리가 깔끔하게 남도록 먼저 입력을 중간 회색 #808080 위에 평탄화합니다. 이 경우에도 과금되는 제거는 한 번입니다. 불투명한 입력은 바뀌지 않습니다.

배경 제거 결과를 기다려야 하나요, 폴링해야 하나요?

모든 모드는 첫 응답에서 Job ID를 반환합니다.

sync나 subscribe는 최대 wait_timeout_seconds까지 요청을 붙잡아 둡니다. 그때까지 Job이 끝나지 않아도 응답은 2xx이며 현재 Job 상태와 폴링 URL이 담깁니다. 다시 제출하지 말고 status_url을 폴링하세요.
async는 status_url, result_url, events_url, cancel_url과 함께 즉시 반환됩니다.
webhook은 즉시 반환되고, Job이 완료되거나 실패하거나 취소되면 서명된 콜백을 보냅니다. 진행 상황 콜백은 없습니다.
POST /v1/jobs/:id/cancel은 생성이 시작되기 전까지 쓸 수 있습니다. 그 뒤에는 409 job_generation_already_started를 반환합니다.

배경 제거 비용은 얼마인가요?

API 요금에는 배경 제거가 이미지당 $0.0225로 나와 있으며, 여기에 기본 5.5% 에이전트 수수료가 더해집니다. 공개 카탈로그 GET /v1/catalog의 가격 기준에는 가격이 이미지 크기에 따라 달라지지 않는다는 설명이 덧붙어 있습니다.

Sume는 제출할 때 예상 금액을 예약하고, Job이 성공하면 확정하며, 확정 전에 실패하거나 취소된 Job은 환불합니다. 잔액이 예상 금액을 감당하지 못하면 제출은 402를 반환하고 Job은 시작되지 않습니다.

RMBG 1.0이 하지 않는 일은 무엇인가요?

RMBG 1.0은 이미 있는 이미지 한 장을 처리합니다. 새 이미지 생성은 다른 엔드포인트이며, 레퍼런스 이미지 기반 이미지 생성 API에서 다룹니다. 그 밖의 한계는 다음과 같습니다.

모델 선택 없음. 요청에서 모델 ID를 받지 않습니다.
출력 형식 옵션 없음. 결과는 알파 채널이 있는 PNG입니다.
Job당 이미지 한 장: image_url은 URL 하나입니다.
파일 바이트는 받지 않음. Sume가 URL을 가져오며, localhost, 사설 네트워크, HTTPS가 아닌 URL과 이미지가 아닌 응답은 생성 제출 전에 거부됩니다.
진행 상황 콜백 없음. 웹훅은 job.completed, job.failed, job.canceled에서만 발생합니다.

출처

작성자 Sume