Bildoptimierung

Transformieren und optimieren Sie Bilder von IPFS on-the-fly mithilfe von Abfrageparametern. Dies ist ein öffentlicher Endpunkt, der keine Authentifizierung erfordert.

Bild optimieren

GET /image/:cid

Gibt das Bild mit dem angegebenen CID zurück, transformiert gemäß den bereitgestellten Abfrageparametern. Wenn keine Parameter angegeben werden, leitet die Anfrage zum Originalbild weiter.

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
cid	string	Ja	Der IPFS Content Identifier des Bildes.

Abfrageparameter

Parameter	Typ	Standard	Beschreibung
w	number	—	Ausgabebreite in Pixel. Max. 4096.
h	number	—	Ausgabehöhe in Pixel. Max. 4096.
format	string	—	Ausgabeformat: webp, jpeg, png oder avif.
quality	number	80	Komprimierungsqualität, 1-100. Gilt nur, wenn format gesetzt ist.
fit	string	cover	Wie das Bild in die Dimensionen eingepasst werden soll: cover, contain, fill, inside oder outside.

Einpassungsmodi

Modus	Verhalten
cover	Zuschneiden, um beide Dimensionen abzudecken (Standard).
contain	In beide Dimensionen einpassen, Seitenverhältnis beibehalten. Kann leeren Raum hinterlassen.
fill	Auf beide Dimensionen exakt strecken. Kann das Bild verzerren.
inside	Wie contain, skaliert aber nur herunter, nie hoch.
outside	Wie cover, skaliert aber nur herunter, nie hoch.

Beispielanfragen

Auf 400px Breite skalieren, in WebP konvertieren:

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

Skalieren und auf 200x200 Vorschaubild als JPEG mit 60% Qualität zuschneiden:

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

Verwendung in HTML

Referenzieren Sie optimierte Bilder direkt in img-Tags:

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

Stellen Sie verschiedene Größen mit srcset bereit:

<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"
/>

Caching

Antworten werden mit unveränderlichen Cache-Headern ausgeliefert. Da IPFS-Inhalte inhaltsadressiert sind, erzeugen derselbe CID mit denselben Parametern immer dieselbe Ausgabe. Browser und CDNs können diese Antworten unbegrenzt zwischenspeichern.

Verfügbarkeit

Bildoptimierung ist in allen Plänen verfügbar, einschließlich des kostenlosen Dharma-Plans.