Snapkit Logo

외부 URL 이미지 변환#

Snapkit에 업로드하지 않은 외부 URL의 이미지도 실시간으로 변환할 수 있습니다. Slack 프로필 사진, 외부 CDN 이미지 등을 직접 가져와 리사이징, 포맷 변환 등의 처리를 수행합니다.

사용 사례#

  • Slack/Discord 아바타: 프로필 이미지를 최적화된 크기와 포맷으로 변환
  • 외부 CDN 이미지: 다른 서비스의 이미지를 WebP/AVIF로 변환
  • 임시 이미지 처리: 업로드 없이 빠르게 이미지 변환 테스트

URL 형식#

기본 형식#

GET https://cdn.snapkit.studio/external?url={인코딩된_외부URL}&transform={파라미터}

중요: url 파라미터의 외부 URL은 반드시 URL 인코딩해야 합니다. 인코딩하지 않으면 쿼리 파라미터가 올바르게 파싱되지 않습니다.

플랜CDN 도메인
Standardcdn.snapkit.studio
Enterprise사용자 지정 도메인 (예: cdn.yourcompany.com)

사용 예제#

기본 변환 (WebP)#

# Slack 아바타를 WebP로 변환
# 원본 URL: https://ca.slack-edge.com/T04MAT2PXJ4-U0953CM4ZV3-ea508a85b199-512
curl "https://cdn.snapkit.studio/external?url=https%3A%2F%2Fca.slack-edge.com%2FT04MAT2PXJ4-U0953CM4ZV3-ea508a85b199-512&transform=format:webp"

리사이징 + 포맷 변환#

# 800px 너비로 리사이징 + AVIF 변환
# 원본 URL: https://example.com/photo.jpg
curl "https://cdn.snapkit.studio/external?url=https%3A%2F%2Fexample.com%2Fphoto.jpg&transform=w:800,format:avif,quality:85"

복합 변환 (크롭 + 효과)#

# 정사각형 크롭 + 그레이스케일
# 원본 URL: https://example.com/photo.jpg
curl "https://cdn.snapkit.studio/external?url=https%3A%2F%2Fexample.com%2Fphoto.jpg&transform=w:400,h:400,fit:cover,grayscale"

Enterprise 커스텀 도메인#

# Enterprise 고객은 자체 CDN 도메인 사용
# 원본 URL: https://example.com/image.jpg
curl "https://cdn.yourcompany.com/external?url=https%3A%2F%2Fexample.com%2Fimage.jpg&transform=w:600,format:webp"

Transform 파라미터#

외부 URL 변환도 일반 이미지 변환과 동일한 파라미터를 지원합니다:

파라미터타입설명
wnumber너비 (1-16384px)
hnumber높이 (1-16384px)
formatstringjpeg, png, webp, avif, auto
qualitynumber품질 (1-100)
fitstringcontain, cover, fill, inside, outside
dprnumberDevice Pixel Ratio (1.0-4.0)

전체 변환 파라미터 보기 →

제한사항#

  • 파일 크기: 최대 50MB
  • 타임아웃: 60초 (외부 서버 응답 포함)
  • 외부 서버 의존: 외부 URL 서버의 가용성에 따라 실패 가능
  • Content-Type 정확성: 외부 서버의 Content-Type이 정확해야 최적 처리 가능

다음 단계#