이미지 최적화

쿼리 매개변수를 사용하여 IPFS에서 제공되는 이미지를 실시간으로 변환하고 최적화하세요. 인증이 필요 없는 공개 엔드포인트입니다.

이미지 최적화

GET /image/:cid

주어진 CID의 이미지를 제공된 쿼리 매개변수에 따라 변환하여 반환합니다. 매개변수가 제공되지 않으면 요청은 원본 이미지로 리다이렉트됩니다.

경로 매개변수

매개변수	유형	필수	설명
cid	string	예	이미지의 IPFS 콘텐츠 식별자.

쿼리 매개변수

매개변수	유형	기본값	설명
w	number	—	출력 너비 (픽셀). 최대 4096.
h	number	—	출력 높이 (픽셀). 최대 4096.
format	string	—	출력 형식: webp, jpeg, png 또는 avif.
quality	number	80	압축 품질, 1-100. format이 설정된 경우에만 적용됩니다.
fit	string	cover	이미지가 치수에 맞는 방식: cover, contain, fill, inside 또는 outside.

적합 모드

모드	동작
cover	두 치수를 모두 덮도록 자릅니다 (기본).
contain	종횡비를 유지하면서 두 치수 안에 맞춥니다. 빈 공간이 남을 수 있습니다.
fill	두 치수를 정확히 채우도록 늘립니다. 이미지가 왜곡될 수 있습니다.
inside	contain과 유사하지만 축소만 하고 확대하지 않습니다.
outside	cover와 유사하지만 축소만 하고 확대하지 않습니다.

요청 예시

너비 400px로 리사이즈, WebP로 변환:

curl "https://api.ipfs.ninja/image/QmXmCX9S6ANV...?w=400&format=webp"

200x200 썸네일로 리사이즈 및 자르기, JPEG 60% 품질:

curl "https://api.ipfs.ninja/image/QmXmCX9S6ANV...?w=200&h=200&format=jpeg&quality=60&fit=cover"

HTML에서 사용

최적화된 이미지를 img 태그에서 직접 참조하세요:

<img
  src="https://api.ipfs.ninja/image/QmXmCX9S6ANV...?w=800&format=webp&quality=75"
  alt="Optimized IPFS image"
/>

srcset으로 다양한 크기 제공:

<img
  srcset="
    https://api.ipfs.ninja/image/QmXmCX9S6ANV...?w=400&format=webp 400w,
    https://api.ipfs.ninja/image/QmXmCX9S6ANV...?w=800&format=webp 800w,
    https://api.ipfs.ninja/image/QmXmCX9S6ANV...?w=1200&format=webp 1200w
  "
  sizes="(max-width: 600px) 400px, (max-width: 1000px) 800px, 1200px"
  src="https://api.ipfs.ninja/image/QmXmCX9S6ANV...?w=800&format=webp"
  alt="Responsive IPFS image"
/>

캐싱

응답은 불변 캐시 헤더와 함께 제공됩니다. IPFS 콘텐츠는 콘텐츠 주소 지정이므로 동일한 CID와 동일한 매개변수는 항상 동일한 출력을 생성합니다. 브라우저와 CDN은 이러한 응답을 무기한 캐시할 수 있습니다.

가용성

이미지 최적화는 무료 Dharma 플랜을 포함한 모든 플랜에서 사용할 수 있습니다.