Contentful Images
Sirve las fotos de tu web ya recortadas, ligeras y en el formato que necesitas.
Ver la documentaciónPara qué sirve
Qué problema resuelve
Contentful Images es la forma de Contentful de entregar las imágenes que ya tienes guardadas en tu espacio de contenidos. No es otro banco de fotos: es un «taller» que toma la misma imagen y, al vuelo, la deja del tamaño, el recorte y el formato que pide tu web o tu app.
Así evitas subir cinco versiones de cada foto a mano. Subes una, y con la dirección de esa imagen (más unos ajustes al final de la URL) pides la versión para móvil, para portada o para miniatura.
En la práctica
Qué puedes hacer con ella
- Hacer que una foto pese menos y cargue más rápido en el móvil (por ejemplo pasándola a WebP o AVIF).
- Pedir un ancho o alto concreto sin abrir Photoshop: la imagen llega ya a esa medida.
- Recortar para un marco fijo (cuadrado, banner…) y, si hace falta, centrar en una cara detectada automáticamente.
- Bajar o subir la calidad para equilibrar nitidez y peso del archivo.
- Redondear esquinas o recortar en círculo para avatares e iconos.
- Rellenar el fondo cuando la imagen no llena del todo el marco que pediste.
¿Es gratis?
Gratis con límites claros
Con el plan Free de Contentful ($0) puedes crear una cuenta, tener un espacio Starter y usar esta capa de imágenes sobre las fotos de ese espacio. El Free está pensado para aprender, probar y proyectos no comerciales: si lo usas para un negocio en producción, Contentful puede pedirte que pases a un plan de pago. Al llegar al tope mensual de llamadas o de tráfico de imágenes, la entrega se pausa hasta el mes siguiente o hasta que subas de plan (no hay «pagar el exceso» en Free).
Comprobado el 2026-08-02. Fuente: página oficial de precios o límites
Crear cuenta Free en Contentful
Qué cuenta como una «llamada» o un «request» aquí
En Contentful no hablamos de tokens de inteligencia artificial. Una «API call» (llamada a la API) es cada vez que tu web, tu app o una herramienta pide o modifica datos del espacio: leer contenidos, previsualizarlos o administrarlos. La Images API transforma y sirve fotos; esas entregas pesan sobre todo en el contador de tráfico de imágenes (CDN), medido en gigabytes al mes, no en «tokens».
En la práctica: cada visita que carga una foto desde Contentful consume un trozo de esos 50 GB. Pedir la misma foto más pequeña o en WebP suele gastar menos. Las 100.000 llamadas/mes cubren el resto de APIs del plan (gestión, entrega y preview de contenidos), no un cupo aparte solo de «tokens».
Límites y cuotas del plan Free
| Límite | Cuota | Qué significa en la práctica |
|---|---|---|
| Llamadas API (CMA + CPA + CDA) | 100.000 / mes | Cada petición de lectura, preview o administración de contenidos cuenta 1. No son tokens de IA: son peticiones HTTP al servicio. |
| Tráfico de imágenes (CDN) | 50 GB / mes | Suma del peso de las fotos (y otros assets) que la gente descarga. Una foto de 200 KB vista 5.000 veces ≈ 1 GB. |
| Extras al superar el tope | No permitidos | En Free no puedes comprar más cuota. Al llegar al límite, la entrega se pausa hasta el mes siguiente o hasta subir de plan. |
| Espacio Starter incluido | 1 | Un espacio de proyecto con techos de tipos de contenido, registros y entornos (ver precios oficiales). |
| Usuarios / roles / idiomas | 10 · 2 · 2 | Hasta 10 personas, 2 roles (Admin y Editor) y 2 locales en el plan Free de plataforma. |
| Tamaño máximo al subir un archivo | 50 MB | Límite por asset al subirlo al Media library; no confundir con el tráfico mensual de descarga. |
Tabla de precios (capa Free y planes de pago)
| Plan | Precio | Para quién | Qué incluye (resumen) |
|---|---|---|---|
| Free | $0 / forever | Aprender, explorar y proyectos no comerciales. | 100K llamadas/mes · 50 GB CDN · 1 Starter Space · Image API incluida |
| Lite | desde $300 / mes | Negocios pequeños con un proyecto en producción. | 1M llamadas/mes · 100 GB CDN · más usuarios, roles y colaboración |
| Enterprise | A medida | Equipos grandes, seguridad avanzada y escala. | Llamadas ilimitadas · CDN a medida · soporte y cumplimiento reforzados |
Uso permitido, comercial y licencia
| Pregunta | Respuesta clara |
|---|---|
| ¿Es software libre / open source? | No. Contentful es un servicio comercial con cuenta y condiciones propias. La Images API forma parte de ese servicio. |
| ¿Puedo usarlo gratis en un negocio? | No de forma general. El Free solo permite el caso de uso autorizado: probar y aprender. No está pensado para casos comerciales. |
| ¿Sirve Free para producción comercial? | No. Los términos limitan el uso free/trial a casos no productivos; para un sitio o app de negocio hace falta un plan de pago. |
| ¿Para qué sí vale el Free? | Aprender, demos, proyectos personales, hackathons o apoyar un no-lucrativo local, según la propia FAQ del plan Free. |
| ¿Hace falta cuenta de desarrollador? | Sí: hay que registrarse. El alta Free no pide tarjeta. Enlace directo al registro en el botón de esta sección. |
| ¿Quién es dueño de mis fotos? | Tú subes y gestionas tu contenido; el servicio entrega y transforma según tu cuenta. Revisa siempre los términos vigentes. |
Cómo empezar
Ver en el navegador una foto tuya de Contentful ya aligerada para móvil.
Hace falta una cuenta Free de Contentful y al menos una imagen subida a tu espacio. No hace falta saber programar para la prueba: se hace con la barra de direcciones del navegador.
Dirección base de las imágenes: https://images.ctfassets.net
- 01
Paso 1
Crea una cuenta Free en https://www.contentful.com/sign-up/ (no pide tarjeta) y abre el espacio donde vas a subir una imagen.
- 02
Paso 2
Sube una foto en Media (o ábrela si ya estaba). En el detalle del archivo verás una dirección web de la imagen; cópiala entera. Suele empezar por images.ctfassets.net o //images.ctfassets.net.
- 03
Paso 3
Pégala en una pestaña nueva del navegador. Si ves la foto a tamaño original, vas bien: esa es la imagen «en bruto» que Contentful guarda.
- 04
Paso 4
Al final de esa misma dirección, añade (o completa) una interrogación y estos ajustes: ?w=800&fm=webp&q=80. La w es el ancho en píxeles, fm el formato (aquí WebP, más ligero) y q la calidad del 1 al 100. Ejemplo: …/mi-foto.jpg?w=800&fm=webp&q=80.
- 05
Paso 5
Recarga. Deberías ver la misma foto más estrecha y, a menudo, con menos peso. Si quieres un recorte cuadrado centrado en una cara, prueba ?w=400&h=400&fit=thumb&f=face&fm=webp.
- 06
Paso 6
Esa URL ya transformada es la que puedes usar en tu web (en una etiqueta de imagen, en un CMS o pidiéndole a tu agente que la deje cableada). No hace falta regenerar archivos a mano cada vez que cambies el tamaño.
- 07
Paso 7
Mira de vez en cuando el uso del plan Free en Contentful: si te acercas a 100.000 llamadas o a 50 GB de tráfico de imágenes al mes, o bajas el tamaño/calidad, o subes de plan. Detalle oficial: https://www.contentful.com/help/admin/usage/usage-limit/
Con tu agente
Prompt para integrar la API
Prompt para que tu agente lo deje listo
Pega esto en Cursor, Claude Code, Codex u otro agente de código:
Integra la Images API de Contentful en este proyecto. Documentación oficial: https://www.contentful.com/developers/docs/references/images-api/. Registro: https://www.contentful.com/sign-up/. Precios y Free: https://www.contentful.com/pricing/. Límites: https://www.contentful.com/help/admin/usage/usage-limit/. No inventes spaceId ni URLs de assets: pídeme la URL de un asset real (o cómo obtenerla) y qué transformaciones quiero. Usa solo query params documentados en images.ctfassets.net. Recuérdame que Free no es para uso comercial/producción y que el tope es 100K API calls/mes y 50 GB CDN/mes sin overages.Detalle técnico
Acceso, HTTPS y CORS
- 01
Acceso · Clave gratuita
Pide una clave que se obtiene con un alta gratuita en el propio servicio.
- 02
HTTPS · Sí
Sirve sobre TLS, así que vale para producción y para páginas ya en HTTPS.
- 03
CORS · Sí
Permite llamarla directamente desde el navegador sin proxy intermedio.