Görüntü Optimizasyonu

IPFS'ten sunulan görüntüleri sorgu parametreleri kullanarak anında dönüştürün ve optimize edin. Bu, kimlik doğrulama gerektirmeyen genel bir uç noktadır.

Görüntüyü Optimize Et

GET /image/:cid

Verilen CID'deki görüntüyü, sağlanan sorgu parametrelerine göre dönüştürülmüş olarak döndürür. Parametre sağlanmazsa, istek orijinal görüntüye yönlendirilir.

Yol parametreleri

Parametre	Tür	Zorunlu	Açıklama
cid	string	Evet	Görüntünün IPFS içerik tanımlayıcısı.

Sorgu parametreleri

Parametre	Tür	Varsayılan	Açıklama
w	number	—	Çıkış genişliği piksel cinsinden. Maksimum 4096.
h	number	—	Çıkış yüksekliği piksel cinsinden. Maksimum 4096.
format	string	—	Çıkış formatı: webp, jpeg, png veya avif.
quality	number	80	Sıkıştırma kalitesi, 1-100. Yalnızca format ayarlandığında uygulanır.
fit	string	cover	Görüntünün boyutlara nasıl sığdırılacağı: cover, contain, fill, inside veya outside.

Sığdırma modları

Mod	Davranış
cover	Her iki boyutu da kaplayacak şekilde kırp (varsayılan).
contain	En boy oranını koruyarak her iki boyuta sığdır. Boş alan bırakabilir.
fill	Her iki boyutu tam olarak dolduracak şekilde gerdirin. Görüntüyü bozabilir.
inside	contain gibi, ancak yalnızca küçültür, asla büyütmez.
outside	cover gibi, ancak yalnızca küçültür, asla büyütmez.

Örnek istekler

400 piksel genişliğe yeniden boyutlandır, WebP'ye dönüştür:

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

%60 kalitede JPEG olarak 200x200 küçük resme yeniden boyutlandır ve kırp:

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

HTML'de kullanım

Optimize edilmiş görüntüleri doğrudan img etiketlerinde referans alın:

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

srcset ile farklı boyutlar sunun:

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

Önbellekleme

Yanıtlar değişmez önbellek başlıklarıyla sunulur. IPFS içeriği içerik adreslemeli olduğundan, aynı CID ile aynı parametreler her zaman aynı çıktıyı üretir. Tarayıcılar ve CDN'ler bu yanıtları süresiz olarak önbelleğe alabilir.

Erişilebilirlik

Görüntü optimizasyonu, ücretsiz Dharma planı dahil tüm planlarda mevcuttur.