Bildoptimering

Transformera och optimera bilder som serveras från IPFS direkt med frågeparametrar. Detta är en offentlig endpoint som inte kräver autentisering.

Optimera bild

GET /image/:cid

Returnerar bilden vid angiven CID, transformerad enligt angivna frågeparametrar. Om inga parametrar anges omdirigeras begäran till originalbilden.

Sökvägsparametrar

Parameter	Typ	Obligatorisk	Beskrivning
cid	string	Ja	Bildens IPFS-innehållsidentifierare.

Frågeparametrar

Parameter	Typ	Standard	Beskrivning
w	number	—	Utdatabredd i pixlar. Max 4096.
h	number	—	Utdatahöjd i pixlar. Max 4096.
format	string	—	Utdataformat: webp, jpeg, png, eller avif.
quality	number	80	Komprimeringskvalitet, 1-100. Gäller bara när format är satt.
fit	string	cover	Hur bilden ska passa dimensionerna: cover, contain, fill, inside, eller outside.

Passningslägen

Läge	Beteende
cover	Beskär för att täcka båda dimensionerna (standard).
contain	Passa inom båda dimensionerna, bevara bildförhållandet. Kan lämna tomt utrymme.
fill	Sträck för att fylla båda dimensionerna exakt. Kan förvränga bilden.
inside	Som contain, men skalar bara ner, aldrig upp.
outside	Som cover, men skalar bara ner, aldrig upp.

Exempelbegäranden

Ändra storlek till 400px bred, konvertera till WebP:

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

Ändra storlek och beskär till 200x200 miniatyr som JPEG med 60% kvalitet:

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

Användning i HTML

Referera optimerade bilder direkt i img-taggar:

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

Servera olika storlekar med 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="Responsiv IPFS-bild"
/>

Cache

Svar serveras med oföränderliga cache-rubriker. Eftersom IPFS-innehåll är innehållsadresserat producerar samma CID med samma parametrar alltid samma utdata. Webbläsare och CDN:er kan cacha dessa svar på obestämd tid.

Tillgänglighet

Bildoptimering är tillgänglig på alla planer, inklusive den gratis Dharma-planen.