v1 · 엔드포인트 7개 · 운영 중

이미지 편집
API, 개발자를 위해

API 키 하나 뒤에 일곱 개의 AI 이미지 처리 엔드포인트가 있습니다. 배경 제거, 업스케일, 워터마크·텍스트 제거, 복원, 컬러화, 그리고 텍스트 기반 이미지 생성. 순수 REST, JSON 응답, 호출이 끝나면 아무것도 남지 않습니다.

  • 7 개 엔드포인트, 키 1개
  • HTTPS 위의 REST
  • 워터마크 없음
  • 아무것도 저장하지 않음
bash — remove-background
$ 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..."
}

01 — 개요

ImgGen AI 이미지 편집 API란?

ImgGen AI 이미지 편집 API는 필요할 때마다 AI 이미지 처리를 수행하는 REST 서비스입니다. 이미지 또는 텍스트 프롬프트를 HTTPS로 엔드포인트에 보내면, 처리된 결과가 JSON 응답 안에 base64로 인코딩되어 돌아옵니다. 직접 호스팅할 모델도, 준비할 GPU도 없습니다.

모든 엔드포인트가 같은 기본 URL과 같은 API 키, 동일한 응답 형식을 공유하므로, 워크플로에 두 번째 기능을 더하는 일은 새 연동이 아니라 경로를 바꾸는 일에 가깝습니다. 코드를 쓰기 전에 모델을 먼저 시험해 보고 싶다면, 브라우저에서 동작하는 ImgGen AI 무료 도구가 같은 모델을 사용합니다.

02 — 빠른 시작

이미지 편집 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.jpg
03 — 엔드포인트

일곱 개의 엔드포인트

각각 파라미터와 세 가지 언어의 코드 예제, 정확한 크레딧 비용을 담은 참조 페이지가 있습니다.

POST /v1/remove-background

배경 제거 API

POST 요청 한 번으로 코드에서 이미지 배경을 제거하세요. API 키 하나, 투명 PNG 출력, 그리고 보내신 이미지를 결코 저장하지 않는 무상태 서비스입니다.

1크레딧
POST /v1/upscale-image

이미지 업스케일 API

자체 백엔드에서 이미지 해상도를 2배 또는 4배로 올리세요. 얼굴 보정과 샤프닝은 선택 사항이고, 출력은 JPEG 또는 PNG이며, 요금은 요청한 배율에 따라 달라집니다.

2–4크레딧
POST /v1/remove-watermark

워터마크 제거 API

한 번의 요청으로 이미지 속 워터마크를 감지하고 지웁니다. 생성형 인페인팅이 워터마크 아래 픽셀을 재구성하며, 이미지 묶음을 받는 유일한 엔드포인트이기도 합니다.

2크레딧
POST /v1/remove-text

텍스트 제거 API

자막, 오버레이, 타임스탬프, 새겨진 라벨을 코드에서 이미지에 대해 지우세요. 감지는 자동이며, 이미지에 텍스트가 없으면 과금되지 않습니다.

2크레딧
POST /v1/image-restoration

사진 복원 API

오래되고 손상되고 색이 바랜 사진을 자체 백엔드에서 복원하세요. 호출 세 번을 이어 붙이는 대신, 같은 요청 안에서 선택적으로 컬러화와 해상도 향상까지 할 수 있습니다.

2크레딧
POST /v1/colorize-photo

사진 컬러화 API

한 번의 요청으로 흑백 사진을 자연스러운 색의 이미지로 바꾸세요. 같은 호출에서 선택적으로 찢김도 복원하며, 색을 손으로 고르는 과정은 어디에도 없습니다.

2크레딧
POST /v1/generate-image

AI 이미지 생성 API

한 번의 JSON 요청으로 텍스트 프롬프트에서 이미지를 생성하세요. 호출당 최대 4개 샘플, 속도와 품질을 저울질할 수 있는 모델 3종, 그리고 결과물에 대한 완전한 상업적 권리.

3+크레딧
04 — 비용

