이미지 API

이미지 처리 (Image Processing)

Weekerp Image API는 URL 파라미터만으로 다음과 같은 처리를 제공합니다.

• 리사이즈 (width / height / size)

• 포맷 변환 (JPEG, PNG, WebP, AVIF 등)

• 품질 조정 (quality)

• 리사이즈 전략 (fit)

• 포지션 지정 (position)

모든 처리는 요청 시점에 수행되며 최초 1회 요청 시 변환된 결과가 CDN 엣지에 캐싱됩니다. 이후 동일한 요청은 캐시에서 바로 송신됩니다.

캐싱된 이미지를동일한 파라미터로 재요청하는 경우, 이미 변환된 캐시 이미지가 즉시 반환되어 지연 없이 응답합니다.

자세한 사항은 캐시 문서를 참고해주세요.

기본 요청 형식

https://cdn.weekerp.com/image/{source}/{path/to/image}.{ext}?{options}

---

예시

설명	요청 URL
너비 800px, 비율 자동 조정	https://cdn.weekerp.com/image/demo/photo.jpg?w=800
400×400 정사각형으로 리사이즈	https://cdn.weekerp.com/image/demo/photo.jpg?w=400&h=400&fit=cover
70% 품질로 압축	https://cdn.weekerp.com/image/demo/photo.jpg?w=1200&q=70

옵션

옵션	별칭 (Alias)	설명	예시
size	size, s	width/height 일괄 지정	"800x600"
width	width, w	가로(px) 지정	number → 800
height	height, h	세로(px) 지정	number → 600
format	format, f	출력 포맷 지정	'webp', 'avif', 'jpg', 'png', 'gif', 'tiff', 'svg'
quality	quality, q	압축 품질(1~100)	number → 80
fit	fit	리사이즈 방식	'cover', 'contain', 'fill', 'inside', 'outside'
position	position, p	잘림 기준 위치	'centre', 'top', 'bottom', 'left', 'right'

참고

• 원본 이미지는 변경되지 않습니다.

• 변환된 이미지는 CDN 캐시에 저장되어 동일 요청 시 즉시 서빙됩니다.

• 기본 응답 포맷은 원본 확장자를 기준으로 하며, f 파라미터를 사용해 WebP, AVIF 등의 포맷으로 변환할 수 있습니다.

예: https://cdn.weekerp.com/image/demo/photo.jpg?w=800&f=webp

---

권장사항

• 최대 응답 크기는 1MB를 권장합니다. (현재 베타 버전 제한, 즉각 처리요청 [e-mail])

• 너무 큰 원본 이미지는 CDN 처리 과정에서 변환 실패가 발생할 수 있습니다.

• 필요 시 고용량 이미지는 /file 엔드포인트를 통해 직접 서빙하는 것을 권장합니다.