워터마크 제거 API란?
ImgGen AI 워터마크 제거 API는 이미지에서 워터마크를 찾아 그 아래 내용을 재구성하는 REST 엔드포인트입니다. 감지가 자동이라 마스크가 필요 없고, 생성형 인페인팅이 지워진 영역을 흐리게 뭉개는 대신 주변과 어울리도록 채웁니다. 정리된 이미지는 같은 응답으로 반환됩니다.
이것은 ImgGen AI 이미지 편집 API의 일곱 개 엔드포인트 중 하나이며, 모두 같은 API 키와 같은 기본 URL, 동일한 요청·응답 형식을 공유합니다. 코드가 아니라 브라우저에서도 이 기능이 필요하다면, 같은 AI 모델이 Watermark Remover 도구를 구동합니다.
요청 파라미터
https://app.imggen.ai/v1/remove-watermark 으로 POST 요청을 보내고, Authorization 헤더의 API 키로 인증하세요.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| image | file | 필수 | — | 일괄 형식. image[] 로 여러 파일을 보내면 한 번의 요청으로 처리합니다. 응답에는 images 배열과, 처리하지 못한 항목을 담은 failedImages가 함께 반환됩니다. |
| image[] | file[] | 선택 | — | Batch form. Send multiple files under image[] to process them in one request; the response returns an images array plus failedImages for any that could not be processed. |
워터마크 제거 API는 어떻게 연동하나요?
ImgGen 계정에서 API 키를 만들고 환경 변수로 지정한 뒤 엔드포인트를 호출하세요. 같은 요청을 cURL, Node.js, Python으로 보여드립니다.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-watermark' \
--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-watermark', {
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-watermark",
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": "Watermark removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}알아두면 좋은 제한과 동작
이 엔드포인트는 파일 최대 25MB의 JPEG(JPG), PNG, WebP를 받고 60초 이내에 동기적으로 응답합니다. 폴링할 작업도, 설정할 웹훅도 없습니다.
일괄 업로드
묶음을 받는 유일한 ImgGen 엔드포인트입니다. image[] 로 여러 파일을 보내면 응답에 images 배열과 함께, 처리되지 않은 항목을 나열한 failedImages가 담깁니다.
자동 감지
마스크나 박스, 브러시 파라미터가 없습니다. 모델이 스스로 워터마크 위치를 찾아내므로, 아주 다른 원본 이미지에도 동일한 요청 형식이 통합니다.
본인 소유의 것만 편집하세요
소유하지 않았거나 편집 라이선스가 없는 이미지에서 워터마크를 제거하면 저작권을 침해할 수 있습니다. 이 엔드포인트는 본인의 자산이나 수정할 권리가 있는 이미지에 사용하세요.
워터마크 제거 API는 어디에 쓰이나요?
여러 팀이 이 엔드포인트를 실제 서비스에 넣어 프로그래밍 방식으로 대규모 이미지를 처리하는 사례입니다.
자사 아카이브 되찾기
브랜드가 바뀔 때 수천 장의 자사 이미지에서 예전 스튜디오 워터마크를 제거하세요. 원본을 하나씩 다시 손볼 필요가 없습니다.
라이선스 소재 워크플로
CMS로 발행하는 자동 파이프라인의 일부로, 라이선스를 받은 미리보기 표시가 있는 소재를 정리하세요.
사진 납품
고객이 결제를 마치면 주문 시스템에서 바로 이미지의 교정용 표시를 제거하세요.
템플릿 제작
본인이 권리를 가진 원본 소재를 템플릿이나 목업에 합성하기 전에, 겹쳐진 표시를 지우세요.
워터마크 제거 API의 비용은 얼마인가요?
성공한 호출 한 번에 2크레딧가 들며, 따라서 이미지당 실질 비용은 이용 중인 플랜에 따라 정해집니다. 크레딧은 플랜에서 차감되고 모든 엔드포인트와 웹 편집기가 함께 쓰므로, 도구별로 별도 할당량을 살 필요가 없습니다. 실패한 호출은 자동으로 환불됩니다. 자세한 내용은 요금 페이지를 확인하세요.
| 플랜 | 가격 | 크레딧 | 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 엔드포인트입니다. 감지가 자동이라 워터마크 위치를 알려줄 필요가 없고, 바로 그 점이 무인 일괄 작업에서 쓸 수 있게 해 줍니다.
- 네. 워터마크 제거는 일괄 처리를 지원하는 유일한 ImgGen 엔드포인트입니다. image 대신 image[] 로 파일을 보내면 응답에 images 배열과, 처리하지 못한 항목을 담은 failedImages 배열이 반환됩니다. 다른 모든 엔드포인트는 요청당 이미지 한 장을 처리합니다.
- 성공한 이미지 한 장당 2크레딧이며, 묶음 안의 각 이미지도 동일합니다. Starter는 월 400크레딧에 9.99달러, Pro는 1,400크레딧에 29.99달러이고, 구독 중에는 미사용 크레딧이 이월됩니다.
- ImgGen 웹 도구에서는 처음 받은 50크레딧으로 신용카드 없이 무료로 워터마크를 지울 수 있습니다. API 자체는 유료 Starter·Pro 플랜에 포함됩니다. 무료 워터마크 제거 API는 대개 체험판이거나 제한이 심한 데모일 뿐, 제품을 올릴 만한 것은 아닙니다.
- 범용 어시스턴트도 이미지를 편집할 때가 있지만, 이 용도로 만들어지지 않았습니다. 표시를 안정적으로 감지하지 못하고, 영향받은 영역만 재구성하는 대신 이미지 전체를 다시 그리는 경우가 많으며, 자동화를 걸 만한 안정적인 요청 형식도 없습니다. 전용 인페인팅 엔드포인트는 일관된 출력과, 기대어 개발할 수 있는 규약을 제공합니다.
- 전적으로 그 이미지의 권리자가 누구인지에 달려 있습니다. 직접 촬영한 사진이나 편집 권한과 함께 라이선스를 받은 소재에서 워터마크를 지우는 것은 문제가 없습니다. 타인의 저작물에서 워터마크를 지워 허락 없이 사용하는 것은 문제이며, 이 엔드포인트는 그런 용도로 만들어지지 않았습니다.
- 이 API는 이미지 한 장당 최대 25MB의 JPEG(JPG), PNG, WebP 파일을 받습니다. 결과는 JSON 응답 안에 base64로 인코딩된 이미지로 반환됩니다.
- 아니요. 이 API는 상태를 저장하지 않습니다. 프로젝트를 만들지도, 파일을 저장하지도, 여러분의 이미지를 보관하지도 않습니다. 업로드된 파일은 임시 객체에 기록되어 처리된 뒤, 응답이 반환되는 즉시 삭제됩니다. 남는 것은 호출이 있었다는 사실과 소모된 크레딧 수를 기록한 사용 로그뿐입니다. 여러분의 이미지는 결코 모델 학습에 사용되지 않습니다.
- API로는 안 됩니다. 동영상 워터마크 제거는 imggen.ai의 웹 도구로 제공하지만 API에는 동영상 엔드포인트가 없으며, 모든 /v1 경로는 정지 이미지를 처리합니다.
시작하기
워터마크 제거 API 호출을 시작하세요
키 하나로 일곱 개 엔드포인트가 모두 열립니다. 워터마크 없음, 완전한 상업적 권리, 그리고 보내신 어떤 것도 응답이 반환된 뒤에는 저장되지 않습니다.
API 키 받기