API 문서

Image Optimizer

이미지를 WebP 및 AVIF으로 변환하여 최대 80%의 파일 크기를 줄입니다. 완전한 REST API, WordPress 플러그인 및 글로벌 CDN 전송을 제공합니다.

80%

평균 절감량

50ms

응답 시간

20+

CDN 위치

99.9%

가동 시간 SLA

개요

Jetweb Image Optimizer은 귀하의 이미지를 현대적인 WebP 및 AVIF 형식으로 변환하는 고성능 이미지 변환 서비스입니다. 당사의 API는 밀리초 단위로 이미지를 처리하고 글로벌 CDN를 통해 번개처럼 빠른 로딩으로 전달합니다.

WordPress 사이트, 전자상거래 플랫폼 또는 맞춤형 웹 애플리케이션을 구축하든, Jetweb는 어떤 규모로든 최적화된 이미지를 제공할 수 있는 도구를 제공합니다.

기능

WebP 변환

전 세계 97% 이상의 브라우저 지원

AVIF 형식

차세대 압축 (Starter+)

일괄 처리

요청당 최대 10개 이미지

글로벌 CDN

전 세계 20개 이상의 엣지 위치

서명된 URL

암호학적으로 안전한 전송

WordPress 플러그인

원클릭 설치

지원 형식

최적화된 압축 알고리즘으로 모든 주요 이미지 형식을 지원합니다:

입력 형식	출력 형식	일반적인 절감 효과	최대 크기
JPEG (.jpg, .jpeg)	WebP, AVIF	50-70%	50 MB
PNG (.png)	WebP, AVIF	60-80%	50 MB
GIF (.gif)	WebP (animated)	40-60%	50 MB
WebP (.webp)	AVIF	20-40%	50 MB
BMP (.bmp)	WebP, AVIF	80-95%	50 MB

WordPress 플러그인

공식 WordPress 플러그인으로 몇 분 만에 시작하세요. 설정 없이 모든 미디어 업로드를 자동으로 최적화합니다.

설치

다운로드 Jetweb 대시보드에서 플러그인을 다운로드하세요.

업로드 WordPress 관리자 → 플러그인 → 새로 추가 → 플러그인 업로드를 통해 업로드하세요.

활성화 Jetweb Image Optimizer 플러그인을 활성화하세요.

설정 설정 → Jetweb Image Optimizer에서 구성하세요.

API 키 입력 API 키 페이지에서 API 키를 입력하세요.

플러그인 설정

Setting	Description	Default
API 키	귀하의 Jetweb 액세스 토큰 (jw_로 시작)	필수
출력 형식	WebP (모든 요금제) 또는 AVIF (Starter 이상)	WebP
품질	압축 품질 1-100	85
자동 최적화	업로드 시 이미지 최적화	활성화됨
CDN 사용	Jetweb CDN에서 제공	활성화됨

REST API

당사의 REST API를 사용하여 맞춤형 통합을 구축하십시오. 모든 요청은 X-Access Token 헤더를 통한 인증이 필요합니다.

인증

                headers
                
                X-Access-Token: jw_your_api_key_here
Content-Type: multipart/form-data

단일 이미지 변환

                POST /convert
                
              

                # Request
POST https://image-optimizer.api.jetweb.app/convert

# Form Data
file:    [binary]     # Image file
format:  webp         # webp | avif
quality: 85           # 1-100

# Response Headers
X-Original-Size:  156789
X-Converted-Size: 45678
X-Savings:        71%
X-CDN-URL-WebP:   https://cdn.jetweb.app/abc123.webp?sig=...
              

일괄 변환

                POST /convert/batch
                
              

                # Request (up to 10 images)
POST https://image-optimizer.api.jetweb.app/convert/batch

files[]: [image1.jpg]
files[]: [image2.png]
format:  webp
quality: 85

# Response
{
  "success": true,
  "results": [
    { "filename": "image1.jpg", "savings": "68%", "cdnUrl": "..." },
    { "filename": "image2.png", "savings": "75%", "cdnUrl": "..." }
  ],
  "totalProcessed": 2
}
              

CDN 통합

