การปรับแต่งรูปภาพ

แปลงและปรับแต่งรูปภาพที่ให้บริการจาก IPFS แบบ on-the-fly โดยใช้พารามิเตอร์คิวรี นี่คือ endpoint สาธารณะที่ไม่ต้องยืนยันตัวตน

ปรับแต่งรูปภาพ

GET /image/:cid

ส่งคืนรูปภาพที่ CID ที่กำหนด แปลงตามพารามิเตอร์คิวรีที่ให้มา หากไม่มีพารามิเตอร์ คำขอจะเปลี่ยนเส้นทางไปยังรูปภาพต้นฉบับ

พารามิเตอร์ path

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
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

โหมด fit

โหมด	พฤติกรรม
cover	ครอปเพื่อให้ครอบคลุมทั้งสองมิติ (ค่าเริ่มต้น)
contain	พอดีภายในทั้งสองมิติ รักษาอัตราส่วน อาจมีพื้นที่ว่าง
fill	ยืดให้เต็มทั้งสองมิติ อาจบิดเบือนรูปภาพ
inside	เหมือน contain แต่ลดขนาดเท่านั้น ไม่ขยาย
outside	เหมือน cover แต่ลดขนาดเท่านั้น ไม่ขยาย

ตัวอย่างคำขอ

ปรับขนาดเป็นความกว้าง 400px แปลงเป็น WebP:

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

ปรับขนาดและครอปเป็น 200x200 thumbnail เป็น JPEG คุณภาพ 60%:

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

ใช้ใน HTML

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

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

การแคช

การตอบกลับมาพร้อมเฮดเดอร์แคชแบบ immutable เนื่องจากเนื้อหา IPFS มีการระบุด้วยเนื้อหา CID เดียวกันกับพารามิเตอร์เดียวกันจะสร้างเอาต์พุตเดียวกันเสมอ

ความพร้อมใช้งาน

การปรับแต่งรูปภาพมีให้ในทุกแผน รวมถึงแผน Dharma ฟรี