Imágenes de stock
Una página de aterrizaje con un marcador de posición gris donde debería ir la imagen destacada está incompleta. Esto cubre la obtención de fotografías reales que sean gratuitas para uso comercial, que coincidan con el diseño y que no se rompan cuando alguien más cargue la página.
El endpoint que todos intentan primero está muerto
https://source.unsplash.com/1600x900/?coffee → HTTP 503
source.unsplash.com — el endpoint de imágenes aleatorias sin clave — fue retirado. Todavía aparece en publicaciones de blog y plantillas antiguas, y ahora devuelve 503. Si lo encuentras en un código base, eso es una imagen rota, no una que funcione.
Lo que sí funciona, sin clave, es la CDN cuando ya conoces un ID de foto:
https://images.unsplash.com/photo-1447933601403-0c6688de566e?auto=format&fit=crop&w=1600&q=80
Eso devuelve una imagen real. Pero no puedes buscar sin una clave, y inventar IDs de fotos no funciona. Entonces:
Obtener una clave (dos minutos, gratuita)
- Ve a https://unsplash.com/oauth/applications → Nueva Aplicación → acepta los términos
- Copia la Clave de Acceso
- Exhíbela como variable de entorno — nunca la confirmes en el repositorio:
export UNSPLASH_ACCESS_KEY="tu_clave_de_acceso"
El nivel de demostración es de 50 solicitudes/hora, lo cual es suficiente para una página de aterrizaje. Si el usuario no tiene una clave, díselo y pregúntale — no recurras silenciosamente a cajas grises ni inventes URLs.
curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
"https://api.unsplash.com/search/photos?query=neblina+costera&orientation=landscape&per_page=8" \
| python3 -c "
import json,sys
for p in json.load(sys.stdin)['results']:
print(p['id'], p['width'], p['height'], '|', (p.get('alt_description') or '')[:60])
print(' ', p['urls']['raw'])
print(' ', p['user']['name'], p['links']['download_location'])
"
Dos reglas de la API que son fáciles de pasar por alto
1. Enlaza directamente las URLs que devuelve la API. Los términos de la API de Unsplash requieren usar sus URLs de CDN en lugar de volver a alojar el archivo. Esto entra en conflicto con el consejo habitual de servir activos locales optimizados, y los términos prevalecen mientras estés usando la API. Si un cliente necesita archivos autoalojados, licencia la foto a través de Unsplash+ o cómprala en otro lugar — no la vuelvas a alojar silenciosamente esperando que funcione.
2. Activa el endpoint de descarga cuando una foto se use realmente. No cuando se previsualice — cuando se publique. Así es como los fotógrafos obtienen crédito por el uso, y es una condición de la API, no una cortesía.
curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
"$UBICACION_DESCARGA" # el valor de links.download_location del resultado de búsqueda
Límites de la licencia
La Licencia de Unsplash permite uso comercial y no comercial sin permiso y sin atribución requerida. No permite vender copias sin alteraciones, y no permite construir un servicio de fotos competidor. Las fotos pueden contener personas identificables, marcas comerciales o obras de arte — Unsplash no gestiona autorizaciones de modelo o propiedad, por lo que para cualquier cosa que implique respaldo (una persona que parece ser un cliente, una foto de testimonio) es mejor obtener una imagen con autorización.
La atribución no es obligatoria pero cuesta una línea y es lo correcto:
<!-- Foto: Jane Doe / Unsplash -->
Elegir bien
Buscar el sustantivo literal es lo que hace que una página parezca una plantilla. "Café" devuelve diez mil fotos idénticas de arte latte desde arriba.
Busca el estado de ánimo, no el tema. Para una tostaduría de café: taller industrial cálido, manos trabajando, luz matutina interior. Para una asesoría financiera: arquitectura serena, interior minimalista tranquilo, sombras largas.
Luego filtra por tres cosas que el diseño realmente condiciona:
- Orientación y colocación del sujeto. Una imagen destacada que se recorta con
object-fit: covernecesita que el sujeto esté descentrado o con espacio superior, o el recorte lo decapita. Verifica dónde se sitúa el sujeto antes de elegir — la aritmética del encuadre está en../landing-page/references/traps.md. - Rango tonal. El texto superpuesto necesita que la región detrás de él sea consistentemente clara u oscura. Una foto de tonos medios ocupados hace que cualquier color de texto sea incorrecto.
- Un fotógrafo, o un estilo visual. Tres imágenes de tres fotógrafos diferentes en una misma sección parecen de stock. Prefiere varios fotogramas de una misma sesión, o una gradación consistente.
Tamaños
Los parámetros de la CDN de Unsplash realizan el redimensionado, así que solicita el tamaño que mostrarás:
?auto=format&fit=crop&w=1600&q=80 héroe
?auto=format&fit=crop&w=800&q=80 tarjeta
?auto=format&fit=crop&w=192&h=192&q=80 avatar (cuadrado)
auto=format sirve WebP/AVIF a los navegadores que lo aceptan. Para imágenes destacadas responsivas, genera un srcset a 800/1200/1600/2000 en lugar de enviar un archivo de 2000px a los teléfonos.
Texto alternativo
alt describe lo que la imagen muestra, para alguien que no puede verla. No es un espacio para palabras clave ni el título de la foto.
<!-- incorrecto -->
<img alt="imagen destacada de la página de inicio de la tostaduría de café">
<!-- correcto -->
<img alt="Tostador vertiendo granos verdes en un tambor tostador en un taller">
Si la imagen es decorativa y el texto circundante ya lo dice todo, usa alt="" para que un lector de pantalla lo omita. Un alt vacío es correcto; un alt faltante no lo es.
Lista de verificación
-
UNSPLASH_ACCESS_KEYconfigurada, nunca confirmada en el repositorio - Se buscó por estado de ánimo, no por el sustantivo literal
- Se verificó la colocación del sujeto en relación con cómo recorta el espacio
- El rango tonal funciona con cualquier texto superpuesto
- Las imágenes en una misma sección comparten un estilo visual
- Las URLs de la CDN están enlazadas directamente como lo requiere la API — no re-alojadas
- Se activó
download_locationpara cada foto que se publica - Los parámetros de tamaño coinciden con el tamaño de visualización;
srcseten imágenes destacadas responsivas - Texto alternativo real, o
alt=""cuando es decorativo - No se asume autorización de modelo/propiedad para nada que implique respaldo