변환된 모든 이미지는 당사의 글로벌 CDN에 자동으로 저장됩니다. 제공된 서명된 URL을 HTML에서 직접 사용하십시오:

              usage.html
              
            

              <!-- Modern browsers with fallback -->
<picture>
  <source srcset="https://cdn.jetweb.app/abc.avif?sig=..." type="image/avif">
  <source srcset="https://cdn.jetweb.app/abc.webp?sig=..." type="image/webp">
  <img src="/original.jpg" alt="Description" loading="lazy">
</picture>
            

품질 설정

사용 사례에 따라 최적의 품질 설정을 선택하십시오:

품질	사용 사례	파일 크기	시각적 품질
90-100	사진, 제품 이미지	더 큼	무손실/거의 무손실
80-90	일반 웹 이미지	균형적	탁월함 (권장)
60-80	썸네일, 배경	더 작음	양호함
<60	최대 압축	가장 작음	수용 가능함

요율 제한 및 가격

API 요율 제한 및 월별 할당량은 요금제에 따라 다릅니다:

무료

0€/mo

50 images/month

WebP only
10 req/min
No CDN

스타터

2,99€/mo

500 images/month

WebP + AVIF
30 req/min
CDN included

Pro

5,99€/mo

월 2,000개 이미지

WebP + AVIF
60 req/min
CDN + Priority

Business

9,99€/mo

월 10,000개 이미지

All formats
120 req/min
Priority support

속도 제한 헤더: X-RateLimit-Remaining, X-RateLimit-Reset

오류 코드

API는 설명이 포함된 표준 HTTP 상태 코드를 반환합니다:

코드	오류	설명
400	잘못된 요청	유효하지 않은 매개변수 또는 필수 필드 누락
401	권한 없음	API 키 누락 또는 유효하지 않음
403	금지됨	요금제 한도 초과 또는 사용할 수 없는 기능
413	페이로드 너무 큼	파일이 50MB 제한을 초과함
415	지원되지 않는 미디어	지원되지 않는 파일 형식
429	요청이 너무 많음	속도 제한 초과
500	서버 오류	내부 처리 오류

문제 해결

"월간 변환 한도 초과"

요금제의 월간 할당량에 도달했습니다. 요금제를 업그레이드하거나 다음 결제 주기를 기다리십시오(매월 1일에 초기화).

"잘못된 액세스 토큰"

API 키 페이지에서 API 키를 확인하십시오. 키는 jw_로 시작해야 합니다.

"파일이 너무 큼"

최대 파일 크기는 50MB입니다. 업로드 전에 이미지 크기를 조정하거나 먼저 압축 도구를 사용하십시오.

"속도 제한 초과"

속도 제한 창이 초기화될 때까지 기다리십시오(X-RateLimit-Reset 헤더에 표시됨) 또는 요금제를 업그레이드하십시오.

자주 묻는 질문

WebP는 97% 이상의 브라우저 지원률로 우수한 압축을 제공합니다. AVIF은 20-30% 더 나은 압축률을 제공하지만 약 92%의 브라우저 지원률을 가집니다. 최대 호환성을 위해 WebP를, 최신 브라우저를 대상으로 할 때는 AVIF을 권장합니다.

변환된 이미지는 마지막 접근일로부터 30일 동안 저장됩니다. 활성 이미지(30일 이내에 접근된)는 무기한 보관됩니다. 서명된 URL은 1년 동안 유효합니다.

예! 당사의 REST API는 모든 프레임워크와 호환됩니다. Next.js의 경우, 빌드 시 서버 측 변환을 사용하거나, Jetweb URL에 대해 next/image 최적화를 비활성화한 상태에서 당사의 CDN URL을 직접 사용하는 것을 권장합니다.

기본적으로 더 작은 파일 크기와 개인정보 보호를 위해 EXIF 메타데이터를 제거합니다. 요청에 preserve_metadata=true를 추가하여 보존할 수 있습니다.

예! 대량 처리(월 50,000장 이상의 이미지)가 필요한 경우, 맞춤형 가격 및 전담 지원을 위해 [email protected]으로 문의해 주십시오.

최적화할 준비가 되셨나요?

몇 분 안에 이미지 변환을 시작하세요. 무료 요금제는 월 50장의 이미지를 포함합니다.

무료로 시작하기 지원팀에 문의