Como funciona?
É simples, você usa a URL abaixo para gerar uma imagem placeholder:
https://img.usecurling.com/placeholder/largura/altura
ou use o alias mais curto:
https://img.usecurling.com/p/largura/altura
Teste você mesmo
Configure os parâmetros abaixo e veja o resultado em tempo real:
Código HTML
<img
src="https://img.usecurling.com/p/400/300"
alt="Imagem placeholder 400x300"
/>Exemplos
Imagem básica
Obtenha uma imagem aleatória com dimensões específicas:
<img
src="https://img.usecurling.com/p/300/200"
alt="Imagem placeholder 300x200"
/>Imagem com tema específico
Adicione o parâmetro q para definir um tema ou categoria:
<img
src="https://img.usecurling.com/p/300/200?q=nature"
alt="Imagem de natureza 300x200"
/>Imagem com cor dominante
Use o parâmetro color para imagens com uma cor específica dominante:
<img
src="https://img.usecurling.com/p/300/200?color=blue"
alt="Imagem azulada 300x200"
/>Imagem com alta densidade de pixels
Use o parâmetro dpr para telas de alta resolução:
<img
src="https://img.usecurling.com/p/300/200?dpr=2"
alt="Imagem de alta resolução 300x200"
/>Combinando parâmetros
Combine os parâmetros para obter resultados personalizados:
<img
src="https://img.usecurling.com/p/500/300?q=city&color=gray&dpr=2"
alt="Cidade em tons de cinza 500x300"
/>Imagens de pessoas
Obtenha imagens de pessoas usando a rota /ppl ou seu alias
/ppl:
<img
src="https://img.usecurling.com/ppl/large"
alt="Imagem de pessoa grande"
/>Imagens de pessoas com gênero específico
Use o parâmetro gender para especificar o gênero (male/female):
<img
src="https://img.usecurling.com/ppl/large?gender=female"
alt="Imagem de mulher grande"
/>Imagens de pessoas com seed fixo
Use o parâmetro seed para obter a mesma imagem repetidamente:
<img
src="https://img.usecurling.com/ppl/large?seed=123"
alt="Imagem de pessoa com seed fixo grande"
/>Ícones
Obtenha ícones usando a rota /icon ou seu alias /i:
<img
src="https://img.usecurling.com/i?q=home"
alt="Ícone de casa"
/>Ícones com cor específica
Use o parâmetro color para especificar a cor do ícone:
<img
src="https://img.usecurling.com/i?q=home&color=blue"
alt="Ícone de casa azul"
/>Ícones com forma específica
Use o parâmetro shape para especificar a forma do ícone:
<img
src="https://img.usecurling.com/i?q=home&shape=hand-drawn"
alt="Ícone de casa circular"
/>Documentação da API
| Parâmetro | Descrição | Exemplo |
|---|---|---|
| Rota /p (placeholder) | ||
| width | Largura da imagem em pixels (obrigatório) | /p/300/200 |
| height | Altura da imagem em pixels (obrigatório) | /p/300/200 |
| q | Termo de busca para o tipo de imagem (somente inglês é suportado no momento) | /p/300/200?q=nature |
| color |
Cor dominante da imagem - pode ser black, blue,
gray, green, orange, red,
white, yellow, purple, cyan,
pink
|
/p/300/200?color=red |
| dpr | Device Pixel Ratio para telas Retina | /p/300/200?dpr=2 |
| Rota /ppl (people) | ||
| size |
Tamanho da imagem em pixels (obrigatório) - pode ser large ou
medium ou thumbnail
|
/ppl/large |
| gender | Gênero da pessoa - pode ser male ou female |
/ppl/large?gender=female |
| seed | Valor para gerar a mesma imagem repetidamente | /ppl/large?seed=123 |
| Rota /i (icon) | ||
| q | Termo de busca para o tipo de ícone (obrigatório) | /i?q=home |
| color |
Cor do ícone - pode ser gradient, solid-black,
multicolor, azure, black,
blue, chartreuse, cyan, gray,
green, orange, red, rose,
spring-green, violet, white,
yellow
|
/i?q=home&color=blue |
| shape |
Forma do ícone - pode ser outline, fill,
lineal-color, hand-drawn
|
/i?q=home&shape=circle |