v1 · 엔드포인트 7개 · 운영 중
이미지 편집
API, 개발자를 위해
API 키 하나 뒤에 일곱 개의 AI 이미지 처리 엔드포인트가 있습니다. 배경 제거, 업스케일, 워터마크·텍스트 제거, 복원, 컬러화, 그리고 텍스트 기반 이미지 생성. 순수 REST, JSON 응답, 호출이 끝나면 아무것도 남지 않습니다.
- 7 개 엔드포인트, 키 1개
- HTTPS 위의 REST
- 워터마크 없음
- 아무것도 저장하지 않음
$ curl -X POST app.imggen.ai/v1/remove-background \
-H "Authorization: Bearer sk_live_..." \
-F image=@photo.jpg
→ 200 OK · 128 ms · X-Credit-Remaining: 385
{
"success": true,
"image": "iVBORw0KGgoAAAANSUhEUg..."
}ImgGen AI 이미지 편집 API란?
ImgGen AI 이미지 편집 API는 필요할 때마다 AI 이미지 처리를 수행하는 REST 서비스입니다. 이미지 또는 텍스트 프롬프트를 HTTPS로 엔드포인트에 보내면, 처리된 결과가 JSON 응답 안에 base64로 인코딩되어 돌아옵니다. 직접 호스팅할 모델도, 준비할 GPU도 없습니다.
모든 엔드포인트가 같은 기본 URL과 같은 API 키, 동일한 응답 형식을 공유하므로, 워크플로에 두 번째 기능을 더하는 일은 새 연동이 아니라 경로를 바꾸는 일에 가깝습니다. 코드를 쓰기 전에 모델을 먼저 시험해 보고 싶다면, 브라우저에서 동작하는 ImgGen AI 무료 도구가 같은 모델을 사용합니다.
이미지 편집 API는 어떻게 사용하나요?
API 키를 생성한 뒤 이미지를 담아 멀티파트 요청을 보내세요. 이 예시는 배경을 제거하며, 다른 편집 엔드포인트도 경로만 다를 뿐 같은 패턴을 따릅니다. 이미지 생성만 예외로, 파일 대신 프롬프트·샘플 수·가로세로 비율이 담긴 JSON 본문을 받습니다.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--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-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const { image } = await res.json();
fs.writeFileSync('result.png', Buffer.from(image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
with open("result.png", "wb") as out:
out.write(base64.b64decode(res.json()["image"]))일곱 개의 엔드포인트
각각 파라미터와 세 가지 언어의 코드 예제, 정확한 크레딧 비용을 담은 참조 페이지가 있습니다.
배경 제거 API
POST 요청 한 번으로 코드에서 이미지 배경을 제거하세요. API 키 하나, 투명 PNG 출력, 그리고 보내신 이미지를 결코 저장하지 않는 무상태 서비스입니다.
이미지 업스케일 API
자체 백엔드에서 이미지 해상도를 2배 또는 4배로 올리세요. 얼굴 보정과 샤프닝은 선택 사항이고, 출력은 JPEG 또는 PNG이며, 요금은 요청한 배율에 따라 달라집니다.
워터마크 제거 API
한 번의 요청으로 이미지 속 워터마크를 감지하고 지웁니다. 생성형 인페인팅이 워터마크 아래 픽셀을 재구성하며, 이미지 묶음을 받는 유일한 엔드포인트이기도 합니다.
텍스트 제거 API
자막, 오버레이, 타임스탬프, 새겨진 라벨을 코드에서 이미지에 대해 지우세요. 감지는 자동이며, 이미지에 텍스트가 없으면 과금되지 않습니다.
사진 복원 API
오래되고 손상되고 색이 바랜 사진을 자체 백엔드에서 복원하세요. 호출 세 번을 이어 붙이는 대신, 같은 요청 안에서 선택적으로 컬러화와 해상도 향상까지 할 수 있습니다.
사진 컬러화 API
한 번의 요청으로 흑백 사진을 자연스러운 색의 이미지로 바꾸세요. 같은 호출에서 선택적으로 찢김도 복원하며, 색을 손으로 고르는 과정은 어디에도 없습니다.
AI 이미지 생성 API
한 번의 JSON 요청으로 텍스트 프롬프트에서 이미지를 생성하세요. 호출당 최대 4개 샘플, 속도와 품질을 저울질할 수 있는 모델 3종, 그리고 결과물에 대한 완전한 상업적 권리.
이미지 편집 API의 비용은 얼마인가요?
과금은 호출당 정액이 아니라 크레딧 기반이므로, 바쁜 달과 한산한 달의 이미지당 비용이 같습니다. 크레딧은 모든 엔드포인트와 웹 편집기가 함께 사용합니다. 도구별 별도 할당량이 아니라 잔액 하나뿐입니다. 실패한 호출은 자동 환불되며, 성공한 모든 응답은 X-Credit-Remaining 헤더로 남은 잔액을 돌려줍니다.
| 엔드포인트 | 경로 | 크레딧 / 호출 |
|---|---|---|
| 배경 제거 | /v1/remove-background | 1 |
| 이미지 업스케일 | /v1/upscale-image | 2–4 |
| 워터마크 제거 | /v1/remove-watermark | 2 |
| 텍스트 제거 | /v1/remove-text | 2 |
| 사진 복원 | /v1/image-restoration | 2 |
| 사진 컬러화 | /v1/colorize-photo | 2 |
| 이미지 생성 | /v1/generate-image | 3+ |
| 플랜 | 가격 | 크레딧 | API | 비고 |
|---|---|---|---|---|
| Free | $0 | 1회성 무료 크레딧 50 | API 접근 없음 | 신용카드 불필요 |
| Starter | $9.99 / month | 월 400 크레딧 | API 접근 포함 | 미사용 크레딧 이월 |
| Pro | $29.99 / month | 월 1,400 크레딧 | API 접근 + 우선 지원 | 미사용 크레딧 이월 |
| Enterprise | Custom | 맞춤 사용량 | 전용 인프라 | support@imggen.ai |
크레딧 비용과 제한 최종 확인일 2026-08-27. 자세한 내용은 요금 페이지를 확인하세요.
API가 작동하는 방식
의도적으로 심심합니다. 요청 하나, 응답 하나, 여러분 쪽에서 조율할 것은 없습니다.
동기, 큐 없음
처리된 이미지는 같은 응답의 본문에 담겨 옵니다. 폴링할 작업 ID도, 띄워 둘 웹훅 엔드포인트도, 맞춰 볼 큐도 없습니다. 요청에는 60초 상한이 적용됩니다.
입력은 멀티파트, 출력은 base64
입력 이미지를 멀티파트 폼으로 보내세요. JPEG(JPG), PNG, WebP를 최대 25MB까지 지원합니다. 결과는 JSON 본문에 base64로 인코딩되어 돌아오니, 디코딩해서 자산을 보관하는 곳에 저장하면 됩니다.
성공했을 때만 과금
크레딧은 원자적으로 차감되고 처리가 실패하면 자동으로 환불되므로, 실제로 결과가 돌아온 이미지에 대해서만 청구됩니다. 텍스트 제거는 지울 텍스트가 없을 때 422를 무료로 반환하기까지 합니다.
교체할 수 있는 키
키는 한 번만 표시되고 해시로만 저장됩니다. 취소는 약 1분이면 전파되므로, 키 유출은 사고가 아니라 1분짜리 문제입니다.
API가 제 이미지를 저장하거나 학습에 쓰나요?
아니요. 이 API는 상태를 저장하지 않습니다. 나중에 다시 이어서 작업하도록 프로젝트를 저장하는 웹 편집기와 달리, API 호출은 프로젝트도 작업 기록도 저장된 파일도 만들지 않습니다. 업로드된 파일은 임시 객체에 기록되어 처리된 뒤, 응답이 반환되는 즉시 삭제됩니다. 남는 것은 호출이 있었다는 사실과 소모된 크레딧 수를 기록한 사용 로그뿐입니다.
여러분의 이미지는 결코 모델 학습에 사용되지 않습니다. 계약상 보관할 수 없는 고객 사진을 처리한다면 이 점이 중요합니다. 그것들을 저희 스토리지 바깥에 두는 것은 정책만이 아니라 구조 그 자체입니다.
오류 응답
실패 시에는 다음 형태의 JSON이 반환됩니다 { "error": { "message", "code" } }. HTTP 상태 코드는 그 code와 대응합니다.
| 상태 | 코드 | 의미 |
|---|---|---|
| 401 | UNAUTHORIZED | API 키가 없거나 형식이 잘못되었거나 취소되었습니다. |
| 402 | INSUFFICIENT_CREDITS | 이 호출에 필요한 크레딧이 계정에 부족합니다. |
| 403 | FORBIDDEN | 현재 플랜으로는 이 도구에 접근할 수 없습니다. |
| 404 | NOT_FOUND | 해당 엔드포인트 경로가 존재하지 않습니다. |
| 409 | CONFLICT | 요청이 리소스의 현재 상태와 충돌합니다. |
| 422 | VALIDATION_ERROR | 요청이 거부되었습니다. 지원하지 않는 파일 형식이거나, 필드가 누락되었거나, 처리할 내용이 없습니다. 크레딧은 차감되지 않습니다. |
누가 ImgGen API를 쓰나요?
이미지 처리 API가 제품 안에서 제 몫을 하는 지점들입니다.
이커머스와 마켓플레이스
공급사와 판매자 이미지를 업로드 시점에 정리하세요. 배경을 따내고 덧씌워진 텍스트를 지우고 해상도가 낮은 옛 사진을 키우면, 모든 상품 페이지가 같은 스튜디오에서 찍은 것처럼 보입니다.
주문형 인쇄와 제품 목업
아트워크를 분리하고 인쇄 기준까지 해상도를 올린 뒤 템플릿에 합성하세요. 디자이너가 주문마다 손댈 필요가 없습니다.
디자인·편집 SaaS
GPU를 직접 운영하거나 모델을 파인튜닝하거나 추론 스택을 유지하지 않고도, 자사 제품 안에서 원클릭 편집 기능을 제공하세요.
아카이브, 족보, 디지털화
스캔한 사진을 한 장씩 손으로 보정하는 대신, 자동화된 파이프라인에서 복원하고 컬러화하고 확대하세요.
콘텐츠·퍼블리싱 플랫폼
프롬프트로 오리지널 이미지를 생성하고, 기존 편집 워크플로 안에서 기고자가 올린 이미지를 정리하세요.
에이전시와 사내 도구
클라이언트 브리프에서 최종 결과물 사이에 놓인 반복적인 이미지 작업을, 팀이 이미 쓰는 도구에서 자동화하세요.
이미지 편집 API 자주 묻는 질문
- 있습니다. ImgGen AI 이미지 편집 API는 일곱 개의 REST 엔드포인트(배경 제거, 이미지 업스케일, 워터마크 제거, 텍스트 제거, 사진 복원, 컬러화, 텍스트 기반 이미지 생성)를 제공하며, 모두 https://app.imggen.ai 아래에 있고 하나의 API 키로 접근할 수 있습니다.
- 보내신 이미지에 특정 편집을 수행하고 같은 응답으로 결과를 돌려줍니다. 배경을 제거해 투명 PNG를 얻거나, 2배·4배로 확대하거나, 워터마크나 새겨진 텍스트를 지우거나, 손상된 사진을 복원하고 컬러화하거나, 텍스트 프롬프트로 새 이미지를 생성할 수 있습니다.
- https://editor.imggen.ai 에서 ImgGen 계정을 만들고 계정 설정에서 키를 생성하세요. 키는 한 번만 표시되고 해시로만 저장되므로 안전한 곳에 복사해 두세요. 분실하면 복구가 아니라 새로 발급해야 합니다. 키 취소는 약 1분 이내에 적용됩니다.
- 모든 요청에 키를 베어러 토큰으로 보내세요: Authorization: Bearer sk_live_…. 현재 방식 이전에 발급된 키는 지금도 허용되는 기존 x-imggen-key 헤더로도 인증할 수 있습니다.
- 사용량은 호출당 정액이 아니라 크레딧으로 측정되며, 비용은 엔드포인트마다 다릅니다. 배경 제거는 1크레딧, 워터마크 제거·텍스트 제거·복원·컬러화는 2크레딧, 업스케일은 factor=2일 때 2·factor=4일 때 4, 이미지 생성은 3부터 시작해 모델에 따라 달라집니다. Starter는 월 400크레딧에 9.99달러, Pro는 1,400크레딧에 29.99달러이며, 구독 중에는 미사용 크레딧이 이월됩니다.
- 무료 ImgGen 계정에는 신용카드 없이 50크레딧이 제공되어 웹 도구에서 모델을 평가하기에 충분합니다. API 접근 자체는 유료 Starter·Pro 플랜에 포함됩니다. 영구 무료 API 등급은 없으며, 나중에 조용히 속도를 제한하는 것을 광고하기보다 그 사실을 분명히 말씀드립니다.
- 이 API는 이미지 한 장당 최대 25MB의 JPEG(JPG), PNG, WebP 파일을 받습니다. 결과는 JSON 응답 안에 base64로 인코딩된 이미지로 반환됩니다.
- 동기입니다. 폴링할 작업 ID도, 관리할 큐도, 설정할 웹훅도 없습니다. 처리된 이미지는 같은 응답의 본문에 담겨 옵니다. 요청에는 60초 상한이 적용됩니다.
- 아니요. 이 API는 상태를 저장하지 않습니다. 프로젝트를 만들지도, 파일을 저장하지도, 여러분의 이미지를 보관하지도 않습니다. 업로드된 파일은 임시 객체에 기록되어 처리된 뒤, 응답이 반환되는 즉시 삭제됩니다. 남는 것은 호출이 있었다는 사실과 소모된 크레딧 수를 기록한 사용 로그뿐입니다. 여러분의 이미지는 결코 모델 학습에 사용되지 않습니다.
- 네. 무료 플랜을 포함한 모든 플랜에 완전한 상업적 사용 권한이 포함되며, 어떤 결과물에도 워터마크가 들어가지 않습니다. API가 반환한 것은 무엇이든 판매하거나 인쇄하거나 게시할 수 있습니다.
- 워터마크 제거 엔드포인트는 image[] 로 보낸 파일 묶음을 받아 images 배열을 반환합니다. 나머지 엔드포인트는 요청당 이미지 한 장을 처리합니다. 처리량이 필요하다면 각 호출이 독립적이므로 자체 워커에서 요청을 병렬로 보내세요.
- 현재는 없습니다. 이 API는 HTTPS 위의 순수 REST에 멀티파트 업로드를 쓰기 때문에 어떤 HTTP 클라이언트로도 사용할 수 있고, 문서에는 cURL·Node.js·Python 예제가 복사해 쓸 수 있게 준비되어 있습니다. 공식 클라이언트 라이브러리나 공개된 OpenAPI 명세는 아직 없습니다.
시작하기
첫 호출까지 5분
키를 만들고 cURL 예제를 복사하면 배경 제거가 바로 동작합니다. 키 하나로 일곱 개 엔드포인트를, API 접근이 포함된 모든 플랜에서 사용할 수 있습니다.
API 키 받기