이미지 업스케일링 API: 개발자 통합 가이드

앱에 이미지 업스케일링을 넣으려면 예전에는 AI 모델을 직접 훈련해야 했습니다. 몇 달의 작업과 큰 GPU 예산이 필요했죠. UpscaleIMG API를 사용하면 이미지를 보내고 몇 초 만에 선명하게 확대된 결과를 받을 수 있습니다.

이 가이드에서는 UpscaleIMG를 프로젝트에 통합하는 방법을 알려드립니다. 실제 코드 예제와 모든 옵션을 다룹니다.

UpscaleIMG API로 무엇을 할 수 있나요?

UpscaleIMG API는 Real-ESRGAN을 사용합니다. 이미지 초해상도에 특화된 강력한 AI 모델입니다. 사진을 보내면 AI가 확대하면서 사실적인 디테일을 추가합니다. 가장자리는 선명하게 유지됩니다. 텍스처는 자연스럽게 보입니다. 얼굴 특징도 보존됩니다.

제공되는 기능:

• 2배, 4배 업스케일링 AI 기반 디테일 향상
• 커스텀 크기 원하는 출력 사이즈 지정
• 포맷 변환 PNG, JPG, WebP 간 변환
• 메타데이터 제어 EXIF 데이터 삭제 또는 유지
• 최대 6,400만 화소 출력 해상도

모든 AI 처리는 저희 서버에서 실행됩니다. GPU가 필요 없습니다. 모델 설정도 없습니다. HTTP 요청을 보내고 결과를 받으세요.

API를 시작하는 방법은?

요청하려면 API 키가 필요합니다. 발급 방법:

1. upscaleimg.app에서 계정 생성
2. 대시보드에서 API 키 생성
3. 서버에 안전하게 저장

API 엔드포인트:

POST https://upscaleimg.app/api/v1/upscale

인증은 Authorization 헤더의 Bearer 토큰을 사용합니다. API 키는 서버 측에 보관하세요. 클라이언트 코드에 노출하거나 저장소에 커밋하지 마세요.

무료 계정은 2배 업스케일링을 사용할 수 있습니다. 구독자는 4배 업스케일링과 원본의 4배까지 커스텀 크기를 사용할 수 있습니다.

첫 번째 이미지를 확대하는 방법은?

가장 간단한 호출은 이미지와 스케일 팩터만 있으면 됩니다. curl로 2배 확대하는 예제:

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "scale=2"

API는 원본과 확대된 이미지의 정보를 JSON으로 반환합니다:

{
  "original": {
    "size": 384000,
    "width": 1920,
    "height": 1080,
    "mimeType": "image/jpeg",
    "fileExt": "jpg"
  },
  "result": {
    "size": 1280000,
    "width": 3840,
    "height": 2160,
    "mimeType": "image/png",
    "fileExt": "png",
    "url": "https://..."
  }
}

url 필드에 서명된 다운로드 링크가 있습니다. 서명된 URL은 빨리 만료되니 바로 다운로드하세요.

JavaScript 예제:

const form = new FormData();
form.append('image', fileInput.files[0]);
form.append('scale', '2');

const response = await fetch('https://upscaleimg.app/api/v1/upscale', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: form
});

const data = await response.json();
console.log(`${data.result.width}x${data.result.height}로 확대`);

Python 예제:

import requests

with open('photo.jpg', 'rb') as f:
    response = requests.post(
        'https://upscaleimg.app/api/v1/upscale',
        headers={'Authorization': 'Bearer YOUR_API_KEY'},
        files={'image': f},
        data={'scale': '2'}
    )

data = response.json()
print(f"{data['result']['width']}x{data['result']['height']}로 확대")

API에서 지원하는 옵션은?

API는 멀티파트 폼 데이터로 여러 파라미터를 받습니다. 전체 목록:

