Skip to content

Image Optimization

Mag-transform at mag-optimize ng mga imahe na served mula sa IPFS on-the-fly gamit ang mga query parameter. Ito ay public endpoint na hindi nangangailangan ng authentication.

I-optimize ang Imahe

GET /image/:cid

Ibinabalik ang imahe sa ibinigay na CID, na-transform ayon sa mga query parameter. Kung walang parameter, nagre-redirect sa original na imahe.

Path parameters

ParameterUriKinakailanganPaglalarawan
cidstringOoAng IPFS content identifier ng imahe.

Query parameters

ParameterUriDefaultPaglalarawan
wnumberOutput width sa pixels. Max 4096.
hnumberOutput height sa pixels. Max 4096.
formatstringOutput format: webp, jpeg, png, o avif.
qualitynumber80Compression quality, 1-100.
fitstringcoverPaano dapat mag-fit ang imahe: cover, contain, fill, inside, o outside.

Mga halimbawang request

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

Paggamit sa HTML

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

Caching

Ang mga response ay may immutable cache header. Available ang image optimization sa lahat ng plan.