텍스트 제거 API란?
ImgGen AI 텍스트 제거 API는 이미지 속 텍스트를 찾아 제거하고 글자가 있던 자리의 배경을 재구성하는 REST 엔드포인트입니다. 마스크 없이 자막, 오버레이, 타임스탬프, 새겨진 라벨을 처리합니다. 모델이 텍스트를 찾지 못하면 요청은 422를 반환하고 크레딧은 차감되지 않습니다.
이것은 ImgGen AI 이미지 편집 API의 일곱 개 엔드포인트 중 하나이며, 모두 같은 API 키와 같은 기본 URL, 동일한 요청·응답 형식을 공유합니다. 코드가 아니라 브라우저에서도 이 기능이 필요하다면, 같은 AI 모델이 Image Text Remover 도구를 구동합니다.
요청 파라미터
https://app.imggen.ai/v1/remove-text 으로 POST 요청을 보내고, Authorization 헤더의 API 키로 인증하세요.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| image | file | 필수 | — | The image to clean. 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-text' \
--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-text', {
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-text",
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": "Text removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}알아두면 좋은 제한과 동작
이 엔드포인트는 파일 최대 25MB의 JPEG(JPG), PNG, WebP를 받고 60초 이내에 동기적으로 응답합니다. 폴링할 작업도, 설정할 웹훅도 없습니다.
텍스트가 없으면 과금 없음
모델이 이미지에서 텍스트를 감지하지 못하면 엔드포인트는 422 VALIDATION_ERROR를 반환하고 아무것도 차감하지 않습니다. 섞여 있는 이미지 묶음에 그대로 돌려도 이미 깨끗한 이미지에 대해 비용을 낼 필요가 없습니다.
흐림이 아니라 생성형 채움
글자 뒤 영역은 뭉개지는 대신 주변과 어울리도록 재구성되므로, 디테일이 많은 배경에서도 결과가 무너지지 않습니다.
자동 감지
영역이나 바운딩 박스 파라미터가 없습니다. 모델이 스스로 텍스트를 찾기 때문에, 이 엔드포인트는 사람이 지켜보지 않아도 안전하게 돌릴 수 있습니다.
이미지 텍스트 제거 API는 어디에 쓰이나요?
여러 팀이 이 엔드포인트를 실제 서비스에 넣어 프로그래밍 방식으로 대규모 이미지를 처리하는 사례입니다.
현지화 파이프라인
마케팅 이미지에서 새겨진 원어 문구를 걷어내, 시장별 현지화 버전을 합성할 수 있게 하세요.
마켓플레이스 상품 정돈
판매자가 상품 사진에 얹은 홍보 오버레이와 경쟁사 브랜드 표시를 제거해, 카탈로그 규정을 자동으로 적용하세요.
아카이브 정리
스캔했거나 오래된 사진에 새겨진 타임스탬프와 카메라 라벨을, 미디어 라이브러리에 넣기 전에 지우세요.
템플릿 재사용
완성된 크리에이티브에서 깨끗한 기본 이미지를 되살려, 같은 디자인에 새 문구를 얹을 수 있게 하세요.
이미지 텍스트 제거 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 엔드포인트입니다. 편집기에서 도장 도구로 텍스트를 손수 지우는 것과 같은 일을, 1초 만에 그리고 영역을 표시할 사람 없이 해냅니다.
- 요청은 VALIDATION_ERROR 코드와 함께 HTTP 422를 반환하고 크레딧은 과금되지 않습니다. 덕분에 섞여 있는 묶음에 미리 한 번 돌려 봐도 안전합니다. 실제로 텍스트가 있던 이미지에 대해서만 비용을 냅니다.
- 바로 이 엔드포인트가 하는 일입니다. 글자 위에 덧칠하는 대신 텍스트 영역을 감지해 제거하고, 주변 픽셀을 참고해 가려져 있던 배경을 재구성합니다. 텍스트 영역 바깥은 전혀 손대지 않으므로, 사진의 나머지는 보내신 것과 비트 단위로 동일합니다.
- 네. 감지가 이미지 전체를 대상으로 하므로, 찾아낸 모든 텍스트 영역(자막, 모서리의 타임스탬프, 가운데 라벨)이 같은 한 번의 호출에서 제거됩니다. 다만 여러 *이미지*를 한 요청으로 묶는 것은 여기서 지원하지 않습니다. 요청당 한 장을 보내거나, 일괄 업로드가 필요하면 워터마크 엔드포인트를 사용하세요.
- 텍스트 영역 밖에서는 떨어지지 않습니다. 그 픽셀들은 그대로 통과합니다. 영역 안쪽은 복원이 아니라 생성이므로, 복잡하거나 디테일이 많은 배경은 단색 배경보다 재구성이 어렵습니다. 출력 해상도는 입력과 같고, 축소는 하지 않습니다.
- 그럴 때는 전용 워터마크 제거 엔드포인트를 쓰세요. 워터마크에 흔한 반투명·반복·타일 형태의 오버레이에 맞춰 조정되어 있고, 일괄 업로드를 받는 유일한 엔드포인트이기도 합니다. 이쪽은 불투명한 텍스트, 즉 자막·타임스탬프·새겨진 라벨을 대상으로 합니다.
- 성공한 호출당 2크레딧이며, 텍스트가 감지되지 않으면 전혀 과금되지 않습니다. Starter는 월 400크레딧에 9.99달러, Pro는 1,400크레딧에 29.99달러이고, 구독 중에는 미사용 크레딧이 이월됩니다.
- 없습니다. 감지는 자동이며 이미지 전체에 적용됩니다. 영역이나 바운딩 박스 파라미터가 없습니다. 선택적으로 지워야 한다면, ImgGen 웹 편집기에 그런 수작업에 맞는 브러시 기반 오브젝트 제거 도구가 있습니다.
- 이 API는 이미지 한 장당 최대 25MB의 JPEG(JPG), PNG, WebP 파일을 받습니다. 결과는 JSON 응답 안에 base64로 인코딩된 이미지로 반환됩니다.
- 아니요. 이 API는 상태를 저장하지 않습니다. 프로젝트를 만들지도, 파일을 저장하지도, 여러분의 이미지를 보관하지도 않습니다. 업로드된 파일은 임시 객체에 기록되어 처리된 뒤, 응답이 반환되는 즉시 삭제됩니다. 남는 것은 호출이 있었다는 사실과 소모된 크레딧 수를 기록한 사용 로그뿐입니다. 여러분의 이미지는 결코 모델 학습에 사용되지 않습니다.
시작하기
텍스트 제거 API 호출을 시작하세요
키 하나로 일곱 개 엔드포인트가 모두 열립니다. 워터마크 없음, 완전한 상업적 권리, 그리고 보내신 어떤 것도 응답이 반환된 뒤에는 저장되지 않습니다.
API 키 받기