이미지 편집 API의 비용은 얼마인가요?

과금은 호출당 정액이 아니라 크레딧 기반이므로, 바쁜 달과 한산한 달의 이미지당 비용이 같습니다. 크레딧은 모든 엔드포인트 웹 편집기가 함께 사용합니다. 도구별 별도 할당량이 아니라 잔액 하나뿐입니다. 실패한 호출은 자동 환불되며, 성공한 모든 응답은 X-Credit-Remaining 헤더로 남은 잔액을 돌려줍니다.

엔드포인트별 크레딧 비용
엔드포인트경로크레딧 / 호출
배경 제거/v1/remove-background1
이미지 업스케일/v1/upscale-image2–4
워터마크 제거/v1/remove-watermark2
텍스트 제거/v1/remove-text2
사진 복원/v1/image-restoration2
사진 컬러화/v1/colorize-photo2
이미지 생성/v1/generate-image3+
ImgGen AI 플랜과 API 접근
플랜가격크레딧API비고
Free$01회성 무료 크레딧 50API 접근 없음신용카드 불필요
Starter$9.99 / month월 400 크레딧API 접근 포함미사용 크레딧 이월
Pro$29.99 / month월 1,400 크레딧API 접근 + 우선 지원미사용 크레딧 이월
EnterpriseCustom맞춤 사용량전용 인프라support@imggen.ai

크레딧 비용과 제한 최종 확인일 2026-08-27. 자세한 내용은 요금 페이지를 확인하세요.

05 — 작동 방식

API가 작동하는 방식

의도적으로 심심합니다. 요청 하나, 응답 하나, 여러분 쪽에서 조율할 것은 없습니다.

ImgGen API request lifecycleYour application sends a multipart POST to the ImgGen API. The upload is written to a temporary object, passed to the AI model, and the result is returned base64-encoded in the same response. The temporary object is deleted once the response is sent. The whole exchange is synchronous, within a 60 second ceiling.YOUR APPany HTTP clientPOST /v1/…multipart · imageIMGGEN APIauth · charge creditsTEMP OBJECTdeleted after sendAI MODELprocesses image200 OK · JSON · base64synchronous · 60s ceiling
One round trip. There is no job to poll and no webhook to register — the processed image is in the body of the response that answers your request.

동기, 큐 없음

처리된 이미지는 같은 응답의 본문에 담겨 옵니다. 폴링할 작업 ID도, 띄워 둘 웹훅 엔드포인트도, 맞춰 볼 큐도 없습니다. 요청에는 60초 상한이 적용됩니다.

입력은 멀티파트, 출력은 base64

입력 이미지를 멀티파트 폼으로 보내세요. JPEG(JPG), PNG, WebP를 최대 25MB까지 지원합니다. 결과는 JSON 본문에 base64로 인코딩되어 돌아오니, 디코딩해서 자산을 보관하는 곳에 저장하면 됩니다.

성공했을 때만 과금

크레딧은 원자적으로 차감되고 처리가 실패하면 자동으로 환불되므로, 실제로 결과가 돌아온 이미지에 대해서만 청구됩니다. 텍스트 제거는 지울 텍스트가 없을 때 422를 무료로 반환하기까지 합니다.

교체할 수 있는 키

키는 한 번만 표시되고 해시로만 저장됩니다. 취소는 약 1분이면 전파되므로, 키 유출은 사고가 아니라 1분짜리 문제입니다.

06 — 데이터 처리

API가 제 이미지를 저장하거나 학습에 쓰나요?

아니요. 이 API는 상태를 저장하지 않습니다. 나중에 다시 이어서 작업하도록 프로젝트를 저장하는 웹 편집기와 달리, API 호출은 프로젝트도 작업 기록도 저장된 파일도 만들지 않습니다. 업로드된 파일은 임시 객체에 기록되어 처리된 뒤, 응답이 반환되는 즉시 삭제됩니다. 남는 것은 호출이 있었다는 사실과 소모된 크레딧 수를 기록한 사용 로그뿐입니다.

