이미지 업스케일 API란?
ImgGen AI 이미지 업스케일 API는 단순 보간이 아니라 AI로 이미지 해상도를 높이는 REST 엔드포인트입니다. 픽셀을 늘이는 대신 가장자리와 질감, 세부를 재구성하므로 결과가 선명하게 유지됩니다. 이미지와 배율을 보내면 더 높은 해상도의 결과가 같은 요청 안에서 돌아옵니다.
이것은 ImgGen AI 이미지 편집 API의 일곱 개 엔드포인트 중 하나이며, 모두 같은 API 키와 같은 기본 URL, 동일한 요청·응답 형식을 공유합니다. 코드가 아니라 브라우저에서도 이 기능이 필요하다면, 같은 AI 모델이 AI Image Upscaler 도구를 구동합니다.
요청 파라미터
https://app.imggen.ai/v1/upscale-image 으로 POST 요청을 보내고, Authorization 헤더의 API 키로 인증하세요.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| image | file | 필수 | — | 업스케일 배율. 2 또는 4를 지정할 수 있습니다. |
| factor | number | 선택 | 4 | 얼굴 재구성을 추가로 수행합니다. 인물 사진과 단체 사진에 유용합니다. |
| enhanceFace | boolean | 선택 | false | 업스케일된 결과에 추가로 샤프닝을 적용합니다. |
| sharpen | boolean | 선택 | false | 출력 형식. jpeg 또는 png를 지정할 수 있습니다. |
| output | string | 선택 | jpeg | Output format. Accepts jpeg or png. |
이미지 업스케일 API는 어떻게 연동하나요?
ImgGen 계정에서 API 키를 만들고 환경 변수로 지정한 뒤 엔드포인트를 호출하세요. 같은 요청을 cURL, Node.js, Python으로 보여드립니다.
curl --request POST \
--url 'https://app.imggen.ai/v1/upscale-image' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form factor=4 \
--form enhanceFace=false \
--form sharpen=false \
--form output=jpegimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('factor', '4');
form.append('enhanceFace', 'false');
form.append('sharpen', 'false');
form.append('output', 'jpeg');
const res = await fetch('https://app.imggen.ai/v1/upscale-image', {
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/upscale-image",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"factor": "4", "enhanceFace": "false", "sharpen": "false", "output": "jpeg"},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))응답
성공한 호출은 JSON을 반환합니다. 결과는 base64로 인코딩되어 있으니 디스크나 오브젝트 스토리지에 쓰기 전에 디코딩하세요. 성공한 응답에는 호출 후 잔액을 담은 X-Credit-Remaining 헤더도 함께 옵니다.
{
"success": true,
"message": "Image upscaled successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}알아두면 좋은 제한과 동작
이 엔드포인트는 파일 최대 25MB의 JPEG(JPG), PNG, WebP를 받고 60초 이내에 동기적으로 응답합니다. 폴링할 작업도, 설정할 웹훅도 없습니다.
출력 형식을 고르세요
무손실 결과가 필요하거나 알파 채널을 유지해야 할 때는 output=png를 지정하세요. 대량 카탈로그 작업에서는 jpeg가 응답 크기를 작게 유지해 줍니다.
얼굴 보정은 선택 사항
enhanceFace는 인물 사진을 보정하며 확대하기 위해 얼굴 재구성을 추가로 수행합니다. 얼굴이 없는 상품 사진이나 풍경에서는 꺼 두세요.
Synchronous by design
There is no job queue to poll. The upscaled image comes back in the same response, within the 60-second request ceiling.
이미지 업스케일 API는 어디에 쓰이나요?
여러 팀이 이 엔드포인트를 실제 서비스에 넣어 프로그래밍 방식으로 대규모 이미지를 처리하는 사례입니다.
오래된 카탈로그 이전
다시 촬영하는 대신, 수년간 쌓인 작고 저해상도인 상품 이미지를 일괄 작업으로 요즘의 고해상도 기준까지 끌어올리세요.
인쇄 준비
웹용 소재를 인쇄에서도 버티는 크기로 올리고, 같은 호출에서 선택적으로 샤프닝해 더 또렷한 결과를 얻으세요.
사용자 제작 콘텐츠
작은 아바타와 업로드 이미지를 서버 측에서 확대해 고해상도 디스플레이에서도 깔끔하게 보이도록 하세요.
미디어와 아카이브
스캔했거나 압축된 원본 이미지를 콘텐츠 관리 시스템에 넣기 전에 해상도를 높이고, 필요하다면 복원도 함께 진행하세요.
이미지 업스케일 API의 비용은 얼마인가요?
성공한 호출 한 번에 2–4크레딧가 들며, 따라서 이미지당 실질 비용은 이용 중인 플랜에 따라 정해집니다. 크레딧은 플랜에서 차감되고 모든 엔드포인트와 웹 편집기가 함께 쓰므로, 도구별로 별도 할당량을 살 필요가 없습니다. 실패한 호출은 자동으로 환불됩니다. 자세한 내용은 요금 페이지를 확인하세요.
| 플랜 | 가격 | 크레딧 | 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 엔드포인트입니다. 리사이즈처럼 기존 픽셀 사이를 보간하는 대신, 그 이미지의 더 높은 해상도 버전이라면 담고 있을 세부(가장자리, 질감, 구조)를 모델이 예측해 재구성합니다. 이미지를 POST하고 응답에서 확대된 결과를 읽으면 됩니다.
- factor 파라미터는 2 또는 4를 받으며 기본값은 4입니다. 입력은 최대 25MB의 JPEG(JPG)·PNG·WebP이고, 출력은 jpeg(기본) 또는 png로 받을 수 있습니다.
- 비용은 배율을 따릅니다. factor=2면 2크레딧, factor=4(기본값)면 4크레딧입니다. Starter는 월 400크레딧에 9.99달러, Pro는 1,400크레딧에 29.99달러이며 구독을 유지하는 동안 미사용 크레딧은 이월됩니다. 크레딧 기반 과금이므로 작업량이 많은 달과 한산한 달의 이미지당 비용이 같습니다.
- 업스케일은 확대하면서 세부를 재구성하므로 부수적으로 흐릿한 이미지가 또렷해지고, sharpen 플래그로 그 효과를 더 강화할 수 있습니다. 손상되거나 색이 바랜 사진(긁힘, 찢김, 변색)에는 해상도가 아니라 복원을 위해 만들어진 사진 복원 API를 사용하세요.
- 동기입니다. 폴링할 작업 ID도, 설정할 웹훅도 없습니다. 업스케일된 이미지는 같은 응답의 본문에 담겨 오며, 요청당 60초 상한이 적용됩니다.
- 네. 무료 플랜을 포함한 모든 플랜에 완전한 상업적 사용 권한이 포함되며, 어떤 결과물에도 워터마크가 들어가지 않습니다. API가 반환한 것은 무엇이든 판매하거나 인쇄하거나 게시할 수 있습니다.
- 아니요. 이 API는 상태를 저장하지 않습니다. 프로젝트를 만들지도, 파일을 저장하지도, 여러분의 이미지를 보관하지도 않습니다. 업로드된 파일은 임시 객체에 기록되어 처리된 뒤, 응답이 반환되는 즉시 삭제됩니다. 남는 것은 호출이 있었다는 사실과 소모된 크레딧 수를 기록한 사용 로그뿐입니다. 여러분의 이미지는 결코 모델 학습에 사용되지 않습니다.
시작하기
이미지 업스케일 API 호출을 시작하세요
키 하나로 일곱 개 엔드포인트가 모두 열립니다. 워터마크 없음, 완전한 상업적 권리, 그리고 보내신 어떤 것도 응답이 반환된 뒤에는 저장되지 않습니다.
API 키 받기