Imagens de Stock
Uma página inicial com um placeholder cinza onde o herói deveria estar está inacabada. Isso cobre a obtenção de fotografia real que seja gratuita para uso comercial, combine com o design, e não quebre quando outra pessoa carregar a página.
O endpoint que todo mundo tenta primeiro está morto
https://source.unsplash.com/1600x900/?coffee → HTTP 503
source.unsplash.com — o endpoint de imagem aleatória sem chave — foi descontinuado. Ele ainda está
por toda parte em posts de blog e templates mais antigos, e agora retorna 503. Se você o encontrar em um
código, isso é uma imagem quebrada, não uma funcional.
O que funciona, sem chave, é a CDN quando você já conhece um id de foto:
https://images.unsplash.com/photo-1447933601403-0c6688de566e?auto=format&fit=crop&w=1600&q=80
Isso retorna uma imagem real. Mas você não pode pesquisar sem uma chave, e inventar ids de fotos não funciona. Então:
Obtendo uma chave (dois minutos, gratuita)
- https://unsplash.com/oauth/applications → Novo Aplicativo → aceite os termos
- Copie a Chave de Acesso
- Exporte-a — nunca a commite:
export UNSPLASH_ACCESS_KEY="sua_chave_de_acesso"
A camada de demonstração é de 50 solicitações/hora, o que é suficiente para uma página inicial. Se o usuário não tiver uma chave, diga isso e peça — não caia silenciosamente para caixas cinzas e não invente URLs.
curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
"https://api.unsplash.com/search/photos?query=coastal+fog&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'])
"
Duas regras da API que são fáceis de esquecer
1. Use hotlink nos URLs que a API retorna. Os termos da API do Unsplash exigem o uso de seus URLs CDN em vez de re-hospedar o arquivo. Isso entra em conflito com o conselho usual de servir ativos locais otimizados, e os termos prevalecem enquanto você estiver usando a API. Se um cliente precisar de arquivos auto-hospedados, licencie a foto através do Unsplash+ ou compre em outro lugar — não re-hospede silenciosamente na esperança de que funcione.
2. Acione o endpoint de download quando uma foto for realmente usada. Não quando ela for pré-visualizada — quando for enviada. É assim que os fotógrafos recebem crédito pelo uso, e é uma condição da API, não uma cortesia.
curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
"$DOWNLOAD_LOCATION" # o valor links.download_location do resultado da pesquisa
Limites da licença
A Licença Unsplash permite uso comercial e não comercial sem permissão e sem atribuição obrigatória. Ela não permite vender cópias inalteradas, e não permite construir um serviço de fotos concorrente. As fotos podem conter pessoas identificáveis, marcas registradas ou obras de arte — o Unsplash não faz liberação de modelo ou propriedade, portanto, para qualquer coisa que implique endosso (uma pessoa parecendo ser um cliente, uma foto de depoimento) use uma imagem com liberação.
A atribuição não é obrigatória, mas custa uma linha e é a coisa certa a fazer:
<!-- Foto: Jane Doe / Unsplash -->
Escolhendo bem
Pesquisar pelo substantivo literal é o que faz uma página parecer um template. "Café" retorna dez mil fotos idênticas de latte art de cima.
Pesquise o clima, não o assunto. Para uma torrefação de café: oficina industrial quente,
mãos trabalhando, interior com luz matinal. Para uma consultoria de investimentos: arquitetura parada,
interior minimalista silencioso, sombras longas.
Em seguida, filtre por três coisas que o design realmente restringe:
- Orientação e posicionamento do assunto. Um herói que corta com
object-fit: coverprecisa do assunto descentralizado ou com espaço livre acima, ou o corte o decapita. Verifique onde o assunto está antes de escolher — a aritmética do enquadramento está em../landing-page/references/traps.md. - Faixa tonal. O texto sobreposto precisa que a região atrás dele seja consistentemente clara ou consistentemente escura. Uma foto de tom médio ocupada torna toda cor de texto errada.
- Um fotógrafo, ou um visual. Três imagens de três fotógrafos em uma seção parecem stock. Prefira vários quadros de uma única sessão, ou uma pós-produção consistente.
Dimensionamento
Os parâmetros da CDN do Unsplash fazem o redimensionamento, então solicite o tamanho que você exibe:
?auto=format&fit=crop&w=1600&q=80 herói
?auto=format&fit=crop&w=800&q=80 card
?auto=format&fit=crop&w=192&h=192&q=80 avatar (quadrado)
auto=format serve WebP/AVIF para navegadores que aceitam. Para heróis responsivos, emita um
srcset com 800/1200/1600/2000 em vez de enviar um arquivo de 2000px para telefones.
Texto alternativo (alt)
alt descreve o que a imagem mostra, para alguém que não pode vê-la. Não é um
espaço para palavras-chave nem o título da foto.
<!-- não -->
<img alt="imagem herói da página inicial da torrefação de café">
<!-- sim -->
<img alt="Tostador despejando grãos verdes em um torrador de tambor em uma oficina">
Se a imagem for decorativa e o texto ao redor já disser tudo, use alt=""
para que um leitor de tela a ignore. Um alt vazio é correto; um alt ausente não é.
Lista de verificação
-
UNSPLASH_ACCESS_KEYdefinida, nunca commitada - Pesquisou o clima, não o substantivo literal
- Posicionamento do assunto verificado em relação a como o espaço corta
- Faixa tonal funciona sob qualquer texto sobreposto
- Imagens em uma seção compartilham um visual
- URLs CDN usados via hotlink conforme exigido pela API — não re-hospedados
-
download_locationacionado para cada foto enviada - Parâmetros de dimensionamento correspondem ao tamanho de exibição;
srcsetem heróis responsivos - Texto alternativo real, ou
alt=""quando decorativo - Nenhuma suposição de liberação de modelo/propriedade para nada que implique endosso