여러분의 이미지는 결코 모델 학습에 사용되지 않습니다. 계약상 보관할 수 없는 고객 사진을 처리한다면 이 점이 중요합니다. 그것들을 저희 스토리지 바깥에 두는 것은 정책만이 아니라 구조 그 자체입니다.

What the API keeps and what it discardsYour upload, the processing step and the returned result all live inside an ephemeral boundary and are deleted once the response is sent. No project, task record or stored file is created. The only thing written to storage is a usage log row recording that a call happened and how many credits it cost.EPHEMERAL — DELETED WHEN THE RESPONSE IS SENTUPLOADyour imagePROCESSmodel runsRESULTbase64 out✗ no project✗ no task record✗ no stored filePERSISTEDUSAGE LOGone row · call + credit costNever used to train models.
The architecture, not just the policy — an API call writes no project, task or file row at all.
07 — 오류

오류 응답

실패 시에는 다음 형태의 JSON이 반환됩니다 { "error": { "message", "code" } }. HTTP 상태 코드는 그 code와 대응합니다.

API 오류 코드
상태코드의미
401UNAUTHORIZEDAPI 키가 없거나 형식이 잘못되었거나 취소되었습니다.
402INSUFFICIENT_CREDITS이 호출에 필요한 크레딧이 계정에 부족합니다.
403FORBIDDEN현재 플랜으로는 이 도구에 접근할 수 없습니다.
404NOT_FOUND해당 엔드포인트 경로가 존재하지 않습니다.
409CONFLICT요청이 리소스의 현재 상태와 충돌합니다.
422VALIDATION_ERROR요청이 거부되었습니다. 지원하지 않는 파일 형식이거나, 필드가 누락되었거나, 처리할 내용이 없습니다. 크레딧은 차감되지 않습니다.
08 — 실제 운영

누가 ImgGen API를 쓰나요?

이미지 처리 API가 제품 안에서 제 몫을 하는 지점들입니다.

이커머스와 마켓플레이스

공급사와 판매자 이미지를 업로드 시점에 정리하세요. 배경을 따내고 덧씌워진 텍스트를 지우고 해상도가 낮은 옛 사진을 키우면, 모든 상품 페이지가 같은 스튜디오에서 찍은 것처럼 보입니다.

주문형 인쇄와 제품 목업

아트워크를 분리하고 인쇄 기준까지 해상도를 올린 뒤 템플릿에 합성하세요. 디자이너가 주문마다 손댈 필요가 없습니다.

디자인·편집 SaaS

GPU를 직접 운영하거나 모델을 파인튜닝하거나 추론 스택을 유지하지 않고도, 자사 제품 안에서 원클릭 편집 기능을 제공하세요.

아카이브, 족보, 디지털화

스캔한 사진을 한 장씩 손으로 보정하는 대신, 자동화된 파이프라인에서 복원하고 컬러화하고 확대하세요.

콘텐츠·퍼블리싱 플랫폼

프롬프트로 오리지널 이미지를 생성하고, 기존 편집 워크플로 안에서 기고자가 올린 이미지를 정리하세요.

에이전시와 사내 도구

클라이언트 브리프에서 최종 결과물 사이에 놓인 반복적인 이미지 작업을, 팀이 이미 쓰는 도구에서 자동화하세요.

FAQ

이미지 편집 API 자주 묻는 질문

있습니다. ImgGen AI 이미지 편집 API는 일곱 개의 REST 엔드포인트(배경 제거, 이미지 업스케일, 워터마크 제거, 텍스트 제거, 사진 복원, 컬러화, 텍스트 기반 이미지 생성)를 제공하며, 모두 https://app.imggen.ai 아래에 있고 하나의 API 키로 접근할 수 있습니다.

시작하기

첫 호출까지 5분

키를 만들고 cURL 예제를 복사하면 배경 제거가 바로 동작합니다. 키 하나로 일곱 개 엔드포인트를, API 접근이 포함된 모든 플랜에서 사용할 수 있습니다.

API 키 받기