Optimización de Imágenes

Transforma y optimiza imágenes servidas desde IPFS al vuelo usando parámetros de consulta. Este es un endpoint público que no requiere autenticación.

Optimizar Imagen

GET /image/:cid

Devuelve la imagen en el CID dado, transformada según los parámetros de consulta proporcionados. Si no se proporcionan parámetros, la solicitud redirige a la imagen original.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
cid	string	Sí	El identificador de contenido IPFS de la imagen.

Parámetros de consulta

Parámetro	Tipo	Por defecto	Descripción
w	number	—	Ancho de salida en píxeles. Máximo 4096.
h	number	—	Alto de salida en píxeles. Máximo 4096.
format	string	—	Formato de salida: webp, jpeg, png o avif.
quality	number	80	Calidad de compresion, 1-100. Solo aplica cuando format está configurado.
fit	string	cover	Como la imagen debe ajustarse a las dimensiones: cover, contain, fill, inside o outside.

Modos de ajuste

Modo	Comportamiento
cover	Recortar para cubrir ambas dimensiones (por defecto).
contain	Ajustar dentro de ambas dimensiones, preservando la relación de aspecto. Puede dejar espacio vacío.
fill	Estirar para llenar ambas dimensiones exactamente. Puede distorsionar la imagen.
inside	Como contain, pero solo reduce, nunca aumenta.
outside	Como cover, pero solo reduce, nunca aumenta.

Ejemplos de solicitudes

Redimensionar a 400px de ancho, convertir a WebP:

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

Redimensionar y recortar a miniatura de 200x200 como JPEG al 60% de calidad:

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

Uso en HTML

Referencia imágenes optimizadas directamente en etiquetas img:

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

Sirve diferentes tamanos con 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="Responsive IPFS image"
/>

Cache

Las respuestas se sirven con encabezados de cache inmutables. Dado que el contenido IPFS es direccionado por contenido, el mismo CID con los mismos parámetros siempre produce la misma salida. Los navegadores y CDNs pueden almacenar estas respuestas en cache indefinidamente.

Disponibilidad

La optimización de imágenes está disponible en todos los planes, incluido el plan gratuito Dharma.