파라미터	필수	값	설명
image	예	파일	PNG, JPG, JPEG, WebP 이미지
scale	예*	2 또는 4	확대 배율. *커스텀 크기 사용 시 불필요.
customWidth	아니오	정수	목표 너비 (픽셀, 최대 4배)
customHeight	아니오	정수	목표 높이 (픽셀, 최대 4배)
objectFit	아니오	cover, contain, fill	커스텀 크기 피팅 모드. 기본값: cover.
outputFormat	아니오	jpg, jpeg, png, webp	출력 포맷. 기본값: png.
removeMetadata	아니오	1 또는 0	EXIF 데이터 삭제. 기본값: 0 (유지).

커스텀 크기로 정밀하게 제어할 수 있습니다. customWidth와 customHeight는 함께 지정해야 합니다. 출력은 원본보다 작을 수 없고, 4배를 초과할 수 없습니다 (무료 계정은 2배까지).

예를 들어, 3000x2000 WebP로 확대:

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "customWidth=3000" \
  -F "customHeight=2000" \
  -F "objectFit=cover" \
  -F "outputFormat=webp" \
  -F "removeMetadata=1"

에러와 요청 제한은 어떻게 처리하나요?

API는 표준 HTTP 상태 코드를 반환합니다:

상태	의미
200	성공. 확대된 이미지 반환.
400	잘못된 요청. 이미지 누락, 잘못된 배율, 크기 범위 초과.
401	API 키 무효 또는 누락.
403	금지. 구독 없이 4배 시도 또는 CORS 에러.
429	요청 제한. 요청이 너무 많습니다.
500	서버 에러. 다시 시도하세요.

에러 응답에는 메시지가 포함됩니다:

{"error": "4x upscaling is only available with an active subscription."}

요청 제한에는 백오프 리트라이 로직을 추가하세요:

async function upscaleWithRetry(form, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const res = await fetch('https://upscaleimg.app/api/v1/upscale', {
      method: 'POST',
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
      body: form
    });

    if (res.status === 429) {
      await new Promise(r => setTimeout(r, 2000 * (i + 1)));
      continue;
    }

    return await res.json();
  }
  throw new Error('Max retries reached');
}

최고의 활용 사례는?

UpscaleIMG API는 다양한 워크플로우에 자연스럽게 맞습니다.

이커머스 플랫폼에서는 판매자의 상품 사진을 개선하는 데 사용합니다. 많은 업로드가 작거나 저화질입니다. 자동 업스케일링으로 모든 상품이 프로페셔널하게 보입니다. 화질 손실 없이 이미지 확대하는 방법도 참고하세요.

주문형 인쇄 서비스는 고해상도 파일이 필요합니다. 고객이 올린 이미지가 화면에서는 괜찮아도 인쇄하기엔 작을 수 있습니다. 4K로 확대하는 것도 가능합니다.

사진 복원 앱은 업스케일링과 다른 보정을 결합합니다. 오래된 사진이나 흐린 사진을 선명하게 만들면서 확대합니다.

CMS에서는 업로드 시 이미지를 자동으로 개선할 수 있습니다. 모든 이미지가 최소 품질 기준을 충족하게 됩니다.

부동산 사이트는 균일한 사진 품질의 혜택을 받습니다. 다양한 카메라로 촬영된 사진이 통일된 프로페셔널한 모습이 됩니다.

배치 처리는 이미지 업스케일 자동화 가이드를 참고하세요. 최고의 업스케일러 비교도 도움이 됩니다.

시작할 준비가 되셨나요?

1시간 안에 작동하는 통합을 완성할 수 있습니다. upscaleimg.app에서 계정을 만들고, API 키를 받고, 첫 테스트 이미지를 보내보세요.

먼저 2배로 몇 장 테스트해서 품질을 확인하세요. 만족스러우면 파이프라인에 통합하세요. AI 이미지 확대 완벽 가이드에서 AI 업스케일링에 대해 더 자세히 알아볼 수 있습니다.

무료 플랜으로 테스트와 PoC 구축이 가능합니다. 4배 업스케일링과 더 많은 처리량이 필요하면 유료 플랜으로 업그레이드